| Since | 19.0 |
<type>[] usd_flattenediprimvar(<stage>stage, string primpath, string name)
<type>[] usd_flattenediprimvar(<stage>stage, string primpath, string name, float timecode)
This function returns a value of a flattened primvar on a given primitive or inherited from primitive’s ancestor.
Some primvars can be indexed, where the primvar is a compacted array of unique values, and there is an index array to map an entity to the value element. This function expands the compacted array by using the index array, and returns the expanded array of values.
<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
Primvar name (without namespace).
timecode
The USD time code at which to evaluate the attribute. A USD time code roughly corresponds to a frame in Houdini. If not given, the time code corresponding to the current frame is used.
Returns
The flattened value of an existing primvar, or zero/empty value if the primvar does not exist. Use usd_isiprimvar if you want to check whether the primvar exists.
Examples ¶
// Get the value of a flattened primvar on the cube primitive or cube's ancestor. float flat_values[] = usd_flattenediprimvar(0, "/geo/cube", "primvar_name"); f[]@flat_primvar_at_current_frame = usd_flattenediprimvar(0, "/geo/sphere", "bar"); f[]@flat_primvar_at_frame_7 = usd_flattenediprimvar(0, "/geo/sphere", "bar", 7.0);
| See also | |
| usd | |
| usd_primvar |
|