| Since | 18.0 |
int usd_metadatalen(<stage>stage, string path, string name)
この関数は、指定したメタデータの長さを返します。
配列メタデータであれば、その配列の長さを返し、それ以外のメタデータであれば、1を返します。
<stage>
ノードのコンテキスト内(例えば、Wrangle LOP)で実行する時、ステージの読み込み先となる(0から始まる)入力番号を表現した整数をこの引数に指定することができます。 この整数は、特定の入力を参照する文字列形式(例えば、“opinput:0”)と等価です。
この引数を使用して、USDファイル(例えば、“/path/to/file.usd”)を参照したり、op:をパス接頭辞として使用して他のLOPノードのクックされるステージ(例えば、“op:/stage/lop_node”)を参照することができます。
path
オブジェクト(例えば、Prim、アトリビュート、リレーションシップ)のパス。
name
メタデータ名。
(場合によっては入れ子化された)VtDictionaries内の値にアクセスするためのネームスペース付きの名前を指定することができます。 例えば、カスタムデータ辞書だと、“customData:name”または“customData:name:subname”です。 ネームスペースなしで名前を指定したいのであれば、その名前(“active”や“documentation”)にアクセスできるようにオブジェクトスキーマ側で、指定したメタデータを宣言する必要があります。
Returns
配列メタデータの長さ。メタデータが配列でない場合は1を返します。 メタデータが配列かどうかをチェックしたいのであれば、usd_isarraymetadataを使用してください。
Examples ¶
// cube Prim上のメタデータの配列長を取得します。 int length = usd_metadatalen(0, "/geo/cube", "customData:name");
| See also | |
| usd | |
| usd_metadata |