BoneCollections(bpy_struct)

base class — bpy_struct

class bpy.types.BoneCollections(bpy_struct)

The Bone Collections of this Armature

active

Armature’s active bone collection

Type:

BoneCollection

active_index

The index of the Armature’s active bone collection; -1 when there is no active collection. Note that this is indexing the underlying array of bone collections, which may not be in the order you expect. Root collections are listed first, and siblings are always sequential. Apart from that, bone collections can be in any order, and thus incrementing or decrementing this index can make the active bone collection jump around in unexpected ways. For a more predictable interface, use active or active_name.

Type:

int in [-inf, inf], default 0

active_name

The name of the Armature’s active bone collection; empty when there is no active collection

Type:

string, default “”, (never None)

is_solo_active

Read-only flag that indicates there is at least one bone collection marked as ‘solo’

Type:

boolean, default False, (readonly)

new(name, *, parent=None)

Add a new empty bone collection to the armature

Parameters:

  • name (string, (never None)) – Name, Name of the new collection. Blender will ensure it is unique within the collections of the Armature.

  • parent (BoneCollection, (optional)) – Parent Collection, If not None, the new bone collection becomes a child of this collection

Returns:

Newly created bone collection

Return type:

BoneCollection

remove(bone_collection)

Remove the bone collection from the armature. If this bone collection has any children, they will be reassigned to their grandparent; in other words, the children will take the place of the removed bone collection.

Parameters:

bone_collection (BoneCollection) – Bone Collection, The bone collection to remove

move(from_index, to_index)

Move a bone collection to a different position in the collection list. This can only be used to reorder siblings, and not to change parent-child relationships.

Parameters:

  • from_index (int in [-inf, inf]) – From Index, Index to move

  • to_index (int in [-inf, inf]) – To Index, Target index

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:

id (str) – 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 (str) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References