| Since | 19.0 |
int usd_iprimvarelementsize(<stage>stage, string primpath, string name)
この関数は、指定したPrim上で直接見つかったPrimvarのエレメントサイズ、または、そのPrimの親Primsから継承されたPrimvarのエレメントサイズを返します。
Primvarエレメントサイズは、配列Primvarsに適用されますが、その配列長はエンコードされません。
Primvarエレメントサイズには、Gprim上で補間される最小エレメントとして受け取る連続配列エレメントの数を指定します。
つまり、メッシュ上の配列長は、array_length = element_size * face_countのようにエレメントサイズに関係しています。
たいていの場合では、そのエレメントサイズは1です。
Note
このエレメントサイズはUSDの考え方に基づいており、usd_iprimvarsizeで得られるVEXタプルサイズ、または、usd_iprimvarlenで得られるVEX配列長とは異なります。
<stage>
ノードのコンテキスト内(例えば、Wrangle LOP)で実行する時、ステージの読み込み先となる(0から始まる)入力番号を表現した整数をこの引数に指定することができます。 この整数は、特定の入力を参照する文字列形式(例えば、“opinput:0”)と等価です。
この引数を使用して、USDファイル(例えば、“/path/to/file.usd”)を参照したり、op:をパス接頭辞として使用して他のLOPノードのクックされるステージ(例えば、“op:/stage/lop_node”)を参照することができます。
primpath
Primのパス。
name
(ネームスペースなしの)Primvar名。
Returns
Primvarのエレメントサイズ。
Examples ¶
// cube Prim上またはその親Prims上のPrimvarのエレメントサイズを取得します。 int element_size = usd_iprimvarelementsize(0, "/geo/cube", "primvar_name");
| See also | |
| usd | |
| usd_primvar |
|