跳转到内容

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);