usd_primvarlen

Since	18.0

int  usd_primvarlen(<stage>stage, string primpath, string name)

int  usd_primvarlen(<stage>stage, string primpath, string name, float timecode)

此函数返回在指定图元上直接找到的给定primvar的长度。

对于数组型primvar，返回的是数组长度；对于非数组型primvar，长度始终为1。

<stage>

在节点上下文（如wrangle LOP节点）中运行时，此参数可以是表示输入编号的整数（从0开始），用于读取对应输入的stage。该整数等同于通过字符串形式引用特定输入，例如”opinput:0”。

也可以通过此参数引用USD文件（如”/path/to/file.usd”），或使用op:作为路径前缀引用其他LOP节点已烘焙的stage（如”op:/stage/lop_node”）。

primpath

目标图元的路径。

name

Primvar名称（不包含命名空间）。

timecode

评估属性时使用的USD时间码。USD时间码大致对应Houdini中的帧数。若未指定，则使用当前帧对应的时间码。

返回值

返回数组型primvar的长度，若非数组型primvar则返回1，若primvar不存在则返回0。可使用usd_isarrayprimvar来验证primvar是否为数组类型。

示例

// 获取cube图元上primvar的数组长度
int array_length = usd_primvarlen(0, "/geo/cube", "array_primvar_name");