int usd_primvarelementsize(<stage>stage, string primpath, string name)
This function returns the element size of a given primvar.
The primvar element size applies to array primvars, but it does not encode the length of the array. It specifies how many consecutive array elements should be taken as an atomic element to be interpolated over a gprim. So, on a mesh, array length relates to element size like this array_length = element_size * face_count.
In most cases, the element size is 1.
Note, element size is a USD concept and differs from the VEX tuple size obtained with usd_primvarsize or the VEX array length obtained with usd_primvarlen.
<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).
Returns
The primvar’s element size.
Examples
// Get the element size of a primvar on the cube primitive. int element_size = usd_primvarelementsize(0, "/geo/cube", "primvar_name");
| See also | |
| usd | |
| usd_primvar |
|