| Since | 20.5 |
This component creates a lookat constraint for a driven TransformObject node. You can also set up multiple lookat constraints with this component - if the constraints are set up in the correct order, they can use each other’s drivers and targets as parents. The order of operations is important when doing this.
See rigging a character for an example use of this component.
Parameters ¶
name
The name that is added to the nodes created by this component.
guidesource
The guide skeleton that is used as a reference when creating controls.
Settings ¶
updir
The position of the up vector relative to the driven TransformObject node.
targetpos
The position of the lookat target relative to the driven TransformObject node.
worldspace
When setting up multiple lookat constraints with mirrored transforms, the relative offset to targetpos may not be desirable. In this case, turning on worldspace keeps the direction the same for all the constraints.
Driven ¶
parent
The parent of all the controls. If empty, the parent for all the controls is the parent of the driver. Make sure the parent is not a child of the driven. This parameter accepts APEX path patterns, so you can specify tags in this field, for example, %tag(<tag>).
driven
The TransformObject node to apply the lookat constraint to. This parameter accepts APEX path patterns, so you can specify tags in this field.
driver
A new TransformObject node that is inserted between the parent and driver, allowing you to control the driven node while it is constrained using the lookat. This new node needs a unique name that doesn’t conflict with any of the nodes in the hierarchy.
driverpromotet
When turned on, promotes the translate component of the driver.
driverpromoter
When turned on, promotes the rotate component of the driver.
driverpromotes
When turned on, promotes the scale component of the driver.
target
If you want to predefine the target’s position, target can be an existing TransformObject node in the hierarchy. If target is a unique name, it is created at the targetpos.
targetpromotet
When turned on, promotes the translate component of the target.
targetpromoter
When turned on, promotes the rotate component of the target.
targetpromotes
When turned on, promotes the scale component of the target.
up
A preexisting control can be used for the up position. If up is a unique name, a new up control is created.
uppromotet
When turned on, promotes the translate component of the up control.
uppromoter
When turned on, promotes the rotate component of the up control.
uppromotes
When turned on, promotes the scale component of the up control.
useup
When turned on, the up vector control is visible in the animate state. When turned off, a default up vector is set up based on the updir parameter.
keepdriven
When turned off, hides the driven node in the animate state.
keepoffset
When turned on, an offset is applied to the driven to keep its original orientation after creating the constraint.
lookataxis
The local vector on the driven node to align with the target position. For example, if you want the -Y axis of the driven node to point toward the target, set lookataxis to (0, -1, 0).
If keepoffset is turned on, lookataxis does not have any effect.
lookupaxis
The local vector on the driven node to align with the up position. For example, if you want the -Z axis of the driven node to point toward the up position, set lookupaxis to (0, 0, -1).
If keepoffset is turned on, lookupaxis does not have any effect.
Tags ¶
Shape ¶
scale
The scale of the control shapes.
color
The color of the control shapes.
| See also |
APEX Autorig Component
APEX Rigscript Component