Armature(ID)

base classes — bpy_struct, ID

class bpy.types.Armature(ID)

Armature data-block containing a hierarchy of bones, usually used for rigging characters

animation_data

Animation data for this data-block

Type:AnimData, (readonly)
bones
Type:ArmatureBones bpy_prop_collection of Bone, (readonly)
display_type
  • OCTAHEDRAL Octahedral, Display bones as octahedral shape (default).
  • STICK Stick, Display bones as simple 2D lines with dots.
  • BBONE B-Bone, Display bones as boxes, showing subdivision and B-Splines.
  • ENVELOPE Envelope, Display bones as extruded spheres, showing deformation influence volume.
  • WIRE Wire, Display bones as thin wires, showing subdivision and B-Splines.
Type:enum in [‘OCTAHEDRAL’, ‘STICK’, ‘BBONE’, ‘ENVELOPE’, ‘WIRE’], default ‘OCTAHEDRAL’
edit_bones
Type:ArmatureEditBones bpy_prop_collection of EditBone, (readonly)
is_editmode

True when used in editmode

Type:boolean, default False, (readonly)
layers

Armature layer visibility

Type:boolean array of 32 items, default (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)
layers_protected

Protected layers in Proxy Instances are restored to Proxy settings on file reload and undo

Type:boolean array of 32 items, default (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)
pose_position

Show armature in binding pose or final posed state

  • POSE Pose Position, Show armature in posed state.
  • REST Rest Position, Show Armature in binding pose state (no posing possible).
Type:enum in [‘POSE’, ‘REST’], default ‘POSE’
show_axes

Display bone axes

Type:boolean, default False
show_bone_custom_shapes

Display bones with their custom shapes

Type:boolean, default False
show_group_colors

Display bone group colors

Type:boolean, default False
show_names

Display bone names

Type:boolean, default False
use_mirror_x

Apply changes to matching bone on opposite side of X-Axis

Type:boolean, default False
transform(matrix)

Transform armature bones by a matrix

Parameters:matrix (float multi-dimensional array of 4 * 4 items in [-inf, inf]) – Matrix
classmethod bl_rna_get_subclass(id, default=None)
Parameters:id (string) – The RNA type identifier.
Returns:The RNA type or default when not found.
Return type:bpy.types.Struct subclass
classmethod bl_rna_get_subclass_py(id, default=None)
Parameters:id (string) – The RNA type identifier.
Returns:The class or default when not found.
Return type:type

Inherited Properties

Inherited Functions

References