IKManager - Guida di riferimento alle API Adobe ActionScript® 3 (AS3 Flash)

Pacchetto	fl.ik
Classe	public class IKManager
Ereditarietà	IKManager EventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS4

Versioni runtime:

Flash Player 10, AIR 1.5

La classe IKManager è una classe contenitore che rappresenta tutte le strutture (armature) cinematiche inverse (IK) definite in un documento e consente la gestione di tali armature in fase di runtime.

Le armature possono essere create solo nello strumento di creazione Flash. Quando si pubblica un documento Flash CS4 con armature, lo strumento di creazione Flash memorizza una rappresentazione XML delle armature e codice ActionScript generato nel file SWF. In runtime, Flash Player esegue il codice ActionScript e analizza l'XML per ricreare le armature.

Non dovete creare un'istanza della classe, in quanto viene creata automaticamente in runtime. Tutti i metodi e le proprietà della classe IKManager, inoltre, sono statici, quindi non dovete fare riferimento a un'istanza di tale classe.

Nota: quando fate riferimento agli oggetti IKArmature in una classe documento, verificate innanzitutto l'evento frameConstructed per assicurarvi che tutti gli oggetti siano stati compilati.

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		numArmatures : int [statico] [sola lettura] Il numero di armature sullo stage.	IKManager

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.	EventDispatcher
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		getArmatureAt(index:int):IKArmature [statico] Restituisce l'armatura nella posizione di indice specificata.	IKManager
		getArmatureByName(name:String):IKArmature [statico] Restituisce l'armatura con il nome specificato.	IKManager
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		setStage(stage:DisplayObjectContainer):void [statico] Utilizzate questo metodo per indicare il contenitore dei simboli in un file SWF caricato.	IKManager
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		trackAllArmatures(enable:Boolean = true):void [statico] Attiva o disattiva il tracciamento dal vivo per tutte le armature.	IKManager
		trackIKArmature(theTree:IKArmature, enable:Boolean = true):void [statico] Attiva o disattiva il tracciamento dal vivo per l'istanza IKArmature specificata.	IKManager
		trackIKObject(target:DisplayObject, enable:Boolean = true):* [statico] Attiva o disattiva il tracciamento dal vivo per l'istanza dell'oggetto di visualizzazione IK specificato.	IKManager
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Evento		Riepilogo	Definito da
		activate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.	EventDispatcher
		deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher

Descrizione delle proprietà

numArmatures

proprietà

numArmatures:int [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS4

Versioni runtime:

Flash Player 10, AIR 1.5

Il numero di armature sullo stage. Se il file SWF carica successivamente altri file SWF, le eventuali armature contenute nei file SWF caricati non sono incluse.

Implementazione
public static function get numArmatures():int

Descrizione dei metodi

getArmatureAt

()

metodo

public static function getArmatureAt(index:int):IKArmature

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS4

Versioni runtime:

Flash Player 10, AIR 1.5

Restituisce l'armatura nella posizione di indice specificata.

Parametri

index:int — Il numero di indice a base zero dell'armatura da recuperare.

Restituisce

IKArmature — Restituisce l'istanza IKArmature in corrispondenza della posizione di indice specificata.

Esempio ( Come utilizzare questo esempio )

Nell'esempio seguente viene recuperata la prima armatura nella struttura. Per fare riferimento alle armature in una classe documento, utilizzate l'evento frameConstructed anziché l'evento addedToStage. In questo modo vengono compilati tutti gli oggetti IKArmature.

         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

()

metodo

public static function getArmatureByName(name:String):IKArmature

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS4

Versioni runtime:

Flash Player 10, AIR 1.5

Restituisce l'armatura con il nome specificato.

Parametri

name:String — Il nome dell'armatura da recuperare.

Restituisce

IKArmature — Restituisce l'istanza IKArmature con il nome specificato.

Esempio ( Come utilizzare questo esempio )

Nell'esempio seguente viene recuperata la prima armatura nella struttura:

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

setStage

()

metodo

public static function setStage(stage:DisplayObjectContainer):void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS4

Versioni runtime:

Flash Player 10, AIR 1.5

Utilizzate questo metodo per indicare il contenitore dei simboli in un file SWF caricato. Quando caricate un file SWF contenente un'armatura, dovete indicare la posizione dei simboli dell'armatura al file SWF principale. Se il file SWF secondario presenta i simboli dell'armatura sullo stage, il valore è stage o una variabile dello stage.

Parametri

stage:DisplayObjectContainer — La posizione dei simboli di armatura in un file SWF caricato.

Esempio ( Come utilizzare questo esempio )

Nell'esempio seguente, un file SWF carica un altro file SWF contenente un'armatura. Il file SWF secondario (quello contenente i simboli dell'armatura) viene generato dal file myAnimation.fla. Il file SWF principale (quello che carica il file myAnimation.swf) viene generato dal file Main.fla. Il file myAnimation.fla contiene una serie di simboli di armatura collocati sullo stage. Una riga di codice ActionScript imposta la variabile myAnimationStage per lo stage, che in questo caso è il contenitore dei simboli dell'armatura. Il codice ActionScript in Main.fla utilizza setStage() per indicare al file SWF principale il nome del contenitore di simboli nel file SWF secondario.

Codice ActionScript per il file myAnimation.fla (per generare il file SWF secondario):

         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;

Codice ActionScript per il file Main.fla (per generare il file SWF principale):

         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

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS4

Versioni runtime:

Flash Player 10, AIR 1.5

Attiva o disattiva il tracciamento dal vivo per tutte le armature. Quando il tracciamento dal vivo è attivato, l'utente di un file SWF che contiene armature può spostare un'armatura facendo clic su di essa e trascinandola.

Parametri

enable:Boolean (default = true) — Se impostato su false, il tracciamento dal vivo è disattivato. In caso contrario, il tracciamento dal vivo è attivato.

Elementi API correlati

trackIKArmature()
trackIKObject()

Esempio ( Come utilizzare questo esempio )

Nell'esempio seguente viene impedito all'utente di un file SWF di controllare il movimento di qualsiasi armatura:

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

trackIKArmature

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS4

Versioni runtime:

Flash Player 10, AIR 1.5

Attiva o disattiva il tracciamento dal vivo per l'istanza IKArmature specificata. Quando il tracciamento dal vivo è attivato, l'utente di un file SWF che contiene armature può spostare un'armatura facendo clic su di essa e trascinandola.

Parametri

	`theTree:IKArmature` — L'armatura per cui deve essere attivato o disattivato il tracciamento dal vivo.

	`enable:Boolean` (default = `true`) — Se impostato su `false`, il tracciamento dal vivo è disattivato. In caso contrario, il tracciamento dal vivo è attivato.

Elementi API correlati

trackAllArmatures()
trackIKObject()
Classe IKArmature

Esempio ( Come utilizzare questo esempio )

L'esempio seguente consente all'utente di un file SWF di controllare il movimento di una figura umana facendo clic su una parte qualsiasi della figura, eccetto il tronco, e trascinandola. La figura è rappresentata da un oggetto IKArmature denominato "personTree" (struttura della persona) che contiene un IKObject denominato "torso" che rappresenta il tronco della figura:

             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

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS4

Versioni runtime:

Flash Player 10, AIR 1.5

Attiva o disattiva il tracciamento dal vivo per l'istanza dell'oggetto di visualizzazione IK specificato. Quando è attivato il tracciamento dal vivo per un'istanza dell'oggetto di visualizzazione IK specifica, l'utente può spostare l'armatura che contiene l'istanza dell'oggetto di visualizzazione IK facendo clic e trascinando tale oggetto di visualizzazione IK.

Parametri

	`target:DisplayObject` — L'istanza dell'oggetto di visualizzazione IK per cui deve essere attivato o disattivato il tracciamento dal vivo.

	`enable:Boolean` (default = `true`) — Se impostato su `false`, il tracciamento dal vivo è disattivato. In caso contrario, il tracciamento dal vivo è attivato.

Restituisce

*

Elementi API correlati

trackAllArmatures()
trackIKArmature()

Esempio ( Come utilizzare questo esempio )

L'esempio seguente consente all'utente di un file SWF di controllare il movimento di una figura umana facendo clic e trascinando solo le mani di quella figura. Le mani sono rappresentate da istanze degli oggetti di visualizzazione IK rightHand eleftHand, che sono entrambe istanze di MovieClip:

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

Note legali | Informativa sulla privacy online

IKManager - AS3 Flash

Classi x

numArmatures

getArmatureAt

getArmatureByName

setStage

trackAllArmatures

trackIKArmature

trackIKObject