Armature¶

Quick Reference¶

Hotkey	Operator
`Ctrl-A`	`bpy.ops.armature.select_all()`
`Ctrl-Alt-SELECTMOUSE`	`bpy.ops.armature.click_extrude()`
`X`	`bpy.ops.sketch.delete()`
`DEL`	`bpy.ops.sketch.delete()`
`RIGHTMOUSE`	`bpy.ops.sketch.finish_stroke()`
`ESC`	`bpy.ops.sketch.cancel_stroke()`
`Shift-LEFTMOUSE`	`bpy.ops.sketch.gesture()`
`LEFTMOUSE`	`bpy.ops.sketch.draw_stroke()`
`Ctrl-LEFTMOUSE`	`bpy.ops.sketch.draw_stroke()`
`MOUSEMOVE`	`bpy.ops.sketch.draw_preview()`
`Ctrl-MOUSEMOVE`	`bpy.ops.sketch.draw_preview()`
`H`	`bpy.ops.armature.hide()`
`Shift-H`	`bpy.ops.armature.hide()`
`Alt-H`	`bpy.ops.armature.reveal()`
`Ctrl-Alt-A`	`bpy.ops.armature.align()`
`Ctrl-N`	`bpy.ops.armature.calculate_roll()`
`Alt-R`	`bpy.ops.armature.roll_clear()`
`Alt-F`	`bpy.ops.armature.switch_direction()`
`Shift-A`	`bpy.ops.armature.bone_primitive_add()`
`Ctrl-P`	`bpy.ops.armature.parent_set()`
`Alt-P`	`bpy.ops.armature.parent_clear()`
`A`	`bpy.ops.armature.select_all()`
`Ctrl-I`	`bpy.ops.armature.select_all()`
`Ctrl-Shift-M`	`bpy.ops.armature.select_mirror()`
`LEFT_BRACKET`	`bpy.ops.armature.select_hierarchy()`
`Shift-LEFT_BRACKET`	`bpy.ops.armature.select_hierarchy()`
`RIGHT_BRACKET`	`bpy.ops.armature.select_hierarchy()`
`Shift-RIGHT_BRACKET`	`bpy.ops.armature.select_hierarchy()`
`Ctrl-NUMPAD_PLUS`	`bpy.ops.armature.select_more()`
`Ctrl-NUMPAD_MINUS`	`bpy.ops.armature.select_less()`
`Shift-G`	`bpy.ops.armature.select_similar()`
`L`	`bpy.ops.armature.select_linked()`
`Ctrl-SELECTMOUSE`	`bpy.ops.armature.shortest_path_pick()`
`X`	`bpy.ops.wm.call_menu()`
`DEL`	`bpy.ops.wm.call_menu()`
`Ctrl-X`	`bpy.ops.armature.dissolve()`
`Shift-D`	`bpy.ops.armature.duplicate_move()`
`E`	`bpy.ops.armature.extrude_move()`
`Shift-E`	`bpy.ops.armature.extrude_forked()`
`Ctrl-ACTIONMOUSE`	`bpy.ops.armature.click_extrude()`
`F`	`bpy.ops.armature.fill()`
`Alt-M`	`bpy.ops.armature.merge()`
`Y`	`bpy.ops.armature.split()`
`P`	`bpy.ops.armature.separate()`
`Shift-W`	`bpy.ops.wm.call_menu()`
`Ctrl-Shift-W`	`bpy.ops.wm.call_menu()`
`Alt-W`	`bpy.ops.wm.call_menu()`
`Ctrl-ACCENT_GRAVE`	`bpy.ops.armature.layers_show_all()`
`Shift-M`	`bpy.ops.armature.armature_layers()`
`M`	`bpy.ops.armature.bone_layers()`
`Ctrl-Alt-S`	`bpy.ops.transform.transform()`
`Alt-S`	`bpy.ops.transform.transform()`
`Ctrl-R`	`bpy.ops.transform.transform()`
`W`	`bpy.ops.wm.call_menu()`

Detailed Reference¶

Note

Hotkeys marked with the “(default)” prefix are inherited from the default blender keymap

Ctrl-A → armature.select_all : KEYBOARD → PRESS¶

(De)select All

bpy.ops.armature.select_all(action=’TOGGLE’)

Properties:	Values:
Action	TOGGLE

Ctrl-Alt-SELECTMOUSE → armature.click_extrude : MOUSE → PRESS¶

Click-Extrude

bpy.ops.armature.click_extrude()

(default) X → sketch.delete : KEYBOARD → PRESS¶

Delete

bpy.ops.sketch.delete()

(default) DEL → sketch.delete : KEYBOARD → PRESS¶

Delete

bpy.ops.sketch.delete()

(default) RIGHTMOUSE → sketch.finish_stroke : MOUSE → PRESS¶

End Stroke

bpy.ops.sketch.finish_stroke()

(default) ESC → sketch.cancel_stroke : KEYBOARD → PRESS¶

Cancel Stroke

bpy.ops.sketch.cancel_stroke()

(default) Shift-LEFTMOUSE → sketch.gesture : MOUSE → PRESS¶

Gesture

bpy.ops.sketch.gesture(snap=False)

(default) LEFTMOUSE → sketch.draw_stroke : MOUSE → PRESS¶

Draw Stroke

bpy.ops.sketch.draw_stroke(snap=False)

(default) Ctrl-LEFTMOUSE → sketch.draw_stroke : MOUSE → PRESS¶

Draw Stroke

bpy.ops.sketch.draw_stroke(snap=False)

Properties:	Values:
Snap	True

(default) MOUSEMOVE → sketch.draw_preview : MOUSE → ANY¶

Draw Preview

bpy.ops.sketch.draw_preview(snap=False)

(default) Ctrl-MOUSEMOVE → sketch.draw_preview : MOUSE → ANY¶

Draw Preview

bpy.ops.sketch.draw_preview(snap=False)

Properties:	Values:
Snap	True

(default) H → armature.hide : KEYBOARD → PRESS¶

Hide Selected Bones

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

Properties:	Values:
Unselected	False

(default) Shift-H → armature.hide : KEYBOARD → PRESS¶

Hide Selected Bones

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

Properties:	Values:
Unselected	True

(default) Alt-H → armature.reveal : KEYBOARD → PRESS¶

Reveal Bones

bpy.ops.armature.reveal()

(default) Ctrl-Alt-A → armature.align : KEYBOARD → PRESS¶

Align Bones

bpy.ops.armature.align()

(default) Ctrl-N → armature.calculate_roll : KEYBOARD → PRESS¶

Recalculate Roll

bpy.ops.armature.calculate_roll(type=’POS_X’, axis_flip=False, axis_only=False)

(default) Alt-R → armature.roll_clear : KEYBOARD → PRESS¶

Clear Roll

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

(default) Alt-F → armature.switch_direction : KEYBOARD → PRESS¶

Switch Direction

bpy.ops.armature.switch_direction()

(default) Shift-A → armature.bone_primitive_add : KEYBOARD → PRESS¶

Add Bone

bpy.ops.armature.bone_primitive_add(name=”Bone”)

(default) Ctrl-P → armature.parent_set : KEYBOARD → PRESS¶

Make Parent

bpy.ops.armature.parent_set(type=’CONNECTED’)

(default) Alt-P → armature.parent_clear : KEYBOARD → PRESS¶

Clear Parent

bpy.ops.armature.parent_clear(type=’CLEAR’)

(default) A → armature.select_all : KEYBOARD → PRESS¶

(De)select All

bpy.ops.armature.select_all(action=’TOGGLE’)

Properties:	Values:
Action	TOGGLE

(default) Ctrl-I → armature.select_all : KEYBOARD → PRESS¶

(De)select All

bpy.ops.armature.select_all(action=’TOGGLE’)

Properties:	Values:
Action	INVERT

(default) Ctrl-Shift-M → armature.select_mirror : KEYBOARD → PRESS¶

Flip Active/Selected Bone

bpy.ops.armature.select_mirror(only_active=False, extend=False)

Properties:	Values:
Extend	False

(default) LEFT_BRACKET → armature.select_hierarchy : KEYBOARD → PRESS¶

Select Hierarchy

bpy.ops.armature.select_hierarchy(direction=’PARENT’, extend=False)

Properties:	Values:
Direction	PARENT
Extend	False

(default) Shift-LEFT_BRACKET → armature.select_hierarchy : KEYBOARD → PRESS¶

Select Hierarchy

bpy.ops.armature.select_hierarchy(direction=’PARENT’, extend=False)

Properties:	Values:
Direction	PARENT
Extend	True

(default) RIGHT_BRACKET → armature.select_hierarchy : KEYBOARD → PRESS¶

Select Hierarchy

bpy.ops.armature.select_hierarchy(direction=’PARENT’, extend=False)

Properties:	Values:
Direction	CHILD
Extend	False

(default) Shift-RIGHT_BRACKET → armature.select_hierarchy : KEYBOARD → PRESS¶

Select Hierarchy

bpy.ops.armature.select_hierarchy(direction=’PARENT’, extend=False)

Properties:	Values:
Direction	CHILD
Extend	True

(default) Ctrl-NUMPAD_PLUS → armature.select_more : KEYBOARD → PRESS¶

Select More

bpy.ops.armature.select_more()

(default) Ctrl-NUMPAD_MINUS → armature.select_less : KEYBOARD → PRESS¶

Select Less

bpy.ops.armature.select_less()

(default) Shift-G → armature.select_similar : KEYBOARD → PRESS¶

Select Similar

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

(default) L → armature.select_linked : KEYBOARD → PRESS¶

Select Connected

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

(default) Ctrl-SELECTMOUSE → armature.shortest_path_pick : MOUSE → PRESS¶

Pick Shortest Path

bpy.ops.armature.shortest_path_pick()

(default) X → wm.call_menu : KEYBOARD → PRESS¶

Call Menu

bpy.ops.wm.call_menu(name=””)

Properties:	Values:
Name	VIEW3D_MT_edit_armature_delete

(default) DEL → wm.call_menu : KEYBOARD → PRESS¶

Call Menu

bpy.ops.wm.call_menu(name=””)

Properties:	Values:
Name	VIEW3D_MT_edit_armature_delete

(default) Ctrl-X → armature.dissolve : KEYBOARD → PRESS¶

Dissolve Selected Bone(s)

bpy.ops.armature.dissolve()

(default) Shift-D → armature.duplicate_move : KEYBOARD → PRESS¶

Duplicate

bpy.ops.armature.duplicate_move(ARMATURE_OT_duplicate={}, TRANSFORM_OT_translate={“value”:(0, 0, 0), “constraint_axis”:(False, False, False), “constraint_orientation”:’GLOBAL’, “mirror”:False, “proportional”:’DISABLED’, “proportional_edit_falloff”:’SMOOTH’, “proportional_size”:1, “snap”:False, “snap_target”:’CLOSEST’, “snap_point”:(0, 0, 0), “snap_align”:False, “snap_normal”:(0, 0, 0), “gpencil_strokes”:False, “texture_space”:False, “remove_on_cancel”:False, “release_confirm”:False})

Properties:	Values:
Duplicate Selected Bone(s)	N/A
Translate	N/A

(default) E → armature.extrude_move : KEYBOARD → PRESS¶

Extrude

bpy.ops.armature.extrude_move(ARMATURE_OT_extrude={“forked”:False}, TRANSFORM_OT_translate={“value”:(0, 0, 0), “constraint_axis”:(False, False, False), “constraint_orientation”:’GLOBAL’, “mirror”:False, “proportional”:’DISABLED’, “proportional_edit_falloff”:’SMOOTH’, “proportional_size”:1, “snap”:False, “snap_target”:’CLOSEST’, “snap_point”:(0, 0, 0), “snap_align”:False, “snap_normal”:(0, 0, 0), “gpencil_strokes”:False, “texture_space”:False, “remove_on_cancel”:False, “release_confirm”:False})

Properties:	Values:
Extrude	N/A
Translate	N/A

(default) Shift-E → armature.extrude_forked : KEYBOARD → PRESS¶

Extrude Forked

bpy.ops.armature.extrude_forked(ARMATURE_OT_extrude={“forked”:False}, TRANSFORM_OT_translate={“value”:(0, 0, 0), “constraint_axis”:(False, False, False), “constraint_orientation”:’GLOBAL’, “mirror”:False, “proportional”:’DISABLED’, “proportional_edit_falloff”:’SMOOTH’, “proportional_size”:1, “snap”:False, “snap_target”:’CLOSEST’, “snap_point”:(0, 0, 0), “snap_align”:False, “snap_normal”:(0, 0, 0), “gpencil_strokes”:False, “texture_space”:False, “remove_on_cancel”:False, “release_confirm”:False})

Properties:	Values:
Extrude	N/A
Translate	N/A

(default) Ctrl-ACTIONMOUSE → armature.click_extrude : MOUSE → CLICK¶

Click-Extrude

bpy.ops.armature.click_extrude()

(default) F → armature.fill : KEYBOARD → PRESS¶

Fill Between Joints

bpy.ops.armature.fill()

(default) Alt-M → armature.merge : KEYBOARD → PRESS¶

Merge Bones

bpy.ops.armature.merge(type=’WITHIN_CHAIN’)

(default) Y → armature.split : KEYBOARD → PRESS¶

Split

bpy.ops.armature.split()

(default) P → armature.separate : KEYBOARD → PRESS¶

Separate Bones

bpy.ops.armature.separate()

(default) Shift-W → wm.call_menu : KEYBOARD → PRESS¶

Call Menu

bpy.ops.wm.call_menu(name=””)

Properties:	Values:
Name	VIEW3D_MT_bone_options_toggle

(default) Ctrl-Shift-W → wm.call_menu : KEYBOARD → PRESS¶

Call Menu

bpy.ops.wm.call_menu(name=””)

Properties:	Values:
Name	VIEW3D_MT_bone_options_enable

(default) Alt-W → wm.call_menu : KEYBOARD → PRESS¶

Call Menu

bpy.ops.wm.call_menu(name=””)

Properties:	Values:
Name	VIEW3D_MT_bone_options_disable

(default) Ctrl-ACCENT_GRAVE → armature.layers_show_all : KEYBOARD → PRESS¶

Show All Layers

bpy.ops.armature.layers_show_all(all=True)

(default) Shift-M → armature.armature_layers : KEYBOARD → PRESS¶

Change Armature Layers

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))

(default) M → armature.bone_layers : KEYBOARD → PRESS¶

Change Bone Layers

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))

(default) Ctrl-Alt-S → transform.transform : KEYBOARD → PRESS¶

Transform

bpy.ops.transform.transform(mode=’TRANSLATION’, value=(0, 0, 0, 0), axis=(0, 0, 0), constraint_axis=(False, False, False), constraint_orientation=’GLOBAL’, mirror=False, proportional=’DISABLED’, proportional_edit_falloff=’SMOOTH’, proportional_size=1, snap=False, snap_target=’CLOSEST’, snap_point=(0, 0, 0), snap_align=False, snap_normal=(0, 0, 0), gpencil_strokes=False, release_confirm=False)

Properties:	Values:
Mode	BONE_SIZE

(default) Alt-S → transform.transform : KEYBOARD → PRESS¶

Transform

bpy.ops.transform.transform(mode=’TRANSLATION’, value=(0, 0, 0, 0), axis=(0, 0, 0), constraint_axis=(False, False, False), constraint_orientation=’GLOBAL’, mirror=False, proportional=’DISABLED’, proportional_edit_falloff=’SMOOTH’, proportional_size=1, snap=False, snap_target=’CLOSEST’, snap_point=(0, 0, 0), snap_align=False, snap_normal=(0, 0, 0), gpencil_strokes=False, release_confirm=False)

Properties:	Values:
Mode	BONE_ENVELOPE

(default) Ctrl-R → transform.transform : KEYBOARD → PRESS¶

Transform

bpy.ops.transform.transform(mode=’TRANSLATION’, value=(0, 0, 0, 0), axis=(0, 0, 0), constraint_axis=(False, False, False), constraint_orientation=’GLOBAL’, mirror=False, proportional=’DISABLED’, proportional_edit_falloff=’SMOOTH’, proportional_size=1, snap=False, snap_target=’CLOSEST’, snap_point=(0, 0, 0), snap_align=False, snap_normal=(0, 0, 0), gpencil_strokes=False, release_confirm=False)

Properties:	Values:
Mode	BONE_ROLL

(default) W → wm.call_menu : KEYBOARD → PRESS¶

Call Menu

bpy.ops.wm.call_menu(name=””)

Properties:	Values:
Name	VIEW3D_MT_armature_specials