当前位置：首页 > news >正文

SPZ格式入门指南：Niantic开源3D高斯点云压缩技术快速上手指南

news 2026/8/14 20:09:47

SPZ格式入门指南：Niantic开源3D高斯点云压缩技术快速上手指南

【免费下载链接】spzFile format for 3D Gaussian splats. About 10x smaller than the PLY equivalent with virtually no perceptible loss in visual quality. Offered as open source by Niantic Labs. More details at https://scaniverse.com/spz #3dgaussiansplats #gaussiansplatting项目地址: https://gitcode.com/gh_mirrors/sp/spz

SPZ是由Niantic Labs开源的3D高斯点云压缩文件格式，能够将传统PLY格式文件压缩至约1/10大小，同时保持几乎无损的视觉质量。本文将为你提供SPZ格式的完整入门指南，从基础概念到实际应用，帮助你快速掌握这一高效的3D数据压缩技术。

📌 为什么选择SPZ格式？

SPZ格式解决了3D高斯点云存储和传输中的关键痛点：

惊人的压缩比：通常比等效PLY文件小10倍，大幅节省存储空间和带宽
视觉质量保留：采用先进的量化和压缩算法，几乎无感知的质量损失
跨平台兼容性：支持多种编程语言和渲染系统，包括C++、TypeScript和Python
灵活的扩展机制：支持坐标系统转换、相机轨道限制等高级功能

SPZ特别适合需要处理大型3D场景的应用，如虚拟现实、增强现实、游戏开发和3D扫描等领域。

🚀 快速开始：安装与基础使用

安装SPZ Python库

SPZ提供了便捷的Python绑定，让你可以轻松在Python环境中处理SPZ文件：

git clone https://gitcode.com/gh_mirrors/sp/spz cd spz pip install .

加载与保存SPZ文件

import spz # 加载SPZ文件 cloud = spz.load_spz("samples/hornedlizard.spz") print(f"Loaded {cloud.num_points} gaussians with SH degree {cloud.sh_degree}") # 保存SPZ文件 options = spz.PackOptions() options.from_coord = spz.CoordinateSystem.RUB # 设置坐标系统 spz.save_spz(cloud, options, "output.spz")

PLY转SPZ压缩示例

import spz import os # 加载PLY文件并转换为SPZ格式 unpack_options = spz.UnpackOptions() unpack_options.to_coord = spz.CoordinateSystem.RUB # 转换为Three.js兼容坐标 # 加载PLY文件 cloud = spz.load_splat_from_ply("input.ply", unpack_options) print(f"Loaded {cloud.num_points} gaussians from PLY") # 保存为压缩SPZ格式 pack_options = spz.PackOptions() pack_options.from_coord = spz.CoordinateSystem.RUB spz.save_spz(cloud, pack_options, "output.spz") # 检查压缩比 ply_size = os.path.getsize("input.ply") spz_size = os.path.getsize("output.spz") print(f"压缩比: {ply_size/spz_size:.1f}x ({ply_size} → {spz_size} bytes)")

🧠 SPZ核心技术解析

文件格式架构

SPZ v4采用先进的多流压缩架构，主要包括：

32字节明文头部：包含魔数、版本、点数量等关键元数据
扩展ILV记录：存储供应商特定扩展信息
TOC表：记录每个属性流的压缩和未压缩大小
独立ZSTD压缩流：多个并行压缩流，提高压缩/解压缩吞吐量

这种结构设计使得SPZ在保持高性能的同时，能够灵活支持各种扩展功能。

数据压缩机制

SPZ对不同类型的数据采用针对性的压缩策略：

位置信息：24位定点有符号整数表示，精度可配置
缩放比例：8位对数编码整数
旋转信息：四元数最小三个分量的10位有符号整数编码
透明度：8位无符号整数
颜色：8位RGB分量
球谐函数：可配置量化位数（默认5位用于1阶，4位用于高阶）

这种混合编码策略确保了在最小化文件大小的同时，保持视觉质量的平衡。

🔧 高级功能与最佳实践

坐标系统转换

SPZ支持16种命名坐标系统，分为标准和旋转两个系列，轻松解决不同3D引擎间的坐标差异：

# 加载PLY(RDF坐标)并转换为Unity(RUF)坐标 unpack_options = spz.UnpackOptions() unpack_options.to_coord = spz.CoordinateSystem.RUF cloud = spz.load_splat_from_ply("model.ply", unpack_options) # 保存为Three.js(RUB坐标)兼容格式 pack_options = spz.PackOptions() pack_options.from_coord = spz.CoordinateSystem.RUF spz.save_spz(cloud, pack_options, "threejs_model.spz")

所有坐标系统转换会自动处理球谐系数的旋转，确保光照计算的一致性。

内存中处理SPZ数据

SPZ支持直接在内存中处理数据，适合需要高效数据流转的场景：

# 序列化为字节 data = spz.save_spz_to_buffer(cloud, spz.PackOptions()) assert isinstance(data, bytes) # 从字节反序列化 roundtrip_cloud = spz.load_spz_from_buffer(data, spz.UnpackOptions())

自定义量化参数

通过调整球谐函数量化参数，平衡文件大小和视觉质量：

options = spz.PackOptions() options.sh1Bits = 6 # 增加1阶球谐系数的量化位数 options.shRestBits = 5 # 增加高阶球谐系数的量化位数 spz.save_spz(cloud, options, "high_quality.spz")