playcanvas/supersplat-viewer

SuperSplat Viewer – 快速概览

是什么 – 一款用于 SuperSplat 3D 场景（Gaussian-splatting 点云）的网页查看器。它作为单一静态网站运行，使用 PlayCanvas 引擎并透过 WebGPU 或 WebGL 进行渲染。

为什么重要 – Gaussian-splatting 是一种视觉化超高密度 3D 重建（例如摄影测量、NeRF 风格捕捉）的现代方法。此查看器让开发者与艺术家能直接在浏览器中加载、探索并调试这些场景，并透过 WebGL 支持 AR/VR。

---

核心功能 (如 README 所述)

功能	详细信息
渲染后端	优先使用 WebGPU，若不支持则回退至 WebGL。AR/VR 必须使用 WebGL。
随机渲染器	实验性未排序 splat 渲染器（仅限 WebGPU），提供开发者调整参数 (splatSource, variant)。
透过 URL 控制 UI	加载自定义设置、场景文件、天空盒、碰撞网格，并调整 UI 可见度 (noui, reticle, ministats, 语言)。
性能调整	反锯齿 (aa)、splat 预算、高精度渲染切换、完整加载 LOD 流、后处理特效切换 (nofx)。
调试与诊断	调试面板 (debug)、体素碰撞热图覆盖、运行时 CPU/GPU 图表。
嵌入 API	作为 NPM 模块 (@playcanvas/supersplat-viewer) 发布，提供程序化控制的 API 参考。
本地开发	简单的 Node 工作流程 (npm install, npm run develop)。可透过 ENGINE=debug 链接至 PlayCanvas 引擎调试版本。

---

如何使用

1. 运行演示 – 打开托管的静态网站（或在本地运行 npm run develop），并传入 URL 参数以指向您的 .ply、.sog 或压缩场景文件。
2. 自定义 – 提供 settings.json 文件、天空盒图像或碰撞网格以丰富场景。
3. 嵌入 – 安装 NPM 包并使用记录的 API (docs/api.md) 将查看器整合至其他网页应用中。

---

谁适合使用？

• 3D 内容创作者：使用 Gaussian-splatting 工作流程，需要快速预览结果的人员。
• 开发者：构建需要高密度点云渲染的网页版 AR/VR 体验。
• 研究人员：测试新渲染技巧（随机 splats、LOD 预算）而无需编写自定义引擎。

---

快速入门

# Clone 并在此地运行
git clone https://github.com/playcanvas/supersplat-viewer.git
cd supersplat-viewer
npm install
npm run develop   # 打开 http://localhost:3000

然后附加 URL 参数，例如：

http://localhost:3000?content=./myScene.compressed.ply&skybox=./sky.hdr&webgl

---

总结 – SuperSplat Viewer 是一款专注的开源工具，用于在浏览器中视觉化尖端的 Gaussian-splat 3D 数据，具备灵活的渲染选项与开发者友好的 API。