Armature Operators

bpy.ops.armature.align()

Align selected bones to the active bone (or to their parent)

bpy.ops.armature.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.armature.autoside_names(type='XAXIS')

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

Parameters:type (enum in ['XAXIS', 'YAXIS', 'ZAXIS'], (optional)) –

Axis, Axis tag names with

  • XAXIS X-Axis, Left/Right.
  • YAXIS Y-Axis, Front/Back.
  • ZAXIS Z-Axis, Top/Bottom.
bpy.ops.armature.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.armature.bone_primitive_add(name="Bone")

Add a new bone located at the 3D-Cursor

Parameters:name (string, (optional, never None)) – Name, Name of the newly created bone
bpy.ops.armature.calculate_roll(type='POS_X', axis_flip=False, axis_only=False)

Automatically fix alignment of select bones’ axes

Parameters:
  • type (enum in ['POS_X', 'POS_Z', 'GLOBAL_POS_X', 'GLOBAL_POS_Y', 'GLOBAL_POS_Z', 'NEG_X', 'NEG_Z', 'GLOBAL_NEG_X', 'GLOBAL_NEG_Y', 'GLOBAL_NEG_Z', 'ACTIVE', 'VIEW', 'CURSOR'], (optional)) – Type
  • axis_flip (boolean, (optional)) – Flip Axis, Negate the alignment axis
  • axis_only (boolean, (optional)) – Shortest Rotation, Ignore the axis direction, use the shortest rotation to align
bpy.ops.armature.click_extrude()

Create a new bone going from the last selected joint to the mouse position

bpy.ops.armature.delete()

Remove selected bones from the armature

bpy.ops.armature.dissolve()

Dissolve selected bones from the armature

bpy.ops.armature.duplicate()

Make copies of the selected bones within the same armature

bpy.ops.armature.duplicate_move(ARMATURE_OT_duplicate=None, TRANSFORM_OT_translate=None)

Make copies of the selected bones within the same armature and move them

Parameters:
  • ARMATURE_OT_duplicate (ARMATURE_OT_duplicate, (optional)) – Duplicate Selected Bone(s), Make copies of the selected bones within the same armature
  • TRANSFORM_OT_translate (TRANSFORM_OT_translate, (optional)) – Translate, Translate (move) selected items
bpy.ops.armature.extrude(forked=False)

Create new bones from the selected joints

Parameters:forked (boolean, (optional)) – Forked
bpy.ops.armature.extrude_forked(ARMATURE_OT_extrude=None, TRANSFORM_OT_translate=None)

Create new bones from the selected joints and move them

Parameters:
  • ARMATURE_OT_extrude (ARMATURE_OT_extrude, (optional)) – Extrude, Create new bones from the selected joints
  • TRANSFORM_OT_translate (TRANSFORM_OT_translate, (optional)) – Translate, Translate (move) selected items
bpy.ops.armature.extrude_move(ARMATURE_OT_extrude=None, TRANSFORM_OT_translate=None)

Create new bones from the selected joints and move them

Parameters:
  • ARMATURE_OT_extrude (ARMATURE_OT_extrude, (optional)) – Extrude, Create new bones from the selected joints
  • TRANSFORM_OT_translate (TRANSFORM_OT_translate, (optional)) – Translate, Translate (move) selected items
bpy.ops.armature.fill()

Add bone between selected joint(s) and/or 3D-Cursor

bpy.ops.armature.flip_names()

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

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

Tag selected bones to not be visible in Edit Mode

Parameters:unselected (boolean, (optional)) – Unselected, Hide unselected rather than selected
bpy.ops.armature.layers_show_all(all=True)

Make all armature layers visible

Parameters:all (boolean, (optional)) – All Layers, Enable all layers or just the first 16 (top row)
bpy.ops.armature.merge(type='WITHIN_CHAIN')

Merge continuous chains of selected bones

Parameters:type (enum in ['WITHIN_CHAIN'], (optional)) – Type
bpy.ops.armature.parent_clear(type='CLEAR')

Remove the parent-child relationship between selected bones and their parents

Parameters:type (enum in ['CLEAR', 'DISCONNECT'], (optional)) – ClearType, What way to clear parenting
bpy.ops.armature.parent_set(type='CONNECTED')

Set the active bone as the parent of the selected bones

Parameters:type (enum in ['CONNECTED', 'OFFSET'], (optional)) – ParentType, Type of parenting
bpy.ops.armature.reveal()

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

bpy.ops.armature.roll_clear(roll=0.0)

Clear roll for selected bones

Parameters:roll (float in [-6.28319, 6.28319], (optional)) – Roll
bpy.ops.armature.select_all(action='TOGGLE')

Toggle selection status of all bones

Parameters:action (enum in ['TOGGLE', 'SELECT', 'DESELECT', 'INVERT'], (optional)) –

Action, Selection action to execute

  • TOGGLE Toggle, Toggle selection for all elements.
  • SELECT Select, Select all elements.
  • DESELECT Deselect, Deselect all elements.
  • INVERT Invert, Invert selection of all elements.
bpy.ops.armature.select_hierarchy(direction='PARENT', extend=False)

Select immediate parent/children of selected bones

Parameters:
  • direction (enum in ['PARENT', 'CHILD'], (optional)) – Direction
  • extend (boolean, (optional)) – Extend, Extend the selection
bpy.ops.armature.select_less()

Deselect those bones at the boundary of each selection region

bpy.ops.armature.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.armature.select_mirror(only_active=False, extend=False)

Mirror the bone selection

Parameters:
  • only_active (boolean, (optional)) – Active Only, Only operate on the active bone
  • extend (boolean, (optional)) – Extend, Extend the selection
bpy.ops.armature.select_more()

Select those bones connected to the initial selection

bpy.ops.armature.select_similar(type='LENGTH', threshold=0.1)

Select similar bones by property types

Parameters:
  • type (enum in ['CHILDREN', 'CHILDREN_IMMEDIATE', 'SIBLINGS', 'LENGTH', 'DIRECTION', 'PREFIX', 'SUFFIX', 'LAYER'], (optional)) – Type
  • threshold (float in [0, 1], (optional)) – Threshold
bpy.ops.armature.separate()

Isolate selected bones into a separate armature

bpy.ops.armature.shortest_path_pick()

Select shortest path between two bones

bpy.ops.armature.split()

Split off selected bones from connected unselected bones

bpy.ops.armature.subdivide(number_cuts=1)

Break selected bones into chains of smaller bones

Parameters:number_cuts (int in [1, 1000], (optional)) – Number of Cuts
bpy.ops.armature.switch_direction()

Change the direction that a chain of bones points in (head <-> tail swap)

bpy.ops.armature.symmetrize(direction='NEGATIVE_X')

Enforce symmetry, make copies of the selection or use existing

Parameters:direction (enum in ['NEGATIVE_X', 'POSITIVE_X'], (optional)) – Direction, Which sides to copy from and to (when both are selected)