Since | 17.5 |
int usd_attribsize(<stage>stage, string primpath, string name)
This function returns the tuple size of a given attribute. If the attribute is an array, it returns the tuple size of the array element. E.g., for vector types,this is the number of components.
<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”.
You can also use this argument to refer to a USD file (e.g., “/path/to/file.usd”), or to another LOP node’s cooked stage using the op:
as the path prefix (e.g., “op:/stage/lop_node”).
primpath
The path to the primitive.
name
Attribute name.
Returns
The tuple size of the attribute.
-
For a vector type, this is the number of components.
-
For an integer, float, or string, this returns
1
. -
For an array attribute, this returns the tuple size of the elements.
If the attribute does not exist, returns 0
.
Use usd_attriblen if you want to obtain the array attribute length.
Examples ¶
// Get the tuple size of an attribute on the cube primitive. int tuple_size = usd_attribsize(0, "/geo/cube", "attribute_name");
See also | |
usd | |
usd_attrib |