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

メッシュからスプラットへ

GsplatMeshスクリプトは、メッシュジオメトリをGaussian splatsに変換します。レンダーコンポーネントから三角形を抽出し、三角形ラスタライズを使用してメッシュ表面に均一に分布したスプラットを生成します。

ベータ機能

GsplatMeshは現在ベータ版です。問題が発生した場合は、PlayCanvas Engine GitHubリポジトリで報告してください。

注記

この機能は統合レンダリングモードが必要です。

概要​

GsplatMeshは以下を行うScriptコンポーネントです：

  • エンティティ階層のメッシュインスタンスから三角形を抽出
  • 各三角形をラスタライズしてスプラット位置を生成
  • マテリアルの色（エミッシブまたはディフューズ）をスプラットの色に使用
  • 内部でGSplatContainerを作成

これは、スタイライズされたレンダリングエフェクトのために3DモデルをスプラTT表現に変換する場合に便利です。

基本的な使い方​

// スクリプトをインポート
const { GsplatMesh } = await import('path/to/gsplat-mesh.mjs');

// エンティティにスクリプトコンポーネントを追加
entity.addComponent('script');
const meshSplat = entity.script.create(GsplatMesh);

// 別のエンティティのメッシュ階層からスプラットをビルド
meshSplat.buildFromEntity(sourceEntity, {
    splatSize: 0.02,
    recursive: true
});

API​

buildFromEntity(entity, options)​

エンティティのメッシュ階層からスプラットをビルドします。

パラメータ：

パラメータ型デフォルト説明
entityEntity-メッシュを抽出するエンティティ
options.splatSizenumber0.01各スプラットのサイズとそれらの間隔
options.recursivebooleantrue子を再帰的に検索するかどうか
options.marginnumber0.65splatSizeに対するマージン係数

スプラットサイズ： より小さい値は、より高密度のカバレッジのためにより多くのスプラットを作成します。スプラット間の間隔はこのサイズに基づきます。

マージン： スプラットが配置されない三角形エッジからの距離を制御します。マージンなし（スプラットがエッジまで拡張）の場合は0を使用し、共有三角形エッジでのオーバーラップアーティファクトを避けるにはより高い値を使用します。

clear()​

すべてのスプラットを削除し、内部コンテナを破棄します。

meshSplat.clear();

splatCount（読み取り専用）​

現在のスプラット数を返します。

console.log(`Generated ${meshSplat.splatCount} splats`);

色の抽出​

スクリプトは以下の順序でマテリアルから色を抽出します：

  1. エミッシブカラー（ゼロでない場合）
  2. ディフューズカラー（フォールバック）
  3. 白（非StandardMaterialのデフォルト）

透明なマテリアルの場合、オパシティも抽出され、オーバーラップを補正するために半分にされます。

トランスフォームの処理​

スプラットはGsplatMeshスクリプトを持つエンティティのローカル空間で生成されます。スクリプトは：

  1. ソースエンティティのワールドトランスフォームを取得
  2. メッシュ頂点をローカル空間に変換するための逆行列を計算
  3. そのローカル空間でスプラットを生成

これは、エンティティのトランスフォーム（位置、回転、スケール）を使用してシーン内にスプラット表現を配置できることを意味します。

コンテナの共有​

生成されたGSplatContainerは複数のgsplatコンポーネント間で共有できます：

// スプラットをビルド
meshSplat.buildFromEntity(sourceEntity, { splatSize: 0.05 });

// コンテナを取得
const container = meshSplat.entity.gsplat.resource;

// 他のエンティティと共有
anotherEntity.addComponent('gsplat', {
    resource: container,
    unified: true
});

ライブサンプル​

アニメーションする雲を持つ地形シーンをスプラット表現に変換する方法を示すProcedural Meshサンプルを参照してください。

スクリプトの場所​

スクリプトはPlayCanvas Engineリポジトリで利用可能です：

scripts/esm/gsplat/gsplat-mesh.mjs

関連項目​