usd_setmetadataelement
版本 | 18.0 |
---|
int usd_setmetadataelement(int stagehandle, string path, string name, int index, <type>value)
此函数用于设置数组元数据中的元素值。
stagehandle
要写入的舞台句柄。当前唯一有效值是0
,表示节点中的当前舞台。(此参数未来可能用于支持写入其他舞台)
path
对象路径。即图元(primitive)、属性(attribute)或关系(relationship)。
name
元数据名称。
名称可以使用命名空间来访问(可能嵌套的)VtDictionaries中的值,例如自定义数据字典,如”customData:name”或”customData:name:subname”。对于非命名空间名称,对象模式需要声明给定的元数据才能访问,例如”active”或”documentation”。
index
数组元数据中元素的索引。
返回值
成功时返回stagehandle
的值,失败时返回-1
。
示例
// 设置数组属性中索引为2的元素值usd_setmetadata(0, "/geo/sphere", "customData:a_float_arr", 2, 0.25);