トラブルシューティング
Editorが起動しない
EditorにはWebGPUが必要です。読み込まれる代わりに「SuperSplat requires WebGPU, which this browser does not support」と表示される場合は、対応ブラウザに切り替え、ブラウザの設定でハードウェアアクセラレーションが有効になっていることを確認してください。複数のGPUを搭載したマシンでは、ブラウザが専用GPUを使用できるようにする必要があります。
「SuperSplat failed to start」と表示される場合は、ブラウザのコンソールで詳細を確認し、問題を報告する際にその内容を含めてください。
ファイルをインポートできない
- インポートとエクスポートに記載された形式であることを確認します。メッシュまたは点群データだけを含む一般的な(「vanilla」)PLYは読み込めません。SuperSplatには、位置(
x、y、z)、スケール(scale_*)、回転(rot_*)、不透明度、球面調和関数による色(f_dc_*、および任意のf_rest_*)などのGaussian属性を含む3DGS PLYが必要です。3DGS PLYと通常のPLYの違いも参照してください。 - 複数の関連ファイルで構成される形式の場合、相対ファイルパスを維持できるように親フォルダをEditorへドラッグします。
- URLからインポートする場合、リモートサーバーでCross-Origin Resource Sharing(CORS)によるブラウザからの取得を許可する必要があります。
- ブラウザでメモリ不足が報告される場合は、詳細度の低いソースファイルを試し、GPUを多用するほかのタブを閉じ、スプラットを個別にインポートします。
- 選択したファイルの読み取りをブラウザが拒否した場合、SuperSplatはFile Access Blockedを表示します。OKをクリックし、ブラウザのファイルダイアログで同じファイルをもう一度選択すると続行できます。その他の読み取りエラーでは、ブラウザが示した理由とともにError Loading Fileメッセージが表示されます。
- 複数のファイルを一度にインポートした場合、SuperSplatが認識できないファイルはImport FilesダイアログでNot supportedとして一覧表示されてスキップされ、残りのファイルは通常どおりインポートされます。複数ファイルのインポートを参照してください。
- 署名付きのダウンロードリンクなど、ファイル拡張子のないURLから読み込むスプラットでは、形式を識別するために
filenameパラメータが必要です。インポートとエクスポートのURL読み込みの説明を参照してください。
選択範囲が表示サーフェスと一致しない
ビューキューブの横にあるモードストリップを確認します。
- X-Ray(N)はデフォルトでオンです。そのため選択はシーン全体を貫通し、クリックしたサーフェスの背後に隠れたガウシアンも対象になります。可視サーフェスだけを選択するにはオフにします。X-RayがオフでMarkersがオンの場合は、選択が届くガウシアンにだけマーカーが描画されるため、ドラッグで何が選択されるかを確認できます。
- Centersモード(デフォルト。Mで切り替え)では、中心点がツールの形状の内側にあるガウシアンだけが対象になります。中心点が選択範囲のすぐ外側にある大きくて柔らかいガウシアンは含まれません。フットプリント全体で選択するにはRingsモードに切り替えます。
Tabはマーカーの表示・非表示を切り替えるだけで、選択の動作は変わりません。ロックまたは削除されたガウシアンは選択できません。必要に応じてSelect > Unlock AllまたはSelect > Reset Splatを使用してください。
選択モードとX-Rayと、選択とクリーンアップのクリーンアップ手順を参照してください。
意図しない内容が変形される
ガウシアンが1つでも選択されている場合、Move、Rotate、Scale、およびTransformの数値はその選択範囲だけに作用します。アクティブスプラット全体を変形するには、Select > Noneを選択します。
回転や拡大縮小が想定外の点を中心に動く場合は、原点コントロールを切り替えるか、表示サーフェスをダブルクリックしてピボットを配置します。変形、測定、位置合わせも参照してください。
エクスポートにコンテンツが含まれない
スプラットのエクスポートには表示中のスプラットが含まれます。Scene Managerで、含めるすべてのスプラットの目のアイコンを有効にします。エクスポート前にSoloモードを無効にし、全体の結果を確認してください。
複数のスプラットを1つのPLYに結合するには、File > Export > PLYを使用します。File > Saveでは、編集可能な.ssprojプロジェクトが作成されます。
エクスポートに失敗する
SOGとViewer Appのエクスポートでは、GPUでスプラットを圧縮します。低速なグラフィックスハードウェアで大きなシーンを扱うと、圧縮中にGPUが応答しなくなることがあり、その場合SuperSplatはGPUが応答を停止したことを報告します。もう一度エクスポートしてください。エクスポートは試行のたびに新しいGPUデバイスで開始されます。それでも失敗が続く場合は、GPUを多用するほかのタブを閉じるか、先にガウシアン数を減らしてください。
色の見え方が異なる
- Preferencesで、トーンマッピングカーブ、ビューポートに表示する球面調和関数のバンド数、背景色を確認します。これらは表示設定であり、エクスポートには書き込まれません。
- 小さなガウシアンや遠くのガウシアンが明るすぎる場合は、スプラットがアンチエイリアスを有効にして(たとえばMip-Splattingで)学習されているのに、そのことを示すタグがない可能性があります。PreferencesのAnti-AliasingをOnに設定してください。逆に、アンチエイリアスなしで学習されたファイルにアンチエイリアスのタグが付いている場合は、小さなガウシアンが薄すぎて見えます。その場合はOffを選択します。この設定はプロジェクトとともに保存されます。
- Scene ManagerのColorsを展開してResetをクリックし、スプラットまたは選択範囲に適用されたカラーグレードが原因か確認します。
- 球面調和関数の色は視線方向に依存するため、複数のアングルからシーンを確認します。
スプラット調整とビューポート設定の違いについては、色と外観を参照してください。
Editorが遅い、またはメモリ不足になる
大きなスプラットは、使用可能なGPUメモリによって制限されます。グラフィックスを多用するほかのタブを閉じ、Soloモードで一度に1つのスプラットだけを表示し、マルチLODファイルのインポート時には低い詳細度を選択します。スプラットをクリーンアップしてガウシアン数を減らすこともできます。大きなシーケンスをインポートする場合、各フレームに完全なスプラットが含まれることにも注意してください。
重いシーンを回転させている間にビューポートがカクつく場合は、Preferencesを開いてStochastic AlphaとMin Splat Sizeを確認します。Min Splat Sizeを上げると、画面上で1~2ピクセルしか占めないガウシアンがより多く非表示になります。小さなガウシアンが抜けて隙間ができる場合は値を下げてください。Stochastic Alphaでは、Auto(デフォルト)は、ソート済みフレームが遅いと判明したときだけ、移動中に高速な確率的描画へ切り替えます。Movementを選ぶとカメラを動かすたびに使用し、Enabledを選ぶと常に使用します。OverlaysポップアップのFrame TimingsとOverdrawの診断機能で、時間がどこに使われているかがわかります。GPU時間が長く、オーバードローマップが赤から白の場合は多くのガウシアンが重なっているため、クリーンアップや詳細度の引き下げで改善できます。
未保存の作業またはプロジェクトに関する混乱
編集可能な.ssprojプロジェクトを保持するため、File > SaveまたはSave Asを定期的に使用します。スプラット配置、カメラ設定、アニメーションの編集を続ける場合、エクスポートしたPLYなどの配布形式はプロジェクトファイルの代わりにはなりません。
保存、開く、インポート、エクスポートの違いについては、プロジェクトの管理を参照してください。
公開またはレンダリングに失敗する
- 公開するには、PlayCanvasアカウントでsuperspl.atにサインインする必要があります。
- Publishダイアログで
Publishがメッセージとともに無効になっている場合は、アカウントが公開の上限のいずれかに達しています。再び公開できる時刻はメッセージに表示されます。 - ガウシアン数が4000万を超えるシーンは、Generate LODsをオンにした場合にのみ公開できます。ストリーミングしない単一のファイルとして公開したい場合は、先に不要なガウシアンを削除してください。
- 動画コーデックの対応状況はブラウザによって異なります。Render Videoダイアログでは、現在の設定でブラウザやデバイスがエンコードできない解像度は無効になります。解像度、フレームレート、ビットレートを下げるか、別の形式やコーデックを試すか、ブラウザやグラフィックスドライバーを更新してください。
- ダウンロードのブロック、プライベートブラウジングの制限、空きメモリ不足によって、大きなレンダリングやエクスポートが完了しないことがあります。File System Access APIに対応していないブラウザでは、レンダリングとエクスポートはダウンロードとして提供されます。
問題の報告
問題が解決しない場合は、EditorでHelp > Log an Issueを開き、Editorのバージョン、ブラウザのバージョン、OS、GPU、ソース形式、おおよそのガウシアン数、問題を再現する手順を記載してください。Editorのバージョンと使用中のGPUは、Aboutダイアログ(Help > About SuperSplat、またはビューポート右下隅のバージョン表示をクリック)で確認できます。SuperSplat Discordコミュニティで質問することもできます。