メインコンテンツまでスキップ

LODを手動で作成する方法 (CLI)

このガイドでは、splat-transform CLIツールを使用してSplatのLODファイルを手動で作成し、Arrival.Spaceにアップロードする方法を説明します。

この方法を使用する場面​

Arrival.Spaceはプラットフォーム内で便利なワンクリックLOD生成を提供していますが、手動でのLOD作成が望ましいシナリオもあります：

  • 個別のPLYファイル: 外部ツールや手動のデシメーションなどから得られた、事前に削減された複数の .ply ファイルをLOD構造に統合したい場合。
  • 細かい制御: ワンクリック機能が提供するよりも、削減比率、チャンクサイズ、その他のパラメータをより細かく制御する必要がある場合。
  • オフライン処理: アップロード前にローカルでLODを処理したい場合、またはLOD生成を独自のパイプラインに統合したい場合。
  • 非常に大きなシーン: 極めて大きなスキャンの場合、メモリ割り当てを増やしたローカル処理の方が信頼性が高い場合があります。
ワンクリック生成をお好みですか？

簡単で手軽なLODセットアップが必要な場合は、ワンクリックLOD作成ガイドをご覧ください — Arrival.Space内で自動的にすべてを処理します。

要約​

  1. .ply ファイルの削減バージョンを作成します（またはLODが組み込まれた .lcc ファイルを使用します）
  2. LOD構造を生成します: splat-transform [files] -l [level] output/lod-meta.json
  3. ZIPに圧縮してArrival.Spaceにアップロードします
  4. プリセットセレクターの「Edit」ボタンからLOD設定を調整します

splat-transformのインストール​

インストールガイドはSplat Transformガイドセクションにあります。

1. LODファイルの準備​

オプションA: .lcc ファイルを使用する場合​

.lcc ファイルがある場合、通常はすべてのLODレベルが組み込まれています。以下の手動削減ステップをスキップして、直接出力の生成に進むことができます。

オプションB: .ply ファイルを使用する場合​

最高解像度の .ply ファイルから始めます。 次に削減バージョンを作成します — 理想的には各バージョンが前のものより約50%小さくなるようにします。

8GBのソースの例：

my_splat_file.ply (8 GB) → LOD 0
my_splat_file_1.ply (4 GB) → LOD 1
my_splat_file_2.ply (2 GB) → LOD 2
my_splat_file_3.ply (1 GB) → LOD 3
my_splat_file_4.ply (512 MB) → LOD 4
my_splat_file_5.ply (256 MB) → LOD 5

2. splat-transform を使用してLOD構造を生成する​

最終LOD出力用の空のターゲットフォルダを作成します：

mkdir LOD_OUT

.lcc ファイルの場合：​

重要: .lcc ファイルを直接参照してください（ZIPアーカイブではありません）。.lcc ファイルは通常、.bin ファイル（例：data.bin, index.bin, attrs.lcp, collision.lci）とともにフォルダ内にあります。

コマンド構造：

splat-transform [path-to-folder]/file.lcc [output-folder]/lod-meta.json

例：

splat-transform ./my_scan_folder/data.lcc LOD_OUT/lod-meta.json

これにより、LOD_OUT/ フォルダ内に lod-meta.json とすべてのLODチャンクが作成されます。

複数の .ply ファイルの場合：​

ファイル名を実際の .ply ファイルパスに置き換えてください：

splat-transform \
  my_splat_file.ply    -l 0 \
  my_splat_file_1.ply  -l 1 \
  my_splat_file_2.ply  -l 2 \
  my_splat_file_3.ply  -l 3 \
  my_splat_file_4.ply  -l 4 \
  my_splat_file_5.ply  -l 5 \
  LOD_OUT/lod-meta.json

これにより、LOD_OUT/ ディレクトリに lod-meta.json ファイルと対応するLODチャンクが書き出されます。

非常に大きなシーンの場合

非常に大きなシーンでコマンドがメモリ不足エラーになる場合、Node.jsのメモリ割り当てを増やすことができます：

node --max-old-space-size=32000 node_modules/.bin/splat-transform \
  my_splat_file.ply    -l 0 \
  my_splat_file_1.ply  -l 1 \
  my_splat_file_2.ply  -l 2 \
  my_splat_file_3.ply  -l 3 \
  my_splat_file_4.ply  -l 4 \
  my_splat_file_5.ply  -l 5 \
  LOD_OUT/lod-meta.json

3. Arrival.Spaceへのアップロード​

LODフォルダをZIPに圧縮します：

zip -r LOD_OUT.zip LOD_OUT/
  • LOD_OUT.zip をArrival.Spaceで「+ Content」としてアップロードします
  • （推奨） すべてを整理するために新しいスペースにアップロードしてください

4. LOD設定の調整​

LODをArrival.Spaceにアップロードした後、プラットフォーム内でLOD設定（範囲、プリセットなど）を直接微調整できます。デスクトップおよびモバイルデバイス向けのプリセット設定方法の詳細については、LOD作成ガイド - ストリーミング設定の調整を参照してください。

その他のリソース​