primuv

This function specifies the position using intrinsic primitive UVs. To use UVs stored in UV attribute, use uvsample instead.

<type> primuv(<geometry>geometry, string attribute_name, int prim_num, vector uvw)

<type>[] primuv(<geometry>geometry, string attribute_name, int prim_num, vector uvw)

<geometry>

When running in the context of a node (such as a wrangle SOP), this argument can be an integer representing the input number (starting at 0) to read the geometry from.

Alternatively, the argument can be a string specifying a geometry file (for example, a .bgeo) to read from. When running inside Houdini, this can be an op:/path/to/sop reference.

attribute_name

The name of the attribute to read. For point and vertex attributes, the value at the given UV coordinates will be interpolated from the surrounding points/vertices.

prim_num

The primitive number to read the attribute from.

uvw

The primitive UVW coordinates at which to read the attribute.

• Returns the (possibly interpolated) value of the attribute at the given coordinates. If the attribute or primitive number doesn’t exist, returns 0.
• If you need to test for errors, you can use prim_attribute instead.