导入与导出

导入让你从不同采集工具和格式进入编辑、清理和优化；完成后按目标导出为 Web 压缩格式、归档全质量 PLY 或方便分享的独立 HTML，融入完整生产管线。

支持格式

支持多种场景格式，以及用于时间轴的 COLMAP/INRIA 相机位姿：

格式	导入	导出	说明
.ply	✅	✅	标准交换，兼容广但体积大
.compressed.ply	✅	✅	量化压缩，远小于原始，详情
.sog	✅	✅	ZIP 内含 meta.json 和 WebP，运行时推荐
meta.json	✅	❌	非打包 SOG，伴随 WebP，导出用 CLI
lod-meta.json	✅	❌	流式 SOG，伴随分块，导出用 CLI
.splat	✅	✅	antimatter15 旧压缩格式，效率不如压缩 PLY
.ksplat	✅	❌	KSplat，仅导入
.spz	✅	✅	Niantic，默认导出 v4，也可 v3 兼容旧读取器
.lcc / .lcc2	✅	❌	XGRIDS 多 LOD，导入时选择层级
images.txt	✅	❌	COLMAP 位姿，创建关键帧，不是场景
位姿 .json	✅	❌	INRIA 格式，创建关键帧，不是场景
.html	❌	✅	内嵌压缩数据的独立查看器
.zip	❌	✅	HTML 应用与独立 index.sog

注意

只支持含 3DGS 属性的 PLY，其他类型导入失败。

导入

支持上述场景格式，也可用 COLMAP images.txt 和 INRIA JSON 创建动画关键帧。

四种加载方式：

1. 拖放文件或整个目录。LCC、LCC2、非打包 SOG、流式 SOG 需拖父目录。

2. File > Import 选文件，Import Recent 重载以前文件目录，Clear Recent 清空历史。

3. 直接打开：安装为浏览器应用后，可在文件管理器双击 .ply、.splat、.sog、.spz、.ksplat、.ssproj。

4. URL：使用 https://superspl.at/editor?load=<SPLAT_URL>，例如：

   https://superspl.at/editor?load=https://raw.githubusercontent.com/willeastcott/assets/main/biker.ply

   适合在 X、LinkedIn 等平台分享。

   也支持多文件场景，相关纹理或分块必须保持容器引用的相对路径。

选择 LOD

多 LOD 文件分配前显示 Load Options，列出各层数量，默认选择少于 2000 万单元的最精细层，避免过度占内存。

选适合编辑和内存的层后 Load，粗层更快更省内存，Cancel 停止。

PLY 序列

支持序列动画，每个 PLY 是一帧。

步骤：

1. 文件名追加连续帧编号，例如：

   • animation_0001.ply
   • animation_0002.ply
   • animation_0003.ply
   • 以此类推。

2. 通过以下方式：

   • 拖全部文件。
   • 拖所在目录。
   • Import 多选。

自动识别并打开时间轴，可：

• 用箭头逐帧。
• 用播放按钮播放。
• 拖滑块预览。

备注

每帧载入完整数据，内存消耗大，应考虑文件体积和帧数。

导出

File > Export 选择 PLY、SOG、SPZ、Splat 或 Viewer App，只含可见数据，使用相同对话框：

• Location：记住上次目录，Choose output folder… 或 Change… 更换。不支持文件系统 API 时隐藏，改为下载。
• Filename：非法或已存在会警告，同名按钮变为 Overwrite；拒绝覆盖当前场景仍在读取的文件。
• 格式选项：
  • PLY：Compress PLY 输出压缩，SH Bands 选择阶数。
  • SOG：SH Bands；Iterations 1–20，默认 10，更多球谐聚类迭代略提高质量但更耗时。
  • SPZ：SH Bands 与 Version，默认最新 v4，v3 gzip 兼容旧第三方工具。
  • Viewer App：独立查看器选项。

File > Re-export（Ctrl + Shift + E）用相同选项覆盖同一文件，不再提示，适合反复清理。