| Language Version: | ActionScript 3.0 |
| 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 |
| 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 |
| 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 |
| 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 Parameters
public static function trackAllArmatures(enable:Boolean = true):void| Language Version: | ActionScript 3.0 |
| 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 |
| 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 |
| 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);
© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Wed Nov 19 2008, 09:06 AM -08: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