Constraint(bpy_struct)¶
base class — bpy_struct
subclasses —
ActionConstraint
, ArmatureConstraint
, CameraSolverConstraint
, ChildOfConstraint
, ClampToConstraint
, CopyLocationConstraint
, CopyRotationConstraint
, CopyScaleConstraint
, CopyTransformsConstraint
, DampedTrackConstraint
, FloorConstraint
, FollowPathConstraint
, FollowTrackConstraint
, KinematicConstraint
, LimitDistanceConstraint
, LimitLocationConstraint
, LimitRotationConstraint
, LimitScaleConstraint
, LockedTrackConstraint
, MaintainVolumeConstraint
, ObjectSolverConstraint
, PivotConstraint
, PythonConstraint
, ShrinkwrapConstraint
, SplineIKConstraint
, StretchToConstraint
, TrackToConstraint
, TransformCacheConstraint
, TransformConstraint
-
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, (readonly)
-
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.CUSTOM
Custom Space – The constraint is applied in local space of a custom object/bone/vertex group.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 rest pose local coordinate system of the bone, thus including the parent-induced transformation.LOCAL
Local Space – The constraint is applied relative to the local coordinate system of the object.
- Type
enum in [‘WORLD’, ‘CUSTOM’, ‘POSE’, ‘LOCAL_WITH_PARENT’, ‘LOCAL’], default ‘WORLD’
-
show_expanded
¶ Constraint’s panel is expanded in UI
- Type
boolean, default False
-
space_subtarget
¶ Armature bone, mesh or lattice vertex group, …
- Type
string, default “”, (never None)
-
target_space
¶ Space that target is evaluated in
WORLD
World Space – The transformation of the target is evaluated relative to the world coordinate system.CUSTOM
Custom Space – The transformation of the target is evaluated relative to a custom object/bone/vertex group.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 to its rest pose local coordinate system, thus including the parent-induced transformation.LOCAL
Local Space – The transformation of the target is evaluated relative to its local coordinate system.
- Type
enum in [‘WORLD’, ‘CUSTOM’, ‘POSE’, ‘LOCAL_WITH_PARENT’, ‘LOCAL’], default ‘WORLD’
-
type
¶ 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.
- 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’], default ‘CAMERA_SOLVER’, (readonly)
-
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
-
Inherited Properties
Inherited Functions
References