Skip to content

BL_ArmatureConstraint

Base class: EXP_PyObjectPlus

Proxy to Armature Constraint. Allows to change constraint on the fly. Obtained through BL_ArmatureObject.constraints.

Type of constraint, (read-only).

Use one of these constants.

Type: integer, one of CONSTRAINT_TYPE_* constants

Name of constraint constructed as <bone_name>:<constraint_name>. constraints list.

Type: string

This name is also the key subscript on BL_ArmatureObject.

fraction of constraint effect that is enforced. Between 0 and 1.

Type: float

Position of target between head and tail of the target bone: 0=head, 1=tail.

Type: float.

runtime linear error (in Blender units) on constraint at the current frame.

This is a runtime value updated on each frame by the IK solver. Only available on IK constraint and iTaSC solver.

Type: float

Runtime rotation error (in radiant) on constraint at the current frame.

Type: float.

This is a runtime value updated on each frame by the IK solver. Only available on IK constraint and iTaSC solver.

It is only set if the constraint has a rotation part, for example, a CopyPose+Rotation IK constraint.

Primary target object for the constraint. The position of this object in the GE will be used as target for the constraint.

Type: KX_GameObject.

Secondary target object for the constraint. The position of this object in the GE will be used as secondary target for the constraint.

Type: KX_GameObject.

Currently this is only used for pole target on IK constraint.

True if the constraint is active.

Type: boolean

Weight of the IK constraint between 0 and 1.

Only defined for IK constraint.

Type: float

Type of IK constraint, (read-only).

Use one of these constants.

Type: integer.

Combination of IK constraint option flags, read-only.

Use one of these constants.

Type: integer

Distance the constraint is trying to maintain with target, only used when ik_type=CONSTRAINT_IK_DISTANCE.

Type: float

Use one of these constants.

Additional mode for IK constraint. Currently only used for Distance constraint:

Type: integer