Since | 18.0 |
int usd_setmetadata(int stagehandle, string path, string name, <type>value)
int usd_setmetadata(int stagehandle, string path, string name, <type>value[])
この関数は、メタデータの値を設定します。
stagehandle
書き出し先のステージのハンドル。
現在のところ、唯一有効な値は0
のみです。
この値は、ノード内の現在のステージを意味します(今後は、この引数を使用することで他のステージへの書き出しが可能になります)。
path
オブジェクト(例えば、Prim、アトリビュート、リレーションシップ)のパス。
name
メタデータ名。
(場合によっては入れ子化された)VtDictionaries内の値にアクセスするためのネームスペース付きの名前を指定することができます。 例えば、カスタムデータ辞書だと、“customData:name”または“customData:name:subname”です。 ネームスペースなしで名前を指定したいのであれば、その名前(“active”や“documentation”)にアクセスできるようにオブジェクトスキーマ側で、指定したメタデータを宣言する必要があります。
Returns
成功するとstagehandle
の値、失敗すると-1
。
Examples ¶
// sphereにドキュメント文字列を設定します。 usd_setmetadata(0, "/geo/sphere", "documentation", "This is new documentation."); // sphereにいくつかカスタムデータの値を設定します。 usd_setmetadata(0, "/geo/sphere", "customData:a_float", 0.25); usd_setmetadata(0, "/geo/sphere", "customData:a_string", "foo bar baz"); usd_setmetadata(0, "/geo/sphere", "customData:a_vector", {1.25, 1.50, 1.75}); float f_arr[] = {0, 0.25, 0.5, 0.75, 1}; usd_setmetadata(0, "/geo/sphere", "customData:a_float_array", f_arr); // アトリビュートにメタデータ値を設定します。 string attrib_path = usd_makeattribpath(0, "/geo/sphere", "attrib_name"); sd_setmetadata(0, attrib_path, "customData:foo", 1.25);
See also | |
usd | |
usd_metadata |