コンテンツにスキップ

インポートとレベルへの配置

インポート

  1. UEエディタ上部のメニューで「Window > Import 3D Gaussians」を選択します
  2. ダイアログ画面で、3D Gaussian Splattingの学習結果の「point_cloud.ply」を選択します。

パスは英数字のみ

日本語などマルチバイト文字が含まれるパスからはインポートできません。
パスには英数字のみが含まれるようにしてください。

レベルへの配置

  1. コンテンツブラウザで「Content > ThreeDGaussians > モデル名」の下の「BP_3D_Gaussians_モデル名」をレベル上にドラッグ＆ドロップします。

また、必要に応じて詳細タブの「Default」の下の項目を設定します。

  • Enabled Blocksで、インポートしたデータのどのブロックを表示するかを選択します。
  • Spherical Harmonics Degreeで、色の描画方法を選択します。
    「Degree 0」は見る角度による色の変化を無効にします（反射などがなくなります）。
    「Degree 1～3」は見る角度による色の変化を有効にします。高いDegreeを指定すると描画が正確になりますが、描画負荷が上がります。
  • Albedo Tintで、色を補正します。ここで指定した色が元の色に乗算されます。
  • Min translucent sort priorityで、3D Gaussian Splattingのデータの描画の優先度を設定します。
    本プラグインでは、3D Gaussian Splattingのデータは半透明のメッシュとして描画されます。
    最も遠いブロックのTranslucency Sort Priorityにこの値が適用され、最も近いブロックにはこの値 + 有効なブロック数 - 1の値が適用されます。
  • Crop Volumesに要素を追加し、トリミング範囲を指定します。ここで指定した範囲の外は描画されなくなります。
  • Kill Volumesに要素を追加し、非表示の範囲を指定します。ここで指定した範囲の中は描画されなくなります。
  • Sprite Sizeでガウス分布を描画するスプライトのサイズを調整します。
    この値を大きくするとガウス分布の端まで正しく描画されるようになり描画精度が向上します。ただし、それだけスプライトの重なりが多くなり描画負荷が増大します。
  • Advanced > VR で、VR対応をオンにするかを設定します。VR対応にすると描画負荷が少し増加します。
    (UPDATE: v1.5で設定不要になりました。VR・非VRを問わずそのまま機能します)
  • Advanced > Litで、光を受けるかを設定します。
    オンにするとLit・Translucentなマテリアルとして、オフにするとUnlit・Translucentなマテリアルとして描画されます。
  • Advanced > Render As 2D Gaussiansをオンにすると、SceneCapture2D等に対応した近似的な描画方式に切り替わります。
    描画結果は厳密には不正確ですが、エンジンの描画パイプラインとの互換性が高くなり、SceneCapture2Dを含む多くの場合で機能します。
  • Advanced > Alpha Boost For 2D Gaussiansで、上記の「2D Gaussians」描画方式におけるガウシアンの透明度を調整します。
    「2D Gaussians」描画方式では透明度が薄くなりがちなので、この値を好みに合わせて調整してください。

v1.2以前からのトリミング範囲の移行

v1.2以前で使用されていたCrop Volumeは非推奨となりました。将来的に削除される可能性があります。
DEPRECATEDの下の"Crop"を無効にし、新しいCrop Volumesをご使用ください。

現在、VRはSpherical Harmonics Degree 0のみに対応

現状、Degree1～3を選択しても、VRをオンにするとDegree 0として描画されます。Degree1～3には順次対応予定です。
(v1.5でDegree1～3に対応しました)

描画範囲の広いデータでチラつきが発生する場合

デフォルトではガウシアンのソート順を16bitの精度で計算しており、遠方ではソート順を正しく評価できなくなるため、広範囲のデータではチラつきが発生します。

UE5.2以上で、「Project Settings > Plugins > Niagara > Renderer > Default Sort Precision」を「High」にすると多くの場合は問題が解決します。

既知の問題

VRでの既知の問題

UE5.1では、HMDのRollが0以外（首を左右に傾けた状態）では正常に描画されません。UE5.2以上を使用してください。

縦長画面での問題

UE5.1では、画面のアスペクト比が縦長だと正常に描画できない場合があります。UE5.2以上を使用してください。

Lit表示の既知の問題

  1. ポイントライトが3D Gaussian Splattingのデータの表面に近い場合、不均一な明るさとなる場合があります。
    下記では右側のライトが手前で突然明るくなる瞬間があります。
  2. スポットライト、矩形ライトの明るさが正しく評価されず、ディレクショナルライトやポイントライトより暗くなります。
    下記の3つのライトはいずれもIntensityが15cdですが、手前のスポットライトと右側の矩形ライトが左側のスポットライトに比べて暗いことがわかります。