# BL_ArmatureConstraint(PyObjectPlus)

base class — `PyObjectPlus`

class `bge.types.``BL_ArmatureConstraint`(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: | `KX_GameObject`.

  `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: | `KX_GameObject`.

    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