| Since | 22.0 |
This component reads the animation stored in an animation clip and plays it back based on the value of a driver control. As the driver moves between a range of values (Fit Min and Fit Max), the poses in the clip’s frame range (Start Frame to End Frame) are applied to the driven 
TransformObject nodes.
The driver can be an existing control or a new control created by this component (a slider added to the component’s 
menu). Add a Setups multiparm entry for each driver-animation relationship.
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
The number of setups that define a control that drives an animation clip.
Settings ¶
Animation Layer
The animation layer in the animation clip to read the channels from. If Driver is empty, this animation layer name is used as the driver control name.
T
When turned on, the clip’s translation channels are applied to the driven TransformObject nodes.
R
When turned on, the clip’s rotation channels are applied to the driven TransformObject nodes.
S
When turned on, the clip’s scale channels are applied to the driven TransformObject nodes.
Start Frame
The start frame of the animation. The driver’s Fit Min value maps to this frame.
End Frame
The end frame of the animation. The driver’s Fit Max value maps to this frame.
Clip Path
The path to the animation clip (.clip folder) in the character folder structure that stores the channels used to drive the TransformObject nodes.
Driven ¶
Nodes
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 and channel whose value drives the animation. Append the channel to the control name using a colon, for example, myControl:ry. If Driver is not set to an existing control and channel, this component creates a slider in the component’s menu that drives the animation:
-
If you don’t append a channel to the control name, a slider set to the name of the Driver is created in the component’s
menu. For example, if you set Driver to L_footAnkle_ik, a slider namedL_footAnkle_ikis created in the component’s menu. In this case, the left foot control doesn’t actually drive the animation; a slider named L_footAnkle_ikdrives the animation. -
If you set Driver to a control name that doesn’t already exist, a slider with the specified name is created in the component’s
menu. -
If you leave Driver empty, a slider with the Animation Layer name is created in the component’s
menu.
Fit Min
The driver value that maps to the Start Frame of the animation clip.
Fit Max
The driver value that maps to the End Frame of the animation 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 |
APEX AutoRig Component