Since | 20.5 |
This component sets up IK chains with more than 3 nodes. It can also set up multiple IK chains in the rig hierarchy using segments.
See rigging a simple geometry and rigging a character for example uses of this component.
Parameters ¶
name
The name that is added to the nodes created by this component. This name is not necessary when using segments because the segment name is also added to the nodes.
prefix
The prefix for the controls (TransformObject nodes) that are added by this component.
suffix
The suffix for the controls (TransformObject nodes) that are added by this component.
guidesource
The guide skeleton that is used as a reference when creating controls.
Settings ¶
dampen
A larger value dampens the effect of the IK solve, smoothing its snapping effects at the cost of accuracy.
stretch
A larger value allows more stretch for the IK chain when the target is beyond the length of the chain.
trackingthreshold
Sets the accuracy of the solve. A higher value is faster but less accurate.
usetwist
When turned on, uses the pole vector to twist the IK chain.
usegoalrot
When turned on, uses the goal rotation for the target orientation. When turned off, uses the solver’s position for the target orientation.
resiststraight
When turned on, resists straightening of the IK chain.
levelpolevec
When turned on, sets the pole vector controls to world orientation.
leveltip
When turned on, sets the tip controls to world orientation.
levelroot
When turned on, sets the root controls to world orientation.
polvecoffset
The amount to offset the pole vector in the direction of the middle joint (between the root and tip). The IK chain must be slightly bent for this to work.
swapname
When turned on, sets the name parameter to be a prefix. When turned off, sets the name parameter to be a suffix.
Driven ¶
segments
Segments are tags that separate each IK chain. For example, *Leg
loops over tags L_Leg
and R_Leg
. Tags can be set up on skeleton joints using an Attribute Adjust Array SOP. See preparing skeletons for rigging for more information.
If segments is empty, the multiik logic is run once.
Note
The segments parameter does not take APEX path patterns, for example, the %tag() function. Instead, specify the tag names directly in this field.
driven
The nodes to drive. You can specify the individual joints, for example, L_Hip
, L_Knee
, L_Ankle
, or a tag that exists on the TransformObject nodes, for example, %tag(ik) & %tag(L_Leg)
.
It is good practice to also specify the bind
tags that are set up by default on the fktransform component’s tags parameter. The fktransform component is normally the first component used to start building a rig. Including the bind
tag helps to ensure that you don’t include other controls that might have inherited, for example, the L_Leg
tag. So in this case, you can set driven to %tag(bind) & %tag(ik)
.
Parents ¶
rootparent
The parent of the root control(s). When empty, the root control has the same parent as the root node of the IK chain. To unparent the root control, put an underscore in rootparent.
tipparent
The parent of the tip control(s). When empty, the tip is not parented.
povectorparent
The parent of the pole vector(s). When empty, the pole vector is parented to the tip.
Tags ¶
Shape ¶
shape
The shape of the controls. It can be set to any of the built-in APEX control shapes.
scale
The scale of the control shapes.
color
The color of the control shapes.
See also |