Since | 19.0 |
int usd_iprimvarlen(<stage>stage, string primpath, string name)
int usd_iprimvarlen(<stage>stage, string primpath, string name, float timecode)
この関数は、指定したPrim上で直接見つかった指定したPrimvarの長さ、または、そのPrimの親Primsから継承されたPrimvarの長さを返します。
配列Primvarに関しては、これはその配列長を返し、それ以外のPrimvarは1を返します。
<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が配列でない場合は1
、そのPrimvarが存在しなければ0
を返します。
Primvarが配列かどうかをチェックしたいのであれば、usd_isarrayprimvarを使用してください。
Examples ¶
// cube上またはその親Prims上のPrimvarの配列長を取得します。 int array_length = usd_iprimvarlen(0, "/geo/cube", "array_primvar_name");
See also | |
usd | |
usd_primvar |
|