Language Version: | ActionScript 3.0 |
Product Version: | Flash CS4 |
Runtime Versions: | Flash Player 10, AIR 1.5 |
The IKManager class is a container class that represents all
the inverse kinematics (IK) trees (armatures) defined in a document,
and allows the management of those armatures at run time.
Armatures can be created only in the Flash authoring tool. When you
publish a Flash CS4 document with armatures, the Flash authoring tool stores
an XML representation of the armatures and some generated ActionScript code
in the SWF file. At run time, Flash Player executes the
ActionScript code and parses the XML to recreate the armatures.
You do not need to create an instance of the IKManager class;
the runtime creates an instance of this class automatically.
Additionally, all of the properties and methods of the IKManager class are
static; you do not need to refer to an instance of the IKManager class.
numArmatures:int
[read-only]
Language Version: | ActionScript 3.0 |
Product Version: | Flash CS4 |
Runtime Versions: | Flash Player 10, AIR 1.5 |
The number of armatures on the stage.
If the SWF file subsequently loads other SWF files, any armatures in the
loaded SWF files are not included.
Implementation public static function get numArmatures():int
public static function getArmatureAt(index:int):IKArmature
Language Version: | ActionScript 3.0 |
Product Version: | Flash CS4 |
Runtime Versions: | Flash Player 10, AIR 1.5 |
Returns the armature at the specified index.
Parameters
| index:int — The zero-based index number of the armature to retrieve.
|
Returns | IKArmature — Returns the IKArmature instance at the specified index.
|
Example The following example retrieves the first armature in the tree:
// Retrieve the first IKArmature
fl.ik.IKManager.getArmatureAt(0);
public static function getArmatureByName(name:String):IKArmature
Language Version: | ActionScript 3.0 |
Product Version: | Flash CS4 |
Runtime Versions: | Flash Player 10, AIR 1.5 |
Returns the armature with the specified name.
Parameters
| name:String — The name of the armature to retrieve.
|
Returns | IKArmature — Returns the IKArmature instance with the specified name.
|
Example The following example retrieves the first armature in the tree:
import fl.ik.*;
// Retrieve the IKArmature named "arm0" and assign to variable "tree"
var tree:IKArmature = IKManager.getArmatureByName("arm0");
public static function setStage(stage:DisplayObjectContainer):void
Language Version: | ActionScript 3.0 |
Product Version: | Flash CS4 |
Runtime Versions: | Flash Player 10, AIR 1.5 |
Use this method to indicate the container of symbols in a loaded SWF file. When you load a SWF file
containing an armature, you need to indicate the location of the symbols for the armature to the parent
SWF file. If the child SWF file has the armature symbols on the stage, then the value is
stage
or a variable for the stage.
Parameters
Example In the following example, one SWF file will load another SWF file containing an armature.
The child SWF file (the one containing the armature symbols) is generated from the myAnimation.fla file.
The parent SWF file (the one loading the myAnimation.swf file) is generated from the Main.fla file.
The myAnimation.fla file contains a set of armature symbols placed on the stage. A line of
ActionScript sets the variable myAnimationStage for stage, which in this case is the container of the
armature symbols. The ActionScript in the Main.fla file uses
setStage()
to tell the parent
SWF file the name of the symbol container in the child SWF file.
ActionScript for the myAnimation.fla file (to generate the child SWF file):
import fl.ik.*;
var myAnimationIKM = IKManager;
var myAnimationArm:IKArmature = IKManager.getArmatureAt(0);
// set a variable for the stage containing the armature symbols
var myAnimationStage:DisplayObjectContainer = stage;
ActionScript for the Main.fla file (to generate the parent SWF file):
var myLoader:Loader = new Loader();
myLoader.contentLoaderInfo.addEventListener(Event.COMPLETE, onCompleteFunc);
function onCompleteFunc(event:Event) {
// indicate container of the armature symbols
myLoader.content.myAnimationIKM.setStage(loader.content.myAnimationStage);
myLoader.content.myAnimationArm.registerElements(loader.content.myAnimationStage);
myLoader.content.myAnimationIKM.trackAllArmatures();
}
myLoader.load(new URLRequest("myAnimation.swf"));
addChild(myLoader);
public static function trackAllArmatures(enable:Boolean = true):void
Language Version: | ActionScript 3.0 |
Product Version: | Flash CS4 |
Runtime Versions: | Flash Player 10, AIR 1.5 |
Enables or disables live-tracking for all armatures.
When live-tracking is enabled, the user of a SWF file that contains
armatures can move an armature by clicking and dragging the armature.
Parameters
| enable:Boolean (default = true ) — If set to false , live-tracking is disabled.
Otherwise, live-tracking is enabled.
|
See also
Example The following example prevents the user of a SWF file
from controlling the movement of any armature:
import fl.ik.*;
// disable live tracking for all armatures in the SWF file
IKManager.trackAllArmatures(false);
public static function trackIKArmature(theTree:IKArmature, enable:Boolean = true):void
Language Version: | ActionScript 3.0 |
Product Version: | Flash CS4 |
Runtime Versions: | Flash Player 10, AIR 1.5 |
Enables or disables live-tracking for the specified IKArmature instance.
When live-tracking is enabled, the user of a SWF file that contains
armatures can move an armature by clicking and dragging the armature.
Parameters
| theTree:IKArmature — The armature to have live-tracking enabled
or disabled for.
|
|
| enable:Boolean (default = true ) — If set to false , live-tracking is disabled.
Otherwise, live-tracking is enabled.
|
See also
Example The following example enables the user of a SWF file
to control the movement of a human figure by clicking on and
dragging any part of the figure except the torso. The figure is
represented by an IKArmature named "personTree" which contains
an IKObject named "torso" that represents the figure's torso:
import fl.ik.*;
// turn off tracking for all armatures in the SWF file
IKManager.trackAllArmatures(false);
// enable live tracking for the entire armature
IKManager.trackIKArmature(personTree, true);
// disable live tracking for the figure's torso
IKManager.trackIKObject(torso, false);
public static function trackIKObject(target:DisplayObject, enable:Boolean = true):*
Language Version: | ActionScript 3.0 |
Product Version: | Flash CS4 |
Runtime Versions: | Flash Player 10, AIR 1.5 |
Enables or disables live-tracking for the specified IK display object instance.
When live-tracking is enabled for a specific IK display object instance,
the user can move the armature that contains the IK display object instance
by clicking and dragging that IK display object.
Parameters
| target:DisplayObject — The IK display object instance to have live-tracking enabled
or disabled for.
|
|
| enable:Boolean (default = true ) — If set to false , live-tracking is disabled.
Otherwise, live-tracking is enabled.
|
ReturnsSee also
Example The following example enables the user of a SWF file
to control the movement of a human figure by clicking and
dragging only the hands of that figure. The hands are represented
by IK display object instances
rightHand
and
leftHand
;
both are MovieClip instances:
import fl.ik.*;
// turn off tracking for all armatures in the SWF file
IKManager.trackAllArmatures(false);
// enable live tracking for the right hand
IKManager.trackIKObject(rightHand, true);
// enable live tracking for the left hand
IKManager.trackIKObject(leftHand, true);
© 2009 Adobe Systems Incorporated. All rights reserved.
Wed Jul 29 2009, 04:58 PM -07:00 IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager IKManager
fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager fl.ik.IKManager