# BL_ArmatureConstraint(EXP_PyObjectPlus)¶

base class — EXP_PyObjectPlus

class BL_ArmatureConstraint(EXP_PyObjectPlus)

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

Note

Not all armature constraints are supported in the GE.

type

Type of constraint, (read-only).

Use one of these constants.

Type

integer, one of CONSTRAINT_TYPE_* constants

name

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

Type

string

This name is also the key subscript on BL_ArmatureObject.

enforce

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

Type

float

headtail

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

Type

float.

Note

Only used if the target is a bone (i.e target object is an armature.

lin_error

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

rot_error

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.

target

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

Type
subtarget

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

Type

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

active

True if the constraint is active.

Type

boolean

Note

An inactive constraint does not update lin_error and rot_error.

ik_weight

Weight of the IK constraint between 0 and 1.

Only defined for IK constraint.

Type

float

ik_type

Type of IK constraint, (read-only).

Use one of these constants.

Type

integer.

ik_flag

Combination of IK constraint option flags, read-only.

Use one of these constants.

Type

integer

ik_dist

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

Type

float

ik_mode

Use one of these constants.

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

Type

integer