gsbox

一个关于 3d gaussian splatting 的小工具盒。
.ply和.splat等格式之间的转换有nodejs版本也有python版本，都太重了，故有此一举。

写一写，加深理解
弄一弄，争取实用
搞搞搞，越做越好

功能

• 文件格式之间相互装换，支持3DGS的.ply、.splat、.spx、.spz格式
• 查看.ply、.spx、.spz的文件头信息或.splat的高斯点数量

TODO

• 转换支持球谐系数

.spz

• .spz是个开放的3DGS模型格式，它的编码算法非常值得称赞，再加上gzip压缩，能有效减少模型文件大小
• .spz格式官方开源地址 https://github.com/nianticlabs/spz
• .spz格式模型的渲染查看 https://github.com/mkkellogg/GaussianSplats3D

.spx

• .spx格式灵活可扩充且支持专有数据保护，其开放格式综合参考了.splat和.spz的编码方式，并增加了分块压缩处理，支持渐进加载，支持大文件模型
• .spx格式说明 https://github.com/reall3d-com/Reall3dViewer/blob/main/SPX_ZH.md
• .spx格式模型的渲染查看 https://github.com/reall3d-com/Reall3dViewer

Usage

Usage:
  gsbox [options]

Options:
  p2s, ply2splat           convert ply to splat
  p2x, ply2spx             convert ply to spx
  p2z, ply2spz             convert ply to spz
  s2p, splat2ply           convert splat to ply
  s2x, splat2spx           convert splat to spx
  s2z, splat2spz           convert splat to spz
  x2p, spx2ply             convert spx to ply
  x2s, spx2splat           convert spx to splat
  x2z, spx2spz             convert spx to spz
  z2p, spz2ply             convert spz to ply
  z2s, spz2splat           convert spz to splat
  z2x, spz2spx             convert spz to spx
  info <file>              display the model file information
  -i, --input <file>       specify the input file
  -o, --output <file>      specify the output file
  -c, --comment <text>     output ply/spx with the comment
  -sh, --shDegree <num>    specify the SH degree for ply/spx/spz output
  -v, --version            display version information
  -h, --help               display help information

Examples:
  gsbox ply2splat -i /path/to/input.ply -o /path/to/output.splat
  gsbox s2x -i /path/to/input.splat -o /path/to/output.spx -c "your comment"
  gsbox x2z -i /path/to/input.spx -o /path/to/output.spz -sh 0
  gsbox z2p -i /path/to/input.spz -o /path/to/output.ply -c "your comment" -sh 3
  gsbox info -i /path/to/file.spx


# Convert the ply to spx without saving SH coefficients and add custom comments.
gsbox p2x -i /path/to/input.ply -o /path/to/output.spx -c "your comment here" -sh 0

# Inspect the header information of the spx file
gsbox info -i /path/to/file.spx

Update History & binary files

https://github.com/gotoeasy/gsbox/releases