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