| Since | 18.0 |
<type>[] usd_flattenedprimvar(<stage>stage, string primpath, string name)
<type>[] usd_flattenedprimvar(<stage>stage, string primpath, string name, float timecode)
この関数は、指定したPrim上に平坦化されたPrimvarの値を返します。
一部のPrimvarsはインデックス化することができます。 インデックスPrimvarは固有な値だけでコンパクトに収納された配列になっており、エンティティと値要素をマッピングしたインデックス配列を持ちます。 この関数は、そのインデックス配列を使って、そのコンパクトに収納された配列を展開し、その展開された値の配列を返します。
<stage>
ノードのコンテキスト内(例えば、Wrangle LOP)で実行する時、ステージの読み込み先となる(0から始まる)入力番号を表現した整数をこの引数に指定することができます。 この整数は、特定の入力を参照する文字列形式(例えば、“opinput:0”)と等価です。
この引数を使用して、USDファイル(例えば、“/path/to/file.usd”)を参照したり、op:をパス接頭辞として使用して他のLOPノードのクックされるステージ(例えば、“op:/stage/lop_node”)を参照することができます。
primpath
Primのパス。
name
(ネームスペースなしの)Primvar名。
timecode
アトリビュートが評価されるUSDタイムコード。 USDタイムコードはHoudiniのフレームにほぼ一致します。 指定しなかった場合、現行フレームに相当するタイムコードが使用されます。
Returns
既存のPrimvarの平坦化された値。そのPrimvarが存在しなければゼロ/空っぽの値を返します。 そのPrimvarが存在するかどうかをチェックしたいのであれば、usd_isprimvarを使用してください。
Examples ¶
// cube Prim上の平坦化されたPrimvarの値を取得します。 float flat_values[] = usd_flattenedprimvar(0, "/geo/cube", "primvar_name"); f[]@flat_primvar_at_current_frame = usd_flattenedprimvar(0, "/geo/sphere", "bar"); f[]@flat_primvar_at_frame_7 = usd_flattenedprimvar(0, "/geo/sphere", "bar", 7.0);
| See also | |
| usd | |
| usd_primvar |
|