Methods ¶
__init__(joint=None, goal_transform=hou.Matrix4(1.0), joint_offset=hou.Matrix4(1.0), target_type=hou.ik.targetType.Position, weight=1.0, priority=0, depth=-1)
Creates a new target.
joint
goal_transform
joint_offset
target_type
weight
priority
depth
joint()
→ hou.ik.Joint
Returns the joint that the target is attached to, or None
.
setJoint(joint)
Sets the hou.ik.Joint that the target is attached to.
This may be None
if, for example, the target defines a goal position for the skeleton’s center of mass.
goalTransform()
→ hou.Matrix4
Returns the world space goal transform.
setGoalTransform(xform)
Sets the target world space transform (a hou.Matrix4) for the joint.
jointOffset()
→ hou.Matrix4
Returns the local space joint offset transform. See hou.ik.Target.setJointOffset.
setJointOffset(xform)
Sets a local space transform (a hou.Matrix4) that is combined with the joint transform to produce the transform that the solver attempts to align with the goal transform. This can be used to place the target at an offset from the joint (for example, at the end of a bone).
targetType()
→ hou.ik.targetType
Returns the target’s type. See hou.ik.Target.setTargetType.
setTargetType(target_type)
Sets a hou.ik.targetType, which specifies whether the target affects position, orientation, or both.
weight()
→ float
Returns the target’s weight. See hou.ik.Target.setWeight.
setWeight(weight)
Sets a float
specifying the importance of the target.
When multiple targets have the same priority level, targets with a higher relative weight are more likely to be reached.
priority()
→ int
Returns the target’s priority level. See hou.ik.Target.setPriority.
setPriority(priority)
Sets an int
specifying the target’s priority level.
Targets from a lower priority level cannot interfere with targets from a higher priority level.
For example, priority levels can be used to ensure that the feet remain planted when manipulating the upper body of a skeleton.
setDepth(depth)
Specifies the number of parent joints that can be adjusted to achieve the goal transform. A negative depth indicates that the entire chain can be affected.
See also |