IKManager - Bron voor Adobe ActionScript® 3 (AS3 Flash) API

Pakket	fl.ik
Klasse	public class IKManager
Overerving	IKManager EventDispatcher Object

Taalversie:

ActionScript 3.0

Productversie:

Flash CS4

Runtimeversies:

Flash Player 10, AIR 1.5

De klasse IKManager is een container-klasse die alle IK-structuren (inverse kinematics) (armaturen) voorstelt die in een document zijn gedefinieerd. Met deze klasse kunt u die armaturen in runtime beheren.

Armaturen kunnen alleen met het Flash-ontwerpgereedschap worden gemaakt. Wanneer u een Flash CS4-document met armaturen publiceert, slaat het Flash-ontwerpgereedschap een XML-voorstelling van de armaturen en bepaalde gegenereerde ActionScript-code in het SWF-bestand op. In runtime wordt de ActionScript-code uitgevoerd en de XML geparseerd om de armaturen opnieuw te maken.

U hoeft geen instantie van de klasse IKManager te maken. De runtime maakt automatisch een instantie van deze klasse. Daarnaast zijn alle eigenschappen en methoden van de klasse IKManager statisch. U hoeft niet naar een instantie van de klasse IKManager te verwijzen.

Opmerking: als u refereert aan IKArmature-objecten in een documentklasse, moet u eerst de gebeurtenis frameConstructed controleren om zeker te zijn dat alle objecten zijn gevuld.

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		numArmatures : int [statisch] [alleen-lezen] Het aantal armaturen in het werkgebied.	IKManager

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt.	EventDispatcher
		dispatchEvent(event:Event):Boolean Verzendt een gebeurtenis naar de gebeurtenisstroom.	EventDispatcher
		getArmatureAt(index:int):IKArmature [statisch] Retourneert de armatuur bij de opgegeven index.	IKManager
		getArmatureByName(name:String):IKArmature [statisch] Retourneert de armatuur met de opgegeven naam.	IKManager
		hasEventListener(type:String):Boolean Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.	EventDispatcher
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Verwijdert een listener uit het object EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		setStage(stage:DisplayObjectContainer):void [statisch] Gebruik deze methode om de symboolcontainer in een geladen SWF-bestand aan te geven.	IKManager
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String Retourneert een tekenreeksrepresentatie van het opgegeven object.	Object
		trackAllArmatures(enable:Boolean = true):void [statisch] Schakelt live tracering voor alle armaturen in of uit.	IKManager
		trackIKArmature(theTree:IKArmature, enable:Boolean = true):void [statisch] Schakelt live tracering in of uit voor de opgegeven IKArmature-instantie.	IKManager
		trackIKObject(target:DisplayObject, enable:Boolean = true):* [statisch] Schakelt live tracering in of uit voor de opgegeven instantie van het IK-weergaveobject.	IKManager
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object
		willTrigger(type:String):Boolean Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.	EventDispatcher

Gebeurtenissen

Klik voor meer informatie over gebeurtenissen.

Overerfde gebeurtenissen verbergen

Overerfde gebeurtenissen weergeven

	Gebeurtenis		Overzicht	Gedefinieerd door
		activate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt.	EventDispatcher
		deactivate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.	EventDispatcher

Eigenschapdetails

numArmatures

eigenschap

numArmatures:int [alleen-lezen]

Taalversie:

ActionScript 3.0

Productversie:

Flash CS4

Runtimeversies:

Flash Player 10, AIR 1.5

Het aantal armaturen in het werkgebied. Als het SWF-bestand achtereenvolgens andere SWF-bestanden laadt, worden armaturen in de geladen SWF-bestanden niet ingesloten.

Implementatie
public static function get numArmatures():int

Methodedetails

getArmatureAt

()

methode

public static function getArmatureAt(index:int):IKArmature

Taalversie:

ActionScript 3.0

Productversie:

Flash CS4

Runtimeversies:

Flash Player 10, AIR 1.5

Retourneert de armatuur bij de opgegeven index.

Parameters

index:int — De op nul gebaseerde indexwaarde van de armatuur die moet worden opgehaald.

Geretourneerde waarde

IKArmature — Retourneert de IKArmature-instantie bij de opgegeven index.

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt de eerste armatuur in de structuur opgehaald. Om te refereren aan armaturen in een documentklasse gebruikt u de gebeurtenis frameConstructed in plaats van de gebeurtenis addedToStage. Dit zorgt ervoor dat alle IKArmatures gevuld zijn.

         package
         {
            import fl.ik;
            import flash.display.MovieClip;
            import flash.events;
         
            public class IKDocClass extends MovieClip
            {
               public var arm:IKArmature;
         
               function IKDocClass()
               {
                  addEventListener("frameConstructed", onFC);
               }
         
               function onFC(evt:Event):void
               {
                  //Refer to armatures in frameConstructed
                  arm = IKManager.getArmatureAt(0);
                  trace(arm.name);
                  removeEventListener("frameConstructed", onFC);
               }
            }
         }

getArmatureByName

()

methode

public static function getArmatureByName(name:String):IKArmature

Taalversie:

ActionScript 3.0

Productversie:

Flash CS4

Runtimeversies:

Flash Player 10, AIR 1.5

Retourneert de armatuur met de opgegeven naam.

Parameters

name:String — De naam van de armatuur die moet worden opgehaald.

Geretourneerde waarde

IKArmature — Retourneert de IKArmature-instantie met de opgegeven naam.

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt de eerste armatuur in de structuur opgehaald:

         import fl.ik.*;
         // Retrieve the IKArmature named "arm0" and assign to variable "tree"
         var tree:IKArmature = IKManager.getArmatureByName("arm0");

setStage

()

methode

public static function setStage(stage:DisplayObjectContainer):void

Taalversie:

ActionScript 3.0

Productversie:

Flash CS4

Runtimeversies:

Flash Player 10, AIR 1.5

Gebruik deze methode om de symboolcontainer in een geladen SWF-bestand aan te geven. Wanneer u een SWF-bestand laadt dat een armatuur bevat, moet u de locatie van de symbolen aangeven voor de armatuur van het bovenliggende SWF-bestand. Als het onderliggende SWF-bestand de armatuursymbolen in het werkgebied heeft, is de waarde voor het werkgebied stage of een variabele.

Parameters

stage:DisplayObjectContainer — De locatie van de armatuursymbolen in een geladen SWF-bestand.

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld, laadt één SWF-bestand een ander SWF-bestand met een armatuur. Het onderliggende SWF-bestand (dat de armatuursymbolen bevat) wordt gegenereerd vanaf het myAnimation.fla-bestand. Het bovenliggende SWF-bestand (dat het myAnimation.swf-bestand laadt) wordt gegenereerd vanaf het Main.fla-bestand. Het myAnimation.fla-bestand bevat een set armatuursymbolen die op het werkgebied worden geplaatst. Een lijn in ActionScript stelt de variabele myAnimationStage voor het werkgebied in, wat in dit geval de container van de armatuursymbolen is. De ActionScript in het Main.fla-bestand gebruikt setStage() om aan het bovenliggende SWF-bestand de naam van de symboolcontainer in het onderliggende SWF-bestand door te geven.

ActionScript voor het myAnimation.fla-bestand (om het onderliggende SWF-bestand te genereren):

         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 voor het Main.fla-bestand (om het bovenliggende SWF-bestand te genereren):

         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);

trackAllArmatures

()

methode

public static function trackAllArmatures(enable:Boolean = true):void

Taalversie:

ActionScript 3.0

Productversie:

Flash CS4

Runtimeversies:

Flash Player 10, AIR 1.5

Schakelt live tracering voor alle armaturen in of uit. Wanneer live tracering is ingeschakeld, kan de gebruiker van een SWF-bestand dat armaturen bevat, een armatuur verplaatsen door op de armatuur te klikken en deze te slepen.

Parameters

enable:Boolean (default = true) — Bij false wordt live tracering uitgeschakeld. In andere gevallen wordt live tracering ingeschakeld.

Verwante API-elementen

trackIKArmature()
trackIKObject()

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt voorkomen dat de gebruiker van een SWF-bestand de beweging van een armatuur kan besturen:

             import fl.ik.*;
             // disable live tracking for all armatures in the SWF file
             IKManager.trackAllArmatures(false);

trackIKArmature

()

methode

public static function trackIKArmature(theTree:IKArmature, enable:Boolean = true):void

Taalversie:

ActionScript 3.0

Productversie:

Flash CS4

Runtimeversies:

Flash Player 10, AIR 1.5

Schakelt live tracering in of uit voor de opgegeven IKArmature-instantie. Wanneer live tracering is ingeschakeld, kan de gebruiker van een SWF-bestand dat armaturen bevat, een armatuur verplaatsen door op de armatuur te klikken en deze te slepen.

Parameters

	`theTree:IKArmature` — De armatuur waarvoor live tracering wordt in- of uitgeschakeld.

	`enable:Boolean` (default = `true`) — Bij `false` wordt live tracering uitgeschakeld. In andere gevallen wordt live tracering ingeschakeld.

Verwante API-elementen

trackAllArmatures()
trackIKObject()
IKArmature-klasse

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt mogelijk gemaakt dat de gebruiker van een SWF-bestand de beweging van een menselijke figuur kan besturen door te klikken op een willekeurig deel van de figuur, behalve de romp, en dit deel te slepen. De figuur wordt voorgesteld door een IKArmature met de naam "personTree"; deze bevat een IKObject met de naam "torso" die de romp van de figuur voorstelt:

             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);

trackIKObject

()

methode

public static function trackIKObject(target:DisplayObject, enable:Boolean = true):*

Taalversie:

ActionScript 3.0

Productversie:

Flash CS4

Runtimeversies:

Flash Player 10, AIR 1.5

Schakelt live tracering in of uit voor de opgegeven instantie van het IK-weergaveobject. Wanneer live tracering voor een specifieke instantie van een IK-weergaveobject is ingeschakeld, kan de gebruiker de armatuur die de instantie van het IK-weergaveobject bevat, verplaatsen door op het IK-weergaveobject te klikken en het te slepen.

Parameters

	`target:DisplayObject` — De instantie van het IK-weergaveobject waarvoor live tracering wordt in- of uitgeschakeld.

	`enable:Boolean` (default = `true`) — Bij `false` wordt live tracering uitgeschakeld. In andere gevallen wordt live tracering ingeschakeld.

Geretourneerde waarde

*

Verwante API-elementen

trackAllArmatures()
trackIKArmature()

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt mogelijk gemaakt dat de gebruiker van een SWF-bestand de beweging van een menselijke figuur kan besturen door alleen op de handen van die figuur te klikken en deze te slepen. De handen worden voorgesteld door de IK-weergaveobjectinstanties rightHand en leftHand. Dit zijn allebei MovieClip-instanties:

             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);

Juridische kennisgeving | Online privacybeleid

IKManager - AS3 Flash

Klassen x

numArmatures

getArmatureAt

getArmatureByName

setStage

trackAllArmatures

trackIKArmature

trackIKObject