playcanvas/supersplat-viewer

SuperSplat Viewer – クイック概要

概要 – SuperSplat 3Dシーン（Gaussian-splatting点群）のためのWebベースのビューアです。単一の静的サイトとして動作し、PlayCanvasエンジンとWebGPUまたはWebGLを使用してレンダリングを行います。

重要性 – Gaussian-splattingは、超高密度な3D再構築（フォトグラメトリやNeRFスタイルのキャプチャなど）を可視化するための最新の手法です。このビューアを使用することで、開発者やアーティストはブラウザ上で直接シーンを読み込み、探索し、デバッグすることができます。また、WebGL経由でAR/VRもサポートしています。

主な機能 (READMEより)

機能	詳細
レンダリングバックエンド	WebGPUが利用可能な場合は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エンジンのデバッグビルドにリンク可能です。

使用方法

デモの実行 – ホストされている静的サイト（またはローカルで npm run develop）を開き、URLパラメータを渡して独自の .ply、.sog、または圧縮されたシーンファイルを指定します。
カスタマイズ – settings.json ファイル、スカイボックス画像、または衝突メッシュを提供してシーンを充実させます。
埋め込み – NPMパッケージをインストールし、ドキュメント化されたAPI (docs/api.md) を使用して、他のWebアプリにビューアを統合します。

ターゲットユーザー

3Dコンテンツクリエイター：Gaussian-splattingパイプラインを使用しており、結果を素早くプレビューする必要がある方。
開発者：高密度点群レンダリングを必要とするWebベースのAR/VR体験を構築している方。
研究者：カスタムエンジンを書かずに、新しいレンダリング手法（確率的splat、LOD予算など）をテストしたい方。

クイックスタート

# クローンしてローカルで実行
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を備えたオープンソースツールです。