int usd_primvarlen(<stage>stage, string primpath, string name)
int usd_primvarlen(<stage>stage, string primpath, string name, float timecode)
This function returns the length of a given primvar.
For array primvars it is the length of an array, and for non-array primvars the length is 1.
<stage>
When running in the context of a node (such as a wrangle LOP), this argument can be an integer representing the input number (starting at 0) to read the stage from. The integer is equivalent to the string form referencing a particular input, e.g., "opinput:0".
primpath
The path to the primitive.
name
Primvar name (without namespace).
timecode
The time code at which to check the array length. If not given, the time code corresponding to the current frame is used.
Returns
The length of the array primvar, or 1 if the primvar is not an array, or 0 if the primvar does not exist. Use usd_isarrayprimvar to check if the primvar is an array.
Examples
// Get the array length of the primvar. int array_length = usd_primvarlen(0, "/geo/cube", "array_primvar_name");
| See also | |
| usd | |
| usd_primvar |
|