Package bpy :: Module types :: Class Bone

[frames] | no frames]

Class Bone

The Bone Object

Bone in an Armature datablock.

References

Instance Variables

[hide private]

float in [0, 2]

bbone_in
Length of first Bezier Handle (for B-Bones only).

float in [0, 2]

bbone_out
Length of second Bezier Handle (for B-Bones only).

int in [1, 32]

bbone_segments
Number of subdivisions of bone (for B-Bones only).

Collection of Bone (readonly)

children
Bones which are children of this bone

boolean (readonly)

connected
When bone has a parent, bone's head is struck to the parent's tail.

boolean

cyclic_offset
When bone doesn't have a parent, it receives cyclic offset effects.

boolean

deform
Bone does not deform any geometry.

boolean

draw_wire
Bone is always drawn as Wireframe regardless of viewport draw mode.

float in [0, 1000]

envelope_distance
Bone deformation distance (for Envelope deform only).

float in [0, 1000]

envelope_weight
Bone deformation weight (for Envelope deform only).

float array of 3 items in [-inf, inf]

head
Location of head end of the bone relative to its parent.

float array of 3 items in [-inf, inf]

head_local
Location of head end of the bone relative to armature.

float in [-inf, inf]

head_radius
Radius of head of bone (for Envelope deform only).

boolean

hidden
Bone is not visible when it is not in Edit Mode (i.e.

boolean

hinge
Bone inherits rotation or scale from parent bone.

boolean

inherit_scale
Bone inherits scaling from parent bone.

boolean array of 32 items

layer
Layers bone exists in

boolean

local_location
Bone location is set in local space.

float array of 9 items in [-inf, inf]

matrix
3x3 bone matrix.

float array of 16 items in [-inf, inf]

matrix_local
4x4 bone matrix relative to armature.

boolean

multiply_vertexgroup_with_envelope
When deforming bone, multiply effects of Vertex Group weights with Envelope influence.

string

name
Name (maximum length of 32)

Bone (readonly)

parent
Parent bone (in same Armature).

boolean

restrict_select
Bone is able to be selected

boolean

selected
Selected

float array of 3 items in [-inf, inf]

tail
Location of tail end of the bone.

float array of 3 items in [-inf, inf]

tail_local
Location of tail end of the bone relative to armature.

float in [-inf, inf]

tail_radius
Radius of tail of bone (for Envelope deform only).

Instance Variable Details

[hide private]

draw_wire

Bone is always drawn as Wireframe regardless of viewport draw mode. Useful for non-obstructive custom bone shapes.

Type:: boolean

hidden

Bone is not visible when it is not in Edit Mode (i.e. in Object or Pose Modes).

Type:: boolean