Search Tips

Search is based on keyword.

`Ex: "Procedures"`

Do not search with natural language

`Ex: "How do I write a new procedure?"`

Give Feedback Support Portal

# UsdTransformSet

In USD, a "transform" commonly refers to the spatial transformation of a prim in the scene. Transformations are used to position, orient, and scale prims in 3D space. The main types of transformations are translation, rotation, and scale. You can also set a pivot point from which translation or rotation occurs. To learn more about transformations, see Native USD Transformations.

UsdTransformSet applies a 3D transform to one or more prims as defined by their paths in the USD scene. You can choose to append the transform to existing transforms using appendTransform, or leave it unchecked to overwrite any transforms on that prim.

Enter transform values along the x, y, and z axes for translate, rotate, and scale. You can also enter values for the pivot point for transformations away from the origin by translation and rotation.

The three transformation types can be applied in order as defined by any permutation of scale, rotate, and translate. Select this using the order dropdown.

Note: UsdTransformSet is the USD equivalent of Transform3D. However, there are differences between the default settings. For example, the stack order in Geolib defaults to "first", whereas the defaults in USD are the opposite.

The UsdTransformSet node also has an option which allows you to use Viewer transform manipulators against USD native scene locations. To use this option, makeInteractive should be set to Yes. See Viewer Manipulators for Native USD to learn more about the workflow.

# Inputs

Connection Type | Connection Name | Function
input | in | The incoming scene graph data that the node will operate on or modify.

# Controls

Control (UI) | Default Value | Function
--- | --- | ---
primPaths | N/A | The prim locations as described by their paths in the USD scene hierarchy
xformOpName | same as node name | The name given to the node. This is assigned automatically as the node name to make it unique. You can override the default to allow overrides for specific transform Ops. The node name is set using the ‘nodeName’ expression. This can be edited if you prefer.
appendTransform | off | Check this to append the transform to the current list of transforms that are active on the prim(s). If unchecked, the transform overwrites any existing transforms on the prim(s).
order | Scale Rot Trans | Select the order by which the three transformations are applied.
rotateOrder | Rx Ry Rz | Select the axes order by which the rotation takes place. By default the rotation is first around the x axis, then y, and finally z.
translate | 0.0,0.0,0.0 | The amounts to translate along the x, y, and z axes.
rotate | 0.0,0.0,0.0 | The amounts to rotate the prims around the x, y, and z axes.
scale | 1.0,1.0,1.0 | The amounts to scale the prims along the x, y, and z axes.
pivotTranslate | 0.0,0.0,0.0 | The amounts by which the pivot point for transformations is translated along the x, y, and z axes.
pivotRotate | 0.0,0.0,0.0 | Enter the amounts by which the pivot point for transformations is rotated around the x, y, and z axes.
makeInteractive | Yes | When set to "Yes", the selected path can be interactively manipulated in the Viewer. This option is only available when the mode parameter is set to "Single Path".
asMatrix | disabled | If makeInteractive is set to “No”, this option becomes visible, allowing you to set the attributes as a matrix.