SuperSplat 编辑器入门:清理与发布高斯泼溅
面向新手的 SuperSplat 编辑器指南:怎样载入 PLY、选择并删除漂浮噪点、裁剪、移动缩放,以及导出和发布高斯泼溅场景,功能说明均对照官方手册核实。
SuperSplat 是什么
SuperSplat 是 PlayCanvas 推出的免费开源 3D 高斯泼溅编辑器,在浏览器里打开 superspl.at/editor 就能用。项目的 GitHub 页面把 SuperSplat 编辑器描述为用于检查、编辑、优化和发布 3D 高斯泼溅的工具,代码以 MIT 许可证发布。
先说清楚它不做什么:SuperSplat 不能把照片或视频变成高斯场景。PlayCanvas 在官方文档里明确说,它自己不提供这一步的工具,并列出了第三方训练软件。你需要带着一个已经生成好的高斯文件来,再用 SuperSplat 清理、摆正和分享。
这个名字现在也不只指编辑器。superspl.at 网站上还有公开的作品库,以及给已发布场景添加相机和标注的 Studio。按文档的说法,编辑器和查看器是 MIT 许可的开源项目,而 Studio、作品库和场景页面是 PlayCanvas 托管的服务。本文只讲编辑器;它还有调色功能和相机动画时间线,这里不展开。
在哪里运行,需要什么
不需要安装,打开编辑器页面就可以开始。文档列出的硬性要求只有一条:浏览器要支持 WebGPU。文档点名的是当前版本的 Chrome 或 Edge、Safari 26 及以上,或者开启了 WebGPU 的 Firefox。如果没有 WebGPU,编辑器启动时会显示提示而不会加载。
官方手册里还有几点值得知道:
- 高斯文件在你的浏览器里本地加载,在你选择发布之前不会上传任何内容。
- 编辑和导出不需要账号。只有发布到 superspl.at,或在上面点赞、评论时,才需要一个免费的 PlayCanvas 账号。
- 浏览器要保持硬件加速开启;处理很大的场景时,独立显卡会有帮助。
- 可以从浏览器地址栏把编辑器安装成应用,之后就能在访达或文件资源管理器里直接打开高斯文件。
GitHub 上的 README 还说明了怎样用 Node.js 自己运行一份。
在 SuperSplat 编辑器里载入 PLY
文档列出了四种载入方式:
- 把一个或多个高斯文件,或者整个文件夹,拖进窗口。
- 选择 File > Import。File > Import Recent 会列出以前打开过的文件。
- 如果已把编辑器安装成应用,可以在访达或文件资源管理器里双击文件。
- 在地址后面加 load 参数,形式是 superspl.at/editor?load= 加上文件的网址。
编辑器可以导入 .ply、压缩 .ply、.sog、.splat、.ksplat、.spz,以及 XGRIDS 的 .lcc 和 .lcc2 格式。它还能读取 COLMAP 的 images.txt 和 INRIA 的相机位姿文件,这些文件会变成时间线上的相机关键帧,而不是场景。
手册里有一条提醒对新手很重要:只有包含 3D 高斯泼溅数据的 PLY 才能载入。普通点云或网格的 PLY 虽然扩展名相同,但导入会失败。
每个导入的文件会在 Scene Manager 面板里显示为一行。编辑前先点选那一行,因为选择和清理只作用于当前激活的那个高斯场景。
选择工具
编辑高斯场景,基本就是先选中一批高斯点,再对它们做操作。选择工具在底部工具栏,各有快捷键:
- 矩形(R):点击选中单个高斯点,或拖出矩形框选。这是默认工具。
- 画笔(B):用圆形画笔涂抹选择,[ 和 ] 键调整大小。
- 多边形(P)和套索(L):画出直边或自由形状的轮廓。
- 泛洪(O):点击后从该点向外扩展选区。手册推荐用它处理孤立的零散高斯点。
- 吸管(Ctrl + E):选中颜色相近的高斯点。
- 球形画笔(Shift + B):在三维空间里涂抹,画笔贴着光标下的表面走。
- 球体和方盒:放置一个三维体积,用操纵器或输入数值调整,再应用。
二维工具都支持修饰键:不按键是替换当前选区,Shift 是添加,Ctrl 是减去,Shift + Ctrl 是只保留重叠部分。球体和方盒工具则用 Set、Add、Remove、Intersect 四个按钮。
还有两个开关会改变工具选中的范围。Selection Depth(N)默认关闭,这时选择会穿透整个场景;打开后只选中看得见的表面。Selection Footprint(M)决定按高斯点的中心点还是按它投影出的椭圆范围来判断是否选中。按 Tab 可以在编辑时显示高斯点的中心。
删除漂浮噪点与裁剪
漂浮噪点就是悬在场景周围空中的零散色块。手册给了一个简短的处理步骤:
- 打开 Selection Depth(N),让选择停在可见表面。
- 孤立的小块用泛洪工具,较大的区域用套索、画笔、球形画笔、球体或方盒。
- 转动相机,添加或减去选区,直到只选中不要的部分。
- 按 Delete 或 Backspace。
- 从几个角度检查结果,删多了就撤销。
裁剪是反过来做的:用方盒、球体、套索或多边形选中要保留的区域,这时保持 Selection Depth 关闭,让选择穿透整个场景;然后选 Select > Invert 反选,再删除。
编辑过程中的删除不是破坏性的。撤销可以恢复上一次删除,Select > Reset 可以恢复当前场景里所有被删除的高斯点。但从 Scene Manager 里移除整行是另一回事,手册说明这个操作无法撤销。
按 H 可以锁定选中的高斯点,使它们不能再被选中或删除,这样清理旁边区域时不会误伤已处理好的部分;Shift + H 解锁。Splat Data 面板可以按数值范围选择,比如低不透明度或极端的缩放值,适合手工难以处理的清理。
移动、旋转、缩放、摆正与测量
变换工具是移动(1)、旋转(2)和缩放(3)。它们作用于什么取决于选区:没有选中任何高斯点时,变换的是整个当前场景;选中了一部分时,只变换这一部分。如果本意是移动整体,先选 Select > None。可以在视口里拖动操纵器,也可以在 Transform 面板里输入精确的位置、旋转和缩放数值。变换可以撤销和重做。
很多拍摄结果载入后是倾斜或上下颠倒的。Orient 工具用来摆正:在应该水平的表面上点三个点,比如地面或桌面,然后按 Align to Grid。
Measure 工具会显示你在表面上点的两个点之间的距离。如果输入真实距离,SuperSplat 会把整个当前场景等比缩放到对应大小。结果取决于两个标记点放得准不准。
保存与导出格式
保存和导出是两件事。File > Save As 写出的是 .ssproj 项目文件,手册说它是一个 ZIP 压缩包,里面有未压缩的 PLY 数据,以及你的编辑、变换、相机和时间线。想以后继续编辑时用它。
File > Export 生成给其他软件用的文件,可选:
- PLY:最通用的交换格式。勾选 Compress PLY 会写出体积小得多的压缩 PLY。
- SOG:一种高压缩格式,文档推荐在运行时使用。
- SPZ:Niantic 的压缩格式。
- Splat:较早的一种压缩格式。
- Viewer App:独立查看器,可以是单个 HTML 文件,也可以是 ZIP 包。
导出只包含当前可见的场景。合并也是这样做的:让要合并的场景都保持可见,导出 PLY,它们就会合成一个文件。
手册的格式表里没有 OBJ、STL 这类网格格式,所以 SuperSplat 不适合用来制作可打印的模型。
发布与分享
分享有两种方式。第一种是 File > Publish,把编辑好的场景上传到 superspl.at,生成一个带独立链接的场景页面。这需要登录 PlayCanvas 账号。新发布的场景默认不公开列出,只有拿到链接的人能看到,除非你在 Manage 页面把它设为公开列出。发布时会把场景压缩成 SOG,手册提醒这可能需要几分钟。
第二种方式完全由你自己掌握。File > Export > Viewer App 会生成一个自己托管的查看器。单个 HTML 的选项把高斯数据嵌在一个文件里,双击就能打开;手册指出它比 ZIP 包选项大约大 30%。文档建议可以用 GitHub Pages 这类简单的地方来托管。
一个简单流程:从照片到可分享的场景
SuperSplat 是从已生成的高斯文件开始的,所以你得先有办法生成一个。SplatLoom 是其中一种选择。它是 Mac(Apple Silicon,macOS 15 及以上)和 Windows 10/11 上的桌面应用,在你自己的电脑上把有重叠的照片或一段短视频变成高斯场景,不上传、不需要账号,并能导出高斯 PLY。
比较实际的分工是这样的:
- 在 SplatLoom 里生成:选好照片或视频,点击生成。
- 如果只需要简单整理,就在那里完成:方盒或球体裁剪、矩形选择、一键去除尖刺、撤销和重做,原始结果始终保留。
- 需要更细的处理时,导出 PLY,在 SuperSplat 里打开。画笔、套索和泛洪选择,锁定,变换,摆正,以及合并多次拍摄,这些是 SuperSplat 有而 SplatLoom 没有的功能。
- 两边都可以分享:SplatLoom 能导出离线 HTML 查看器、PNG 静帧和 MP4 环绕视频;SuperSplat 能导出查看器应用,或发布到 superspl.at。
两个工具都不生成网格。如果只是想看一眼高斯文件,splatloom.com/ply-viewer 的免费查看器可以在浏览器里本地打开高斯 .ply 和 .sog 文件。
常见问题
SuperSplat 是免费的吗?
是的。编辑器可以在浏览器里免费使用,源代码以 MIT 许可证放在 GitHub 上。编辑和导出不需要账号,只有发布到 superspl.at 时才需要一个免费的 PlayCanvas 账号。
SuperSplat 能用照片生成高斯泼溅吗?
不能。它只编辑和发布已经存在的高斯场景。PlayCanvas 在文档里说明,它不提供把照片转换成高斯场景的工具,这一步需要另外的训练软件或应用。
SuperSplat 会上传我的文件吗?
按官方手册的说法,编辑器在浏览器里本地加载高斯文件,在你选择发布之前不会上传任何内容。导出 PLY 或查看器应用,是把文件写到你自己的电脑上。
SuperSplat 编辑器支持哪些浏览器?
文档要求浏览器支持 WebGPU,并点名了当前版本的 Chrome 或 Edge、Safari 26 及以上,或开启了 WebGPU 的 Firefox。没有 WebGPU 时,编辑器会显示提示而不会加载。
为什么我的 PLY 文件在 SuperSplat 里打不开?
最可能的原因是它不是高斯泼溅文件。手册提醒,只有包含 3D 高斯泼溅数据的 PLY 才能载入,点云或网格的 PLY 会导入失败。
参考资料:https://github.com/playcanvas/supersplat · https://developer.playcanvas.com/user-manual/supersplat/ · https://developer.playcanvas.com/user-manual/supersplat/editor/ · https://developer.playcanvas.com/user-manual/supersplat/editor/import-export/ · https://developer.playcanvas.com/user-manual/supersplat/editor/editing-splats/ · https://developer.playcanvas.com/user-manual/supersplat/editor/transform-measure-align/ · https://developer.playcanvas.com/user-manual/supersplat/editor/managing-projects/ · https://developer.playcanvas.com/user-manual/supersplat/editor/publishing/ · https://developer.playcanvas.com/user-manual/supersplat/viewer/self-hosting/ · https://developer.playcanvas.com/user-manual/gaussian-splatting/creating/recommended-tools/
在 SplatLoom 中试试