PoseBoneConstraints(bpy_struct)

base class — bpy_struct

class bpy.types.PoseBoneConstraints(bpy_struct)

Collection of pose bone constraints

active

Active PoseChannel constraint

Type

Constraint

new(type)

Add a constraint to this object

Parameters

type (enum in ['CAMERA_SOLVER', 'FOLLOW_TRACK', 'OBJECT_SOLVER', 'COPY_LOCATION', 'COPY_ROTATION', 'COPY_SCALE', 'COPY_TRANSFORMS', 'LIMIT_DISTANCE', 'LIMIT_LOCATION', 'LIMIT_ROTATION', 'LIMIT_SCALE', 'MAINTAIN_VOLUME', 'TRANSFORM', 'TRANSFORM_CACHE', 'CLAMP_TO', 'DAMPED_TRACK', 'IK', 'LOCKED_TRACK', 'SPLINE_IK', 'STRETCH_TO', 'TRACK_TO', 'ACTION', 'ARMATURE', 'CHILD_OF', 'FLOOR', 'FOLLOW_PATH', 'PIVOT', 'SHRINKWRAP']) –

Constraint type to add

  • CAMERA_SOLVER Camera Solver.

  • FOLLOW_TRACK Follow Track.

  • OBJECT_SOLVER Object Solver.

  • COPY_LOCATION Copy Location – Copy the location of a target (with an optional offset), so that they move together.

  • COPY_ROTATION Copy Rotation – Copy the rotation of a target (with an optional offset), so that they rotate together.

  • COPY_SCALE Copy Scale – Copy the scale factors of a target (with an optional offset), so that they are scaled by the same amount.

  • COPY_TRANSFORMS Copy Transforms – Copy all the transformations of a target, so that they move together.

  • LIMIT_DISTANCE Limit Distance – Restrict movements to within a certain distance of a target (at the time of constraint evaluation only).

  • LIMIT_LOCATION Limit Location – Restrict movement along each axis within given ranges.

  • LIMIT_ROTATION Limit Rotation – Restrict rotation along each axis within given ranges.

  • LIMIT_SCALE Limit Scale – Restrict scaling along each axis with given ranges.

  • MAINTAIN_VOLUME Maintain Volume – Compensate for scaling one axis by applying suitable scaling to the other two axes.

  • TRANSFORM Transformation – Use one transform property from target to control another (or same) property on owner.

  • TRANSFORM_CACHE Transform Cache – Look up the transformation matrix from an external file.

  • CLAMP_TO Clamp To – Restrict movements to lie along a curve by remapping location along curve’s longest axis.

  • DAMPED_TRACK Damped Track – Point towards a target by performing the smallest rotation necessary.

  • IK Inverse Kinematics – Control a chain of bones by specifying the endpoint target (Bones only).

  • LOCKED_TRACK Locked Track – Rotate around the specified (‘locked’) axis to point towards a target.

  • SPLINE_IK Spline IK – Align chain of bones along a curve (Bones only).

  • STRETCH_TO Stretch To – Stretch along Y-Axis to point towards a target.

  • TRACK_TO Track To – Legacy tracking constraint prone to twisting artifacts.

  • ACTION Action – Use transform property of target to look up pose for owner from an Action.

  • ARMATURE Armature – Apply weight-blended transformation from multiple bones like the Armature modifier.

  • CHILD_OF Child Of – Make target the ‘detachable’ parent of owner.

  • FLOOR Floor – Use position (and optionally rotation) of target to define a ‘wall’ or ‘floor’ that the owner can not cross.

  • FOLLOW_PATH Follow Path – Use to animate an object/bone following a path.

  • PIVOT Pivot – Change pivot point for transforms (buggy).

  • SHRINKWRAP Shrinkwrap – Restrict movements to surface of target mesh.

Returns

New constraint

Return type

Constraint

remove(constraint)

Remove a constraint from this object

Parameters

constraint (Constraint, (never None)) – Removed constraint

move(from_index, to_index)

Move a constraint to a different position

Parameters
  • from_index (int in [-inf, inf]) – From Index, Index to move

  • to_index (int in [-inf, inf]) – To Index, Target index

copy(constraint)

Add a new constraint that is a copy of the given one

Parameters

constraint (Constraint, (never None)) – Constraint to copy - may belong to a different object

Returns

New constraint

Return type

Constraint

classmethod bl_rna_get_subclass(id, default=None)
Parameters

id (string) – The RNA type identifier.

Returns

The RNA type or default when not found.

Return type

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)
Parameters

id (string) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

Inherited Properties

Inherited Functions

References