IKArmature - BETA ActionScript® 3 (AS3 Flash) Reference for the Adobe® Flash® Platform API Reference

(Beta)

Package	fl.ik
Class	public class IKArmature
Inheritance	IKArmature Object

Language Version:

ActionScript 3.0

Product Version:

Flash CS4

Runtime Versions:

Flash Player 10, AIR 1.5

The IKArmature class describes an inverse kinematics (IK) armature. An armature is a collection of segments, called "bones", which are connected to one another at "joints". An armature is often described as a tree-like or chain-like structure. Armatures can take advantage of the spring and damping features of the dynamic physics engine via the springsEnabled property.

Because armatures can be created only in the Flash authoring tool, you should not use the IKArmature class's constructor to create instances of this class. Flash Player creates all instances of the IKArmature class when a SWF file starts running. You can create a reference to an armature by using the getArmatureAt() or the getArmatureByName() methods in the IKManager class.

Note: If an armature is not in the first frame of a scene, use the registerElements() method to initialize the armature for a specific DisplayObject.

More examples

Animating IK Armatures Overview

Related API Elements

fl.ik.IKManager.getArmatureAt()
fl.ik.IKManager.getArmatureByName()

Public Properties

Hide Inherited Public Properties

Show Inherited Public Properties

	Property		Defined By
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		container : DisplayObjectContainer [read-only] Returns DisplayObjectContainer passed into call to registerElements.	IKArmature
		name : String [read-only] The name of the armature.	IKArmature
		rootJoint : IKJoint [read-only] The root joint in the armature.	IKArmature
		springsEnabled : Boolean Specifies whether springs are enabled for an armature.	IKArmature

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		getBoneByName(targetName:String):IKBone Returns the specified bone.	IKArmature
		hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined.	Object
		isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.	Object
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		registerElements(container:DisplayObjectContainer):* Activates inverse kinematic (IK) movement for a library symbol instance that contains an armature.	IKArmature
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations.	Object
		toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions.	Object
		toString():String Returns the string representation of the specified object.	Object
		valueOf():Object Returns the primitive value of the specified object.	Object

Property Detail

container

property

container:DisplayObjectContainer [read-only]

Language Version:

ActionScript 3.0

Runtime Versions:

Flash Player 10, AIR 1.5

Returns DisplayObjectContainer passed into call to registerElements.

Implementation
public function get container():DisplayObjectContainer

springsEnabled

property

springsEnabled:Boolean

Language Version:

ActionScript 3.0

Runtime Versions:

Flash Player 10.1, AIR 1.5

Specifies whether springs are enabled for an armature. When this value is true, the armature can take advantage of the new dynamic physics engine, which adds spring and damping to animation. The default value is true.

Copy

         myArmature:IKArmature = fl.ik.IKManager.getArmatureAt(0);
         myArmature.springsEnabled = true; // turns springs on

Implementation
public function get springsEnabled():Boolean
public function set springsEnabled(value:Boolean):void

Method Detail

registerElements

()

method

public function registerElements(container:DisplayObjectContainer):*

Language Version:

ActionScript 3.0

Product Version:

Flash CS4

Runtime Versions:

Flash Player 10, AIR 1.5

Activates inverse kinematic (IK) movement for a library symbol instance that contains an armature. A library MovieClip that contains an armature and is instantiated at run time must call this method in order to activate run time inverse kinematic effects.

Note: This method must be called if the armature is not in the first frame of the first scene.

Parameters

container:DisplayObjectContainer — A reference to the stage, accessible through the stage property of any DisplayObject that is currently on the display list.

Returns

*

Example ( How to use this example )

The following example shows how to activate inverse kinematic movement to a library symbol that is instantiated at run time. The library symbol is a MovieClip named "IKPerson" that contains an armature.

         import fl.ik.*;
         // Add a Library Symbol named "IKPerson"
         // that contains an armature.
         // The symbol must be marked "Export for ActionScript"
         var myPerson:IKPerson = new IKPerson();
         
         // add MovieClip to display list
         addChild(myPerson);
         
         // The IKPerson MovieClip contains an IK Armature with the name
         // "Armature_Person" and marked as Runtime Armature instead of Authortime Armature
         var myArmature:IKArmature = IKManager.getArmatureByName("Armature_Person");
         
         // Allow armature to perform inverse kinematic
         // movement at run time
         myArmature.registerElements(stage);
         
         // Allow user to track armature and perform
         // IK movement with the mouse
         IKManager.trackIKArmature(myArmature, true);

Copy

The following example shows how to use the registerElements() method to initialize an armature that is not in the first frame of a scene. To initialize an armature, attach the following code to the first frame containing the armature:

         import fl.ik.*;
         var arm:IKArmature = IKManager.getArmatureAt(0);
         arm.registerElements(stage);

Copy

[an error occurred while processing this directive]

Legal Notices | Online Privacy Policy

IKArmature - AS3 Flash

Package fl.ik

container

name

rootJoint

springsEnabled

getBoneByName

registerElements