Constraint(bpy_struct)

base class — bpy_struct

subclasses — RigidBodyJointConstraint, ChildOfConstraint, CopyLocationConstraint, LimitDistanceConstraint, ClampToConstraint, StretchToConstraint, LockedTrackConstraint, CopyScaleConstraint, CopyTransformsConstraint, LimitScaleConstraint, LimitLocationConstraint, MaintainVolumeConstraint, FloorConstraint, CameraSolverConstraint, FollowPathConstraint, SplineIKConstraint, ShrinkwrapConstraint, TransformConstraint, KinematicConstraint, ActionConstraint, ObjectSolverConstraint, FollowTrackConstraint, LimitRotationConstraint, PivotConstraint, CopyRotationConstraint, TrackToConstraint, DampedTrackConstraint, PythonConstraint

class bpy.types.Constraint(bpy_struct)

Constraint modifying the transformation of objects and bones

active

Constraint is the one being edited

Type :boolean, default False

error_location

Amount of residual error in Blender space unit for constraints that work on position

Type :float in [-inf, inf], default 0.0, (readonly)

error_rotation

Amount of residual error in radians for constraints that work on orientation

Type :float in [-inf, inf], default 0.0, (readonly)

influence

Amount of influence constraint will have on the final solution

Type :float in [0, 1], default 0.0

is_proxy_local

Constraint was added in this proxy instance (i.e. did not belong to source Armature)

Type :boolean, default False

is_valid

Constraint has valid settings and can be evaluated

Type :boolean, default False, (readonly)

mute

Enable/Disable Constraint

Type :boolean, default False

name

Constraint name

Type :string, default “”, (never None)

owner_space

Space that owner is evaluated in

• WORLD World Space, The constraint is applied relative to the world coordinate system.
• POSE Pose Space, The constraint is applied in Pose Space, the object transformation is ignored.
• LOCAL_WITH_PARENT Local With Parent, The constraint is applied relative to the local coordinate system of the object, with the parent transformation added.
• LOCAL Local Space, The constraint is applied relative to the local coordinate system of the object.

Type :enum in [‘WORLD’, ‘POSE’, ‘LOCAL_WITH_PARENT’, ‘LOCAL’], default ‘WORLD’

show_expanded

Constraint’s panel is expanded in UI

Type :boolean, default False

target_space

Space that target is evaluated in

• WORLD World Space, The transformation of the target is evaluated relative to the world coordinate system.
• POSE Pose Space, The transformation of the target is only evaluated in the Pose Space, the target armature object transformation is ignored.
• LOCAL_WITH_PARENT Local With Parent, The transformation of the target bone is evaluated relative its local coordinate system, with the parent transformation added.
• LOCAL Local Space, The transformation of the target is evaluated relative to its local coordinate system.

Type :enum in [‘WORLD’, ‘POSE’, ‘LOCAL_WITH_PARENT’, ‘LOCAL’], default ‘WORLD’

type

• CAMERA_SOLVER Camera Solver.
• OBJECT_SOLVER Object Solver.
• FOLLOW_TRACK Follow Track.
• COPY_LOCATION Copy Location.
• COPY_ROTATION Copy Rotation.
• COPY_SCALE Copy Scale.
• COPY_TRANSFORMS Copy Transforms.
• LIMIT_DISTANCE Limit Distance.
• LIMIT_LOCATION Limit Location.
• LIMIT_ROTATION Limit Rotation.
• LIMIT_SCALE Limit Scale.
• MAINTAIN_VOLUME Maintain Volume.
• TRANSFORM Transformation.
• CLAMP_TO Clamp To.
• DAMPED_TRACK Damped Track, Tracking by taking the shortest path.
• IK Inverse Kinematics.
• LOCKED_TRACK Locked Track, Tracking along a single axis.
• SPLINE_IK Spline IK.
• STRETCH_TO Stretch To.
• TRACK_TO Track To, Legacy tracking constraint prone to twisting artifacts.
• ACTION Action.
• CHILD_OF Child Of.
• FLOOR Floor.
• FOLLOW_PATH Follow Path.
• PIVOT Pivot.
• RIGID_BODY_JOINT Rigid Body Joint.
• SCRIPT Script.
• SHRINKWRAP Shrinkwrap.

Type :enum in [‘CAMERA_SOLVER’, ‘OBJECT_SOLVER’, ‘FOLLOW_TRACK’, ‘COPY_LOCATION’, ‘COPY_ROTATION’, ‘COPY_SCALE’, ‘COPY_TRANSFORMS’, ‘LIMIT_DISTANCE’, ‘LIMIT_LOCATION’, ‘LIMIT_ROTATION’, ‘LIMIT_SCALE’, ‘MAINTAIN_VOLUME’, ‘TRANSFORM’, ‘CLAMP_TO’, ‘DAMPED_TRACK’, ‘IK’, ‘LOCKED_TRACK’, ‘SPLINE_IK’, ‘STRETCH_TO’, ‘TRACK_TO’, ‘ACTION’, ‘CHILD_OF’, ‘FLOOR’, ‘FOLLOW_PATH’, ‘PIVOT’, ‘RIGID_BODY_JOINT’, ‘SCRIPT’, ‘SHRINKWRAP’], default ‘CAMERA_SOLVER’, (readonly)

Inherited Properties

bpy_struct.id_data

Inherited Functions

bpy_struct.as_pointer bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.is_property_hidden bpy_struct.is_property_set bpy_struct.items

bpy_struct.keyframe_delete bpy_struct.keyframe_insert bpy_struct.keys bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.type_recast bpy_struct.values

References

Object.constraints ObjectConstraints.active ObjectConstraints.new ObjectConstraints.remove PoseBone.constraints

PoseBoneConstraints.active PoseBoneConstraints.new PoseBoneConstraints.remove UILayout.template_constraint