ジオメトリ オブジェクトでプロパティを取得して設定する

メッシュやボリュームなどのジオメトリ オブジェクトで、point_position や voxel_fog_density などのプロパティを取得して設定できます。ユーザ独自のプロパティを作成してカスタム エフェクトをコントロールすることもできます。

概要 - プロパティ

通常、プロパティはオブジェクトのキーと値のペアです。キーは名前(文字列)で、値にはほとんどあらゆるものを指定できます。多くの場合、値には別のオブジェクトを指定できます。

特に、ジオメトリ オブジェクトには ジオメトリ プロパティを指定できます。point_position と voxel_fog_density は、両方ともジオメトリ プロパティの例です。ジオメトリ プロパティの値は、それ自体が次の値のような独自のプロパティを指定したオブジェクトです。

• プロパティのターゲットとなる(関連付けられている)ジオメトリ コンポーネント。たとえば、point_position、point_normal、point_size はすべて point_component をターゲットとします。また、voxel_fog_density と voxel_temperature は voxel_tile_tree をターゲットとします。
• このプロパティの既定値です。
• float3 ポイントの配列の位置など、プロパティのデータです。

プロパティを取得および設定するノード

プロパティを取得および設定するノードはいくつかあります。ほとんどの場合、get_geo_property と set_geo_property_data を使用します。たとえば、メッシュを変形するには、最初に get_geo_property を使用して point_position データを取得してから値を変更し、最後に set_geo_property_data を使用してオブジェクトに保存します。

get_geo_property

get_geo_property を使用すると、ジオメトリ プロパティの値の配列が返されます。また、既定値とターゲット コンポーネントの名前が返されます。

さらに、プロパティが見つかったかどうかを示すブール値を返す get_geo_property_check というノードもあります。

set_geo_property_data

set_geo_property_data を使用して、既存のジオメトリ プロパティのデータの配列を更新します。既定値やターゲット コンポーネントを指定する必要がないため、set_geo_property より便利です。

set_geo_property

set_geo_property を使用して、ジオメトリ プロパティを作成し、初期データ値を設定します。目的に応じて、カスタムのジオメトリ プロパティを作成したり修正できます。一度ジオメトリ プロパティを作成したら、get_geo_property や set_geo_property_data を使用して取得したり設定できます。

get_property, set_property

get_property や set_property を使用して、任意のプロパティを取得および設定します。ジオメトリ プロパティに限定されることはありません。適切なタイプの値であることを確認してください。