| Since | 22.0 |
This component reads animation stored in a clip and plays it back according to the value of a driver. As the driver moves between Fit Min and Fit Max, that range is remapped onto the clip’s frame range (Start Frame to End Frame), and the evaluated translate, rotate, and scale (as well as float, vector, bool, and int channels) are applied to the driven nodes.
The driver can be an existing control, a new control created by this component, or a slider added to the component’s menu. Add a setup for each driver relationship you want to create.
For a step-by-step walkthrough of using this component with the APEX Rig Pose SOP, see working with set driven keys. The APEX SetDrivenKey recipe provides a ready-made example setup.
Parameters ¶
Name
The name to add to the nodes created by this component.
Setups
Each setup defines one driven-key relationship: a driver, the nodes it drives, the animation clip, and how the driver value is remapped onto the clip. Add a setup for each driver you want to set up.
Settings ¶
Animation Layer
The animation layer in the clip to read channels from. If Driver is empty, the animation layer name is used as the driver name.
T
When turned on, the translation channels from the clip are applied to the driven nodes.
R
When turned on, the rotation channels from the clip are applied to the driven nodes.
S
When turned on, the scale channels from the clip are applied to the driven nodes.
Start Frame
The frame the driver’s Fit Min value maps to.
End Frame
The frame the driver’s Fit Max value maps to.
Clip Path
The path to the animation clip that stores the channels used to drive the nodes.
Driven ¶
Nodes
A pattern that selects the TransformObject nodes to drive. This parameter accepts APEX path patterns, so you can specify tags in this field, for example
#<tag>.
Driver ¶
Driver
The control whose value drives the animation. If the control doesn’t exist, it is created by this component. If left empty, the Animation Layer name is used. Append a channel name to drive a single channel, for example myControl:ry.
Fit Min
The driver value that maps to the Start Frame of the clip.
Fit Max
The driver value that maps to the End Frame of the clip.
Parent ¶
Parent
The parent of the driver control when a new control is created by this component. This parameter accepts APEX path patterns, so you can specify tags in this field.
Tags ¶
Shape ¶
The APEX Configure Controls SOP provides more options for changing the look of the controls.
Shape
The shape of the controls. It can be set to any of the built-in APEX control shapes.
Color
The color of the control shapes.
Translate
The translation of the control shapes.
Rotate
The rotation of the control shapes.
Scale
The scale of the control shapes.
| See also |