Module Armature

source code

The Blender.Armature submodule.

Armature

This module provides access to Armature objects in Blender. These are "skeletons", used to deform and animate other objects -- meshes, for example.

Example:

 import Blender
 from Blender import Armature
 from Blender.Mathutils import *
 #
 arms = Armature.Get()
 for arm in arms.values():
   arm.drawType = Armature.STICK #set the draw type
   arm.makeEditable() #enter editmode

   #generating new editbone
   eb = Armature.Editbone()
   eb.roll = 10
   eb.parent = arm.bones['Bone.003']
   eb.head = Vector(1,1,1)
   eb.tail = Vector(0,0,1)
   eb.options = [Armature.HINGE, Armature.CONNECTED]

   #add the bone
   arm.bones['myNewBone'] = eb
 
   #delete an old bone
   del arm.bones['Bone.002']

   arm.update()  #save changes

   for bone in arm.bones.values():
     #print bone.matrix['ARMATURESPACE']
     print bone.parent, bone.name
     print bone.children, bone.name
     print bone.options, bone.name

Example:

       # Adds empties for every bone in the selected armature, an example of getting worldspace locations for bones.
       from Blender import *
       def test_arm():
               scn= Scene.GetCurrent()
               arm_ob= scn.objects.active

               if not arm_ob or arm_ob.type != 'Armature':
                       Draw.PupMenu('not an armature object')
                       return

               # Deselect all
               for ob in scn.objects:
                       if ob != arm_ob:
                               ob.sel= 0

               arm_mat= arm_ob.matrixWorld

               arm_data= arm_ob.getData()

               bones= arm_data.bones.values()
               for bone in bones:
                       bone_mat= bone.matrix['ARMATURESPACE']
                       bone_mat_world= bone_mat*arm_mat

                       ob_empty= scn.objects.new('Empty')
                       ob_empty.setMatrix(bone_mat_world)

       test_arm()