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

Splat Transformガイド

このガイドでは、splat-transform のインストール方法と、さまざまな状況で使用できる便利なコマンドを紹介します。

前提条件​

以下のコマンドを使用するには、npm が必要です。公式ガイドを参照して、お使いのデバイスにインストールしてください：

NPM Installation Guide

npmがすでにインストールされている場合は、シェルまたはターミナルを開き、以下のコマンドでインストールを確認してください：

npm -v

出力に11.4.2のようなバージョン番号が表示されれば、npmは正しくインストールされています。コマンドが認識されない場合は、npmが正しくインストールされていません。

さらに、PlayCanvasのSplatTransform CLIツールが必要です。以下のコマンドでsplat-transformをグローバルにインストールできます：

npm install -g @playcanvas/splat-transform

インストール後、以下のコマンドで確認してください：

splat-transform --version

出力には0.15のようなバージョン番号が表示されるはずです。

作業を始める前に​

アセットの操作を始める前に、CLIツールを使いやすくするために以下の点に注意してください：

  1. フォルダ名やファイル名にスペースを使わないようにしましょう。特殊文字のエスケープが不要になります。
  2. 対象フォルダ内でターミナル/シェルを開くと、フルパスを入力する必要がなくなります （Windows/macOS：右クリック → ターミナルで開く）。
  3. -wパラメータの使用は避けてください。意図しないファイルが上書きされる可能性があります。

基本的な使い方​

splat-transformの一般的な使い方：

splat-transform input [ACTIONS BEFORE] output [ACTIONS AFTERWARDS]
  • ACTIONS BEFOREは、変換またはファイル作成の前に実行されるすべてのフィルタや操作です。
  • ACTIONS AFTERWARDSは、変換またはファイル作成の後に実行されるすべてのフィルタや操作です。

便利なアクション​

パラメータ一覧の表示​

コンソール内で利用可能なすべてのパラメータの概要を確認するには、以下のコマンドを使用します：

splat-transform -h

NaN Gaussianのフィルタリング​

NaNまたはInf値を含むGaussianを除去するために、--filter-nanまたは-Nフラグを追加することを推奨します。

例：

splat-transform your-file.ply -N  your-output-filename.ply

既存ファイルの上書き​

パラメータを忘れた場合や、すでに生成されたファイルやフォルダをすばやく置き換える必要がある場合は、手動で削除するか、以下のコマンドで上書きできます：

splat-transform your-file.ply -w your-file.ply

Harmonicsのフィルタリング​

コリジョン用に低解像度のPLYを生成する場合、すべてのHarmonicsを除去することを推奨します。 以下のコマンドですべてのSH Harmonicsを除去します：

splat-transform your-file.ply -H 0 your-output-file.ply
詳しく知りたい方へ

追加のパラメータ説明は、PlayCanvasのSplatTransform CLIツールの公式ページで確認できます。

SOG生成​

現在のディレクトリでターミナルまたはシェルを開いてください。そうしないと、PLYが配置されているフォルダに移動する必要があります。

現在のディレクトリにいる場合、以下のコマンドでPLYをSOGに変換できます：

splat-transform your-file.ply your-output-filename.sog

現在のディレクトリにいる場合、以下のコマンドで.compressed.plyをSOGに変換できます：

splat-transform your-file.compressed.ply your-output-filename.sog

LOD生成​

ステップバイステップのガイドはLOD作成ガイドのセクションにあります。

LCCおよびLOD用のコリジョン生成​

コリジョンを作成するには、.lciコリジョンファイルの統合がまだ実装されていないため、現在は回避策が必要です。

important

この回避策はLODとLCCの両方で使用できます。

LCCデータセットでの回避策：

  1. LCCをテキストエディタで開きます（Windows：メモ帳、Mac：メモまたはTextEdit）
  2. totalLevelという用語を検索します
  3. この数値から1を引きます（例：totalLevel: 7の場合は6）
  4. 以下のコマンドで低解像度のPLYを生成します
splat-transform your-lcc-data.lcc -O 6 low-resolution.ply

オプション：環境も含めたい場合は、以下のコマンドを使用してください：

splat-transform your-lcc-data.lcc -O 6 -E environment.bin low-resolution.ply
  1. スプラットの低解像度バージョンを別のエンティティとしてアップロードし、コリジョンを生成します
  2. コリジョンをダウンロードして、LCCに追加します

PLYデータセットでの回避策：

  1. スプラットの低解像度バージョンを生成します。
  2. スプラットの低解像度バージョン（約100〜200万スプラット）を別のエンティティとしてアップロードします（できれば別のスペースに）
  3. そのエンティティで**「コリジョンを生成」**ボタンを使用してコリジョンメッシュを作成します。
  4. 生成されたコリジョンファイルをダウンロードまたは確認します。
  5. このコリジョンファイルをLODエンティティにアップロードします。