| Since | 20.0 |
This component creates an APEX rig graph by translating the source skeleton into a rig hierarchy; it takes each of the skeleton joints and creates a 
TransformObject node in the rig graph. The TransformObject nodes can then be turned into controls that the user can interact with in the animate state.
For each TransformObject node that is created by this component, a mapping entry is added to the properties dictionary attribute on the node. This mapping entry contains the name of the reference skeleton and the joint that was used to create the node. For example, if Skeleton in the Source tab is set to Guides.skel, the mapping entry will contain "mapping:Guides.skel":"pelvis". This mapping information is used later in rig components like ikfkblend to identify the relationship between FK and IK nodes in the rig.
See rigging a simple geometry and rigging a character for example uses of this component.
Parameters ¶
Settings ¶
Prefix
The prefix to add to the control names.
Suffix
The suffix to add to the control names.
Use Skeleton Position
When turned on, positions the nodes in the graph based on the joint xform positions in world space.
Skeleton Position Scale
When Use Skeleton Position is turned on, this scales the nodes in the graph.
Use Node Color
When turned on, sets the color of the skeleton joints (and their corresponding TransformObject nodes).
Node Color
When Use Node Color is turned on, this is the color of the skeleton joints (and their corresponding TransformObject nodes).
Use Scale Inheritance
When turned on, sets the Scale Inheritance of all the TransformObject nodes. The scale inheritance can also be set in the properties dictionary on the source skeleton.
Scale Inheritance
See scale inheritance.
Use Rord
When turned on, sets the rotation order of the nodes globally.
Rord
When Use Rord is turned on, this is the rotation order of the nodes. The rotation order can also be set in the properties dictionary on the source skeleton.
Use Xord
When turned on, sets the transformation order of the nodes globally.
Xord
When Use Xord is turned on, this is the transformation order of the nodes. The transformation order can also be set in the properties dictionary on the source skeleton.
Use Shape Data
When turned on, sets the shape data for the controls from the guide skeleton.
Add Point Transform
When turned on, adds a 
skel::SetPointTransforms node to the graph, and connects all the TransformObject nodes created from the source Skeleton to this new skel::SetPointTransforms node. The TransformObject node names are used to set the skel::SetPointTransforms port names. To deform the skeleton, the skel::SetPointTransforms port names must match the skeleton joint names. See graphs for deforming geometry for more information.
Point Transform Name
When Add Point Transform is turned on, this is the name of the new skel::SetPointTransforms node.
Output Skeleton
The name of the skeleton you want to modify. This is set as a port name on the graph input and output nodes.
Source ¶
Skeleton
The reference skeleton used to create the node hierarchy.
Joint Group
The group of joints that TransformObject nodes are created for. By default, all the joints are included. Joint names are specified with the syntax, @name=<joint_name>.
Add
When turned off, creates the controls for Joint Group in world space - for example, if you specify the head joint in Joint Group, the control will be positioned at the head joint of the character. This is the default setting.
When turned on, adds the controls for Joint Group to the existing node hierarchy - the new TransformObject nodes are added to the existing hierarchy based on the skeleton joint hierarchy. This is useful if you already have a node hierarchy, and want to add additional joints to your skeleton.
Controls ¶
Parm Node Name
The name of the input parameters node in the rig.
Output Node Name
The name of the output node in the rig.
Promote T
Promotes the translate components of the specified TransformObject nodes. This parameter accepts APEX path patterns, so you can specify tags in this field, for example, %tag(<tag>).
Promote R
Promotes the rotate components of the specified TransformObject nodes. This parameter accepts APEX path patterns, so you can specify tags in this field.
Promote S
Promotes the scale components of the specified TransformObject nodes. This parameter accepts APEX path patterns, so you can specify tags in this field.
Shape ¶
Shape
The shape of the FK controls. It can be set to any of the built-in APEX control shapes.
Scale
The scale of the controls.
| See also |
APEX Autorig Component