Home       Trees       Index       Help   

Blender

Module Armature :: Class Armature
[frames | no frames]

Class Armature

The Armature object

This object gives access to Armature-specific data in Blender.
Method Summary
Armature Object __init__(name)
Initializer for the Armature TypeObject.
None makeEditable()
Put the armature into EditMode for editing purposes.
None update()
Save all changes and update the armature.

Instance Variable Summary
Bool autoIK: Adds temporary IK chains while grabbing bones
BonesDict Object bones: A Dictionary of Bones (BonesDict) that make up this armature.
Bool delayDeform: Don't deform children when manipulating bones
Bool drawAxes: Draw bone axes
Bool drawNames: Draw bone names
Constant Object drawType: The drawing type that is used to display the armature Acceptable values are:
Bool envelopes: Whether bone envelopes define deformation
bool fakeUser: The fake user status.
Bool ghost: Draw ghosts around frame for current Action
Int ghostStep: Number of frames between ghosts
Bool mirrorEdit: X-axis mirrored editing
String name: The Armature name.
Bool restPosition: Show rest position (no posing possible)
int users: The number of users of the armature.
Bool vertexGroups: Whether vertex groups define deformation

Method Details

__init__(name='myArmature')
(Constructor)

Initializer for the Armature TypeObject. Example: 
   myNewArmature = Blender.Armature.Armature('AR_1')
Parameters:
name - The name for the new armature
           (type=string)
Returns:
New Armature Object
           (type=Armature Object)

makeEditable()

Put the armature into EditMode for editing purposes. (Enters Editmode)
Returns:
None

Warnings:

  • Using Window.Editmode() to switch the editmode manually will cause problems and possibly even crash Blender.
  • This is only needed for operations such as adding and removing bones.
  • Do access pose data until you have called update() or settings will be lost.
  • The armature should not be in manual editmode prior to calling this method. The armature must be parented to an object prior to editing.

update()

Save all changes and update the armature. (Leaves Editmode)
Returns:
None

Note: Must have called makeEditable() first.


Instance Variable Details

autoIK

Adds temporary IK chains while grabbing bones
Type:
Bool

bones

A Dictionary of Bones (BonesDict) that make up this armature.
Type:
BonesDict Object

delayDeform

Don't deform children when manipulating bones
Type:
Bool

drawAxes

Draw bone axes
Type:
Bool

drawNames

Draw bone names
Type:
Bool

drawType

The drawing type that is used to display the armature Acceptable values are:
  • Armature.OCTAHEDRON: bones drawn as octahedrons
  • Armature.STICK: bones drawn as sticks
  • Armature.BBONE: bones drawn as b-bones
  • Armature.ENVELOPE: bones drawn as sticks with envelopes
Type:
Constant Object

envelopes

Whether bone envelopes define deformation
Type:
Bool

fakeUser

The fake user status. Enabling this will keep it in the blend even if there are no users.
Type:
bool

ghost

Draw ghosts around frame for current Action
Type:
Bool

ghostStep

Number of frames between ghosts
Type:
Int

mirrorEdit

X-axis mirrored editing
Type:
Bool

name

The Armature name.
Type:
String

restPosition

Show rest position (no posing possible)
Type:
Bool

users

The number of users of the armature. Read-only.
Type:
int

vertexGroups

Whether vertex groups define deformation
Type:
Bool

   Home       Trees       Index       Help   

Blender

Generated by Epydoc 2.1 on Sun Feb 11 13:30:19 2007 http://epydoc.sf.net