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)

axes_position

The position for the axes on the bone. Increasing the value moves it closer to the tip; decreasing moves it closer to the root

Type

float in [0, 1], default 0.0

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 (True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True, True)

layers_protected

Protected layers in overridden instances are restored to their original 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’

relation_line_position

The start position of the relation lines from parent to child bones

  • TAIL Tail – Draw the relationship line from the parent tail to the child head.

  • HEAD Head – Draw the relationship line from the parent head to the child head.

Type

enum in [‘TAIL’, ‘HEAD’], default ‘TAIL’

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 True

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 (mathutils.Matrix 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