Skip to content

Viewport tools

RigExec → Viewport → Viewport Tools shows the Move, Rotate, and Scale toolbar. It provides transform handles, editing modes, snapping, settings, and undo. Tooltips identify each button. See the graph editor for editing animation curves.

Pose and pivot

Pose mode edits animation parameters at the evaluated control frame. Pivot mode edits rest placement, so the control keeps its animation in a new rest frame. Rest offsets are relative to the parent frame provider. Moving a rest frame normally carries its subtree; Preserve Children holds immediate child rests in world space. Enable it before starting the drag.

Scale is unavailable for rig pivots because rig rest spaces are orthonormalized. Plain transforms and rig controls have different supported channel sets; the toolbar reports unavailable operations.

Preview and commit

A live drag sends in-memory overrides to the evaluator or Hydra transform overlay. The stage keeps its committed values during preview. Releasing the drag queues one edit for the next UI event-loop turn; Escape during the drag cancels it. The preview remains visible until the queued commit completes. Undo, another edit, frame changes, and save input flush a pending commit first. Stage-dependent panels show committed values, and undo records the whole operation. Stage authoring stays on the stage's owner thread.

Write: Animation writes a spline knot for supported scalar attributes and a time sample for other attributes. Write: Default writes a default value. Existing splines or samples may override a default; the status label reports that condition. Edits use the current edit target.

Handles and settings

Move offers axis, plane, and camera-plane handles. Holding Ctrl while dragging an axis moves in its perpendicular plane. Rotate offers axis rings, a view ring, and free rotation; accumulated angles can exceed 180 degrees. Scale uses the cursor-distance ratio from the handle origin; negative scale can be disabled in Settings.

Settings include World/Object/Parent orientation, Gimbal rotation, step size, free rotation, negative-scale prevention, Preserve Children, the group pivot for a multi-selection (Selection Centre, Last Selected, or Individual Origins), and handle size. Axes viewed end-on are disabled when projection makes the drag unstable. Settings last for the session.

Snapping

Step Snap quantizes a delta. Grid, point, edge, and surface snapping position the pivot on a world-space target. Grid/point/edge snap takes precedence over relative step snap. Surface snapping is selected through the toolbar. Snap targets come from visible evaluated geometry where supported.

Shortcuts

Key Action
Q, W, E, R Select, Move, Rotate, Scale
D / Insert Toggle pivot editing
L Toggle Global/Local orientation
Shift+P Cycle the group pivot
+ / - Change handle size
Hold J Step snap during a drag
Hold X Grid snap
Hold C / V Edge / vertex snap
Hold B before dragging Preserve immediate child rests in pivot mode
Escape Cancel the active drag
Ctrl+Z Undo
Ctrl+Shift+Z, Shift+Z, Ctrl+Y Redo

Tool shortcuts yield to text-entry widgets. Shared usdview shortcuts remain available outside applicable manipulation gestures. On macOS, start an axis drag before pressing Ctrl because Qt can treat Ctrl-click as a right click.

Implementation and tests

Qt-free interaction code lives in gizmoMath.py, gizmoScreen.py, gizmoDrag.py, gizmoSnap.py, gizmoSettings.py, gizmoPreview.py, gizmoMarquee.py, and gizmoPerformance.py under plugin/rigExecUsdview. gizmoUI.py connects it to usdview and the shared undo stack. Run the corresponding test_gizmo_* suites with the Python test helper; bin/test/run_testusdview_gizmo.sh or .bat checks the viewport path.