在浏览器里编辑3D高斯斑点:SuperSplat 五分钟上手指南
【免费下载链接】super-splat3D Gaussian Splat Editor项目地址: https://gitcode.com/gh_mirrors/su/super-splat
SuperSplat 是一款开源的 3D 高斯斑点(Gaussian Splatting)编辑器,基于 Web 技术运行在浏览器里,无需下载安装。适合做游戏资产、需要处理点云/三维扫描数据的研究人员,以及想快速裁剪、优化 PLY 高斯模型的设计师。
一句话说清
SuperSplat 是一个跑在浏览器里的 3D 高斯斑点编辑器。它把场景当成一堆半透明的小点来加载和渲染,你直接在这个画面上框选、移动、旋转、缩放这些点,改完立刻就能看见效果,再导回成 PLY 文件。适合不需要装软件、只想快速查看和清理高斯模型的人。
功能速览
| 功能 | 说明 | 适用场景 |
|---|---|---|
| 加载 PLY 高斯模型 | 拖拽或菜单导入.ply文件,仅支持含高斯斑点数据的数据 | 查看扫描或渲染出的高斯场景 |
| 多种选择工具 | 矩形、画笔、多边形、套索、球体、泛洪、吸管等工具组合框选目标点 | 精准剔除背景、抠出某个物体 |
| 变换控制 | 通过 gizmo 手柄做平移、旋转、缩放,可精调数值 | 摆正模型朝向、统一坐标系 |
| 合并与导出 | 载入多个 PLY 合并成一个,再导出为 PLY / 压缩 PLY / Splat 文件 | 把多块扫描拼成一个完整场景 |
| 数据检视面板 | 用直方图查看点的位置、大小、不透明度等分布,拖拽直方图可直接选点 | 批量清理异常点、分析数据质量 |
快速上手
如果你只想跑起来试试,下面是最少命令。需要 Node.js(仓库要求 20.19 及以上版本)。
展开查看安装与启动命令
git clone https://gitcode.com/gh_mirrors/su/super-splat cd super-splat npm install npm run develop验证方式:执行后会自动打开本地服务,浏览器访问http://localhost:3000,看到一个带左侧工具面板的三维视图界面,就说明跑起来了。改源码后会自动重新构建,刷新浏览器即可看到变化。
实操演练:把一堆扫描点里抠出想要的物体
想象这样一个真实场景:你拿手机或手持设备扫了一个桌面,导出的高斯模型里除了想留的物件,还混进了桌布、背景杂点。目标是把这些多余的点删掉,只留下干净的目标。
问题:模型里有大量你并不想要的点,直接整个删不行,得按位置精准挑出来。
操作:先把.ply文件直接拖进编辑区(或者走顶部菜单 Scene > Open)。载入后先别急着框,用左侧面板把视图调顺——按住鼠标左键旋转、中键推拉、右键平移,双击画面可以重新设定旋转中心。接着切换到选择工具,用矩形或画笔在目标区域划一下;如果是立体包围的物体,用球体选择更省事,双击画面可以把球体挪到想选的位置。选择是累积的,按住 Shift 可以继续加选,按住 Ctrl 可以反选剔除。划好了按 Delete 就能把选中的点删掉。这套选择逻辑的实现散在 src/tools/ 目录里,比如画笔选择在 src/tools/brush-selection.ts,球体选择在 src/tools/sphere-selection.ts。
结果:杂点被清掉,只剩目标物件,保存为新的 PLY 文件即可。这里有个细节值得知道:编辑器默认用蓝色圆点(或圆环)标出每个高斯的位置方便你定位,按空格键可以切换成正常外观预览,确认删得干不干净。
再往前一步:如果你手上有好几段分段扫描的 PLY,可以全部拖进来一起加载,在场景面板里逐个用变换手柄调位置和朝向(手柄操作在 src/tools/transform-tool.ts 里),对齐后整体导出成一个文件,就完成了合并。要更彻底地清理,可以打开底部的数据检视面板(快捷键 D),它把点的大小、不透明度等画成直方图,你在直方图上拖一下就能批量选中异常值的点,比肉眼找快很多。
局限与避坑
- 只吃高斯 PLY:它只加载含 3D 高斯斑点数据的
.ply文件,别的格式(哪怕是普通点云 PLY)会直接加载失败。用之前先确认数据是高斯格式。 - 大文件吃内存:高斯模型动辄上百万点,全量加载对浏览器内存压力不小。仓库里导入面板提供了
Load all PLY data这类开关,处理超大模型时建议关掉全量加载,按需载入。 - 压缩导出不带球面谐波:导出 Compressed Ply 会量化数据并丢弃球面谐波(SH,描述视角变化时颜色/反射的系数),文件小但视觉细节可能打折。对反射表现要求高的场景,建议保留完整 PLY 或提前想好朝向。
- 别拿它当通用 3D 建模器:它擅长查看、裁剪、变换、合并高斯数据,不是用来从零建网格模型的,需要建模请配合其它工具。
写在最后
SuperSplat 把"看、挑、改、存"高斯模型的整条链路搬进了浏览器,不用装软件就能把一堆扫描点整理成干净的资产。下一步建议:丢一个自己的.ply进来,试着删掉一块背景再导出压缩版本,对比一下文件大小,你就明白它日常最值钱的用法了。
【免费下载链接】super-splat3D Gaussian Splat Editor项目地址: https://gitcode.com/gh_mirrors/su/super-splat
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考