Module Constraint
[frames | no frames]

Module Constraint

The Blender.Constraint submodule

New:

This module provides access to the Constraint Data in Blender.

Examples:
 from Blender import *

 ob = Object.Get('Cube')
 if len(ob.constraints) > 0:
   const = ob.constraints[0]
   if const.type == Constraint.Type.FLOOR:
     offs = const[Constraint.Settings.OFFSET]
Or to print all the constraints attached to each bone in a pose:
 from Blender import *
 
 ob = Object.Get('Armature')
 pose = ob.getPose()
 for bonename in pose.bones.keys():
   bone = pose.bones[bonename]
   for const in bone.constraints:
     print bone.name,'=>',const

Classes
Constraint This object provides access to a constraint for a particular object accessed from Constraints.
Constraints This object provides access to sequence of constraints for a particular object.

Variable Summary
readonly dictionary Settings: Constant dict used for changing constraint settings.
readonly dictionary Type: Constant Constraint dict used by Constraints.append() and for comparison with Constraint.type.

Variable Details

Settings

Constant dict used for changing constraint settings.
  • Used for all constraints
    • TARGET (Object) (Note: not used by Limit Location (LIMITLOC), Limit Rotation (LIMITROT), Limit Scale (LIMITSIZE))
    • BONE (string): name of Bone sub-target (for armature targets) (Note: not used by Stretch To (STRETCHTO), Limit Location (LIMITLOC), Limit Rotation (LIMITROT), Limit Scale (LIMITSIZE))
  • Used by IK Solver (IKSOLVER) constraint:
    • TOLERANCE (float): clamped to [0.0001:1.0]
    • ITERATIONS (int): clamped to [1,10000]
    • CHAINLEN (int): clamped to [0,255]
    • POSWEIGHT (float): clamped to [0.01,1.0]
    • ROTWEIGHT (float): clamped to [0.01,1.0]
    • ROTATE (bool)
    • USETIP (bool)
  • Used by Action (ACTION) constraint:
    • ACTION (Action Object)
    • LOCAL (bool)
    • START (int): clamped to [1,maxframe]
    • END (int): clamped to [1,maxframe]
    • MIN (float): clamped to [-180.0,180.0]
    • MAX (float): clamped to [-180.0,180.0]
    • KEYON (int): values are XROT, YROT, ZROT
  • Used by Track To (TRACKTO) constraint:
    • TRACK (int): values are TRACKX, TRACKY, TRACKZ, TRACKNEGX, TRACKNEGY, TRACKNEGZ
    • UP (int): values are UPX, UPY, UPZ
  • Used by Stretch To (STRETCHTO) constraint:
    • RESTLENGTH (float): clamped to [0.0:100.0]
    • VOLVARIATION (float): clamped to [0.0:100.0]
    • VOLUMEMODE (int): values are VOLUMEXZ, VOLUMEX, VOLUMEZ, VOLUMENONE
    • PLANE (int): values are PLANEX, PLANEZ
  • Used by Follow Path (FOLLOWPATH) constraint:
    • FOLLOW (bool)
    • OFFSET (float): clamped to [-maxframe:maxframe]
    • FORWARD (int): values are TRACKX, TRACKY, TRACKZ, TRACKNEGX, TRACKNEGY, TRACKNEGZ
    • UP (int): values are UPX, UPY, UPZ
  • Used by Lock Track (FOLLOWPATH) constraint:
    • TRACK (int): values are TRACKX, TRACKY, TRACKZ, TRACKNEGX, TRACKNEGY, TRACKNEGZ
    • LOCK (int): values are LOCKX, LOCKY, LOCKZ
  • Used by Floor (FLOOR) constraint:
    • MINMAX (int): values are MINX, MINY, MINZ, MAXX, MAXY, MAXZ
    • OFFSET (float): clamped to [-100.0,100.0]
    • STICKY (bool)
  • Used by Copy Location (COPYLOC) and Copy Rotation (COPYROT)
    • COPY (bitfield): any combination of COPYX, COPYY and COPYZ
    • LOCAL (bool): Only for constraints which Armature targets.
  • Used by Copy Size (COPYSIZE) constraint:
    • COPY (bitfield): any combination of COPYX, COPYY and COPYZ
  • Used by Limit Location (LIMITLOC) constraint:
    • LIMIT (bitfield): any combination of LIMIT_XMIN, LIMIT_XMAX, LIMIT_YMIN, LIMIT_YMAX, LIMIT_ZMIN, LIMIT_ZMAX
    • LIMIT_LOCAL_BONE (boolean): USE WITH CAUTION. Only do something with this value if constraint is assigned to a bone.
    • LIMIT_LOCAL_NOPARENT (boolean): USE WITH CAUTION. Only do something with this value if constraint is assigned to an object with that has been parented to something.
    • XMIN (float): clamped to [-1000.0,1000.0]
    • XMAX (float): clamped to [-1000.0,1000.0]
    • YMIN (float): clamped to [-1000.0,1000.0]
    • YMAX (float): clamped to [-1000.0,1000.0]
    • ZMIN (float): clamped to [-1000.0,1000.0]
    • ZMAX (float): clamped to [-1000.0,1000.0]
  • Used by Limit Rotation (LIMITROT) constraint:
    • LIMIT (bitfield): any combination of LIMIT_XROT, LIMIT_YROT, LIMIT_ZROT
    • LIMIT_LOCAL_BONE (boolean): USE WITH CAUTION. Only do something with this value if constraint is assigned to a bone.
    • XMIN (float): clamped to [-360.0,360.0]
    • XMAX (float): clamped to [-360.0,360.0]
    • YMIN (float): clamped to [-360.0,360.0]
    • YMAX (float): clamped to [-360.0,360.0]
    • ZMIN (float): clamped to [-360.0,360.0]
    • ZMAX (float): clamped to [-360.0,360.0]
  • Used by Limit Scale (LIMITSIZE) constraint:
    • LIMIT (bitfield): any combination of LIMIT_XMIN, LIMIT_XMAX, LIMIT_YMIN, LIMIT_YMAX, LIMIT_ZMIN, LIMIT_ZMAX
    • XMIN (float): clamped to [-1000.0,1000.0]
    • XMAX (float): clamped to [-1000.0,1000.0]
    • YMIN (float): clamped to [-1000.0,1000.0]
    • YMAX (float): clamped to [-1000.0,1000.0]
    • ZMIN (float): clamped to [-1000.0,1000.0]
    • ZMAX (float): clamped to [-1000.0,1000.0]
Type:
readonly dictionary

Type

Constant Constraint dict used by Constraints.append() and for comparison with Constraint.type. Values are TRACKTO, IKSOLVER, FOLLOWPATH, COPYROT, COPYLOC, COPYSIZE, ACTION, LOCKTRACK, STRETCHTO, FLOOR, LIMITLOC, LIMITROT, LIMITSIZE, NULL
Type:
readonly dictionary

Generated by Epydoc 2.1 on Sun Feb 11 13:30:19 2007 http://epydoc.sf.net