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.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 pose 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.propagate(mode='WHILE_HELD', end_frame=250.0)

Copy selected aspects of the current pose to subsequent poses already keyframed

Parameters:

• mode (enum in [‘WHILE_HELD’, ‘NEXT_KEY’, ‘LAST_KEY’, ‘BEFORE_FRAME’, ‘BEFORE_END’, ‘SELECTED_MARKERS’], (optional)) – Terminate Mode, Method used to determine when to stop propagating pose to keyframes
• end_frame (float in [1.17549e-38, inf], (optional)) – End Frame, Frame to stop propagating frames to (for ‘Before Frame’ mode)

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.