Skip to content

Graph editor

Open RigExec → Animation Editors → Graph Editor to edit scalar Ts animation splines on the selected prims or properties. The editor supports double, float, and half curves. Vector attributes use time samples and do not appear as editable scalar splines.

Editing

Select curves in the list to isolate them. Drag keys to change time and value. Drag a tangent handle to move its end: the angle sets the slope and the length sets the width. Unified tangents share the angle; each side keeps its own length. Turn Weighted off to lock the length so a drag only rotates the handle. Hermite curves fix the width, so their handles always only rotate. Moved keys retain their order. Insert Key adds a knot without replacing the rest of the curve. New keys use Auto tangents; editing an existing key preserves its tangent setup.

A drag authors nothing while it is in flight. The editor draws the edited curves and sends their values at the current frame to Hydra, so the viewport follows the drag; other frames update at the commit. Releasing the drag queues one edit for the next UI event-loop turn, authored to the edit target that was active at the press; Escape during the drag cancels it. The preview stays visible until the queued commit completes. Undo, another edit, a key press in the editor, a frame change, a selection change, and closing the editor commit a queued edit first. Buttons and numeric fields author immediately.

Edits use the same undo stack as the viewport tools. They are authored to the active edit target. Broken tangent state is stored in the knot's rigExec custom data because equal slopes do not imply unified tangents. Unify copies the outgoing slope to the incoming side.

Time and navigation

The frame ruler runs along the top of the plot. The current time is a line through the plot with a tab in the ruler that shows the frame number. Press or drag anywhere in the ruler to scrub; the cursor changes over it. Hold K and drag with the left button to scrub from anywhere in the plot without touching keys. Hold K and drag with the middle button to move the editor's time marker alone; the viewport moves to that frame when the button is released. Scrubbing snaps to whole frames inside the stage's frame range, because the viewer's timeline only holds those frames.

Alt + middle drag pans and Alt + right drag zooms, about the pressed point. Adding Shift holds either one to the axis the drag first moves along. The wheel zooms both axes about the cursor. Frames outside the stage range are shaded.

Extrapolation

The pre/post Infinity controls apply to the visible curves.

Setting USD mode Result
Constant TsExtrapHeld Hold the endpoint value
Linear TsExtrapLinear Extend the endpoint slope
Cycle TsExtrapLoopReset Repeat the curve without a value offset
Cycle with Offset TsExtrapLoopRepeat Offset each repetition to join endpoints
Oscillate TsExtrapLoopOscillate Alternate forward and backward repetitions

A loop on a single-key spline behaves as Held. Non-finite samples are not drawn. Frame All fits the keys; a tangent overshoot may extend outside that view.

Shortcuts

Key Action
A / F Frame all / selected keys
Home Frame the stage range
K + left drag Scrub
K + middle drag Move the time marker; the frame follows on release
I Insert key
Delete / Backspace Delete selected keys
Escape Cancel a drag or clear selection
Ctrl+Z / Ctrl+Shift+Z, Shift+Z, Ctrl+Y Undo / redo

Shortcuts apply to the editor window and yield to text-entry widgets. Clamped/Plateau tangents, audio, retiming tools, and Euler filtering are not implemented. The Qt-free model is tested by test_graph_model and test_graph_screen; bin/test/run_testusdview_graph.sh or .bat checks the UI.