Pose Operators

bpy.ops.pose.armature_apply()

Apply the current pose as the new rest pose

bpy.ops.pose.armature_layers(layers=(False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False))

Change the visible armature layers

Parameters:layers (boolean array of 32 items, (optional)) – Layer, Armature layers to make visible
bpy.ops.pose.autoside_names(axis='XAXIS')

Automatically renames the selected bones according to which side of the target axis they fall on

Parameters:axis (enum in [‘XAXIS’, ‘YAXIS’, ‘ZAXIS’], (optional)) – Axis, Axis tag names with.
bpy.ops.pose.bone_layers(layers=(False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False))

Change the layers that the selected bones belong to

Parameters:layers (boolean array of 32 items, (optional)) – Layer, Armature layers that bone belongs to
bpy.ops.pose.breakdown(prev_frame=0, next_frame=0, percentage=0.5)

Create a suitable breakdown pose on the current frame

Parameters:
  • prev_frame (int in [-300000, 300000], (optional)) – Previous Keyframe, Frame number of keyframe immediately before the current frame.
  • next_frame (int in [-300000, 300000], (optional)) – Next Keyframe, Frame number of keyframe immediately after the current frame.
  • percentage (float in [0, 1], (optional)) – Percentage, Weighting factor for the sliding operation
bpy.ops.pose.constraint_add(type='')

Add a constraint to the active bone

Parameters:type (enum in [‘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’], (optional)) – Type
bpy.ops.pose.constraint_add_with_targets(type='')

Add a constraint to the active bone, with target (where applicable) set to the selected Objects/Bones

Parameters:type (enum in [‘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’], (optional)) – Type
bpy.ops.pose.constraints_clear()

Clear all the constraints for the selected bones

bpy.ops.pose.constraints_copy()

Copy constraints to other selected bones.

bpy.ops.pose.copy()

Copies the current pose of the selected bones to copy/paste buffer

bpy.ops.pose.flags_set(type='DRAWWIRE', mode='CLEAR')

Set flags for armature bones

Parameters:
  • type (enum in [‘DRAWWIRE’, ‘DEFORM’, ‘MULT_VG’, ‘HINGE’, ‘NO_SCALE’, ‘LOCKED’], (optional)) – Type
  • mode (enum in [‘CLEAR’, ‘ENABLE’, ‘TOGGLE’], (optional)) – Mode
bpy.ops.pose.flip_names()

Flips (and corrects) the axis suffixes of the the names of selected bones

bpy.ops.pose.group_add()

Add a new bone group

bpy.ops.pose.group_assign(type=0)

Add selected bones to the chosen bone group

Parameters:type (int in [0, 10], (optional)) – Bone Group Index
bpy.ops.pose.group_deselect()

Deselect bones of active Bone Group

bpy.ops.pose.group_remove()

Removes the active bone group

bpy.ops.pose.group_select()

Select bones in active Bone Group

bpy.ops.pose.group_unassign()

Remove selected bones from all bone groups

bpy.ops.pose.hide(unselected=False)

Tag selected bones to not be visible in Pose Mode

Parameters:unselected (boolean, (optional)) – Unselected
bpy.ops.pose.ik_add(with_targets=True)

Add IK Constraint to the active Bone

Parameters:with_targets (boolean, (optional)) – With Targets, Assign IK Constraint with targets derived from the select bones/objects
bpy.ops.pose.ik_clear()

Remove all IK Constraints from selected bones

bpy.ops.pose.loc_clear()

Reset locations of selected bones to their default values

bpy.ops.pose.paste(flipped=False, selected_mask=False)

Pastes the stored pose on to the current pose

Parameters:
  • flipped (boolean, (optional)) – Flipped on X-Axis, Paste the stored pose flipped on to current pose
  • selected_mask (boolean, (optional)) – On Selected Only, Only paste the stored post on to selected bones in the current pose
bpy.ops.pose.paths_calculate()

Calculate paths for the selected bones

bpy.ops.pose.paths_clear()

Clear path caches for selected bones

bpy.ops.pose.push(prev_frame=0, next_frame=0, percentage=0.5)

Exaggerate the current pose

Parameters:
  • prev_frame (int in [-300000, 300000], (optional)) – Previous Keyframe, Frame number of keyframe immediately before the current frame.
  • next_frame (int in [-300000, 300000], (optional)) – Next Keyframe, Frame number of keyframe immediately after the current frame.
  • percentage (float in [0, 1], (optional)) – Percentage, Weighting factor for the sliding operation
bpy.ops.pose.quaternions_flip()

Flip quaternion values to achieve desired rotations, while maintaining the same orientations

bpy.ops.pose.relax(prev_frame=0, next_frame=0, percentage=0.5)

Make the current pose more similar to its surrounding ones

Parameters:
  • prev_frame (int in [-300000, 300000], (optional)) – Previous Keyframe, Frame number of keyframe immediately before the current frame.
  • next_frame (int in [-300000, 300000], (optional)) – Next Keyframe, Frame number of keyframe immediately after the current frame.
  • percentage (float in [0, 1], (optional)) – Percentage, Weighting factor for the sliding operation
bpy.ops.pose.reveal()

Unhide all bones that have been tagged to be hidden in Pose Mode

bpy.ops.pose.rot_clear()

Reset rotations of selected bones to their default values

bpy.ops.pose.scale_clear()

Reset scaling of selected bones to their default values

bpy.ops.pose.select_all(action='TOGGLE')

Toggle selection status of all bones

Parameters:action (enum in [‘TOGGLE’, ‘SELECT’, ‘DESELECT’, ‘INVERT’], (optional)) – Action, Selection action to execute
bpy.ops.pose.select_constraint_target()

Select bones used as targets for the currently selected bones

bpy.ops.pose.select_flip_active()

Activate the bone with a flipped name.

bpy.ops.pose.select_grouped(extend=False, type='LAYER')

Select all visible bones grouped by similar properties

Parameters:
  • extend (boolean, (optional)) – Extend, Extend selection instead of deselecting everything first.
  • type (enum in [‘LAYER’, ‘GROUP’], (optional)) – Type
bpy.ops.pose.select_hierarchy(direction='PARENT', extend=False)

Select immediate parent/children of selected bones

Parameters:
  • direction (enum in [‘PARENT’, ‘CHILD’], (optional)) – Direction
  • extend (boolean, (optional)) – Add to Selection
bpy.ops.pose.select_inverse()

Flip the selection status of bones (selected -> unselected, unselected -> selected)

bpy.ops.pose.select_linked(extend=False)

Select bones related to selected ones by parent/child relationships

Parameters:extend (boolean, (optional)) – Extend, Extend selection instead of deselecting everything first.
bpy.ops.pose.select_parent()

Select bones that are parents of the currently selected bones

bpy.ops.pose.transforms_clear()

Reset location, rotation, and scaling of selected bones to their default values

bpy.ops.pose.visual_transform_apply()

Apply final constrained position of pose bones to their transform.

Previous topic

Particle Operators

Next topic

Poselib Operators