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
- ARMATURE_OT_duplicate (
-
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
- ARMATURE_OT_extrude (
-
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
- ARMATURE_OT_extrude (
-
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)