GeoUVProject

The GeoUVProject node modifies or creates texture coordinates on a mesh using a projection from a Camera or an Axis node. If the object already has UV coordinates, this node replaces them. This simple example shows a CheckerBoard material projected onto a bunny using a Camera node to position the material.

Tip: GeoUVProject's classic 3D system equivalent is the UVProject node.

Inputs and Controls

Connection Type	Connection Name	Function
Input	axis/cam	The Axis or Camera node controlling the projection attributes.
Input	unnamed	The previous stage in the scene you want to affect.

Control (UI)	Knob (Scripting)	Default Value	Function
GeoUVProject
Mask	mask_patterns	{lastmodified}	Specifies the mask pattern to match the prim names to affect. The default mask, {lastmodified}, applies the effect to whatever was changed by the previous node. A simple way to think of it is that {lastmodified} affects the node above. You can use standard glob-style variables, such as /, to create masks or use individual prim names separated by spaces. For example, /GeoCube 1 /GeoCard3 applies the effect to only those prims. Tip:* You can also use the cog menu, the Viewer picker, or drag and drop paths from the Scene Graph to create masks.
Projection	projection	Perspective	Sets the projection type for rendered objects. Usually, it’s best to select a type that’s close to the object’s surface shape. • Off • Perspective • Planar • Spherical • Cylindrical Note: When Projection is set to off, the GeoUVProject node is essentially disabled.
Plane	plane	XY	Sets the projection direction to project the texture image along axes: • XY • YZ • ZX Note: This dropdown menu is only available if you selected planar as the projection type.
Project On	project_on	Both	Sets which surfaces of a 3D object the projection falls on through the camera: • Both • Front • Back
View Frustum Culling	frustum_culling	off	When enabled, the GeoUVProject node affects only the vertices inside the camera view frustum. Any vertices outside the view frustum are not affected and they retain their original uv coordinates.
Invert U	u_invert	off	When enabled, the u coordinates are inverted on the horizontal axis.
Invert V	v_invert	off	When enabled, the v coordinates are inverted on the vertical axis.
U Scale	u_scale	1	Stretches or squashes the texture on the horizontal axis.
V Scale	v_scale	1	Stretches or squashes the texture on the vertical axis.
Attribute Name	uv_attrib_name	primvars:st	Specifies the name of the attribute to use for the UV coordinates of the upstream geometry. If your geometry has more than one set of UV coordinates, you can choose the attribute that suits the projection type.
Generate Perspective	generate_w	off	When enabled, GeoUVProject generates an stw attribute that adds a perspective component w to the UV coordinates.
W Attribute Name	uvw_attrib_name	primvars:stw	When Generate Perspective is enabled, W Attribute Name specifies the name of the attribute to use for the perspective UV coordinates of the upstream geometry. If your geometry has more than one set of UV coordinates, you can choose the attribute that suits the projection type.