IKManager - Referência da API Adobe ActionScript® 3 (AS3 Flash)

Pacote	fl.ik
Classe	public class IKManager
Herança	IKManager EventDispatcher Object

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS4

Versões de runtime:

Flash Player 10, AIR 1.5

A classe IKManager é uma classe de contêiner que representa todas as árvores (armaduras) de cinemática inversa (IK) definidas em um documento e que permite o gerenciamento dessas armaduras no tempo de execução.

As armaduras podem ser criadas somente na ferramenta de autoria do Flash. Quando um documento Flash CS4 é publicado com armaduras, a ferramenta de autoria do Flash armazena uma representação XML das armaduras e algum código ActionScript gerado no arquivo SWF. No tempo de execução, o Flash Player executa o código ActionScript e analisa o XML para recriar as armaduras.

Não é necessário criar uma instância da classe IKManager; o tempo de execução cria uma instância dessa classe automaticamente. Além disso, todos os métodos e propriedades da classe IKManager são estáticos; não é necessário fazer referência a uma instância da classe IKManager.

Observação: ao se referir a objetos de IKArmature dentro de uma classe do documento, certifique-se primeiro de verificar o evento frameConstructed para assegurar o preenchimento de todos os objetos.

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		numArmatures : int [estático] [somente leitura] O número de armaduras no palco.	IKManager

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento.	EventDispatcher
		dispatchEvent(event:Event):Boolean Envia um evento para o fluxo de eventos.	EventDispatcher
		getArmatureAt(index:int):IKArmature [estático] Retorna a armadura no índice especificado.	IKManager
		getArmatureByName(name:String):IKArmature [estático] Retorna a armadura com o nome especificado.	IKManager
		hasEventListener(type:String):Boolean Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Remove um ouvinte do objeto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		setStage(stage:DisplayObjectContainer):void [estático] Use este método para indicar o container de símbolos em um arquivo SWF carregado.	IKManager
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String Retorna a representação de string do objeto especificado.	Object
		trackAllArmatures(enable:Boolean = true):void [estático] Ativa ou desativa o rastreamento ao vivo de todas as armaduras.	IKManager
		trackIKArmature(theTree:IKArmature, enable:Boolean = true):void [estático] Ativa ou desativa o rastreamento ao vivo para a instância IKArmature especificada.	IKManager
		trackIKObject(target:DisplayObject, enable:Boolean = true):* [estático] Ativa ou desativa o rastreamento ao vivo para a instância de objeto de exibição IK especificada.	IKManager
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object
		willTrigger(type:String):Boolean Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado.	EventDispatcher

Eventos

Clique para obter mais informações sobre eventos

Ocultar eventos herdados

Mostrar eventos herdados

	Evento		Resumo	Definido por
		activate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo.	EventDispatcher
		deactivate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo.	EventDispatcher

Detalhes da propriedade

numArmatures

propriedade

numArmatures:int [somente leitura]

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS4

Versões de runtime:

Flash Player 10, AIR 1.5

O número de armaduras no palco. Se o arquivo SWF carrega subsequentemente outros arquivos SWF, nenhuma armadura nos arquivos SWF carregados será incluída.

Implementação
public static function get numArmatures():int

Detalhes do método

getArmatureAt

()

método

public static function getArmatureAt(index:int):IKArmature

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS4

Versões de runtime:

Flash Player 10, AIR 1.5

Retorna a armadura no índice especificado.

Parâmetros

index:int — O número de índice com base em zero da armadura a ser recuperada.

Retorna

IKArmature — Retorna a instância IKArmature no índice especificado.

Exemplo ( Como usar este exemplo )

O exemplo a seguir recupera a primeira armadura na árvore. Para armaduras de referência dentro de uma classe de documento, use o evento frameConstructed em vez de o evento addedToStage. Isto garante que todos os IKArmatures sejam preenchidos.

         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

()

método

public static function getArmatureByName(name:String):IKArmature

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS4

Versões de runtime:

Flash Player 10, AIR 1.5

Retorna a armadura com o nome especificado.

Parâmetros

name:String — O nome da armadura a ser recuperada.

Retorna

IKArmature — Retorna a instância IKArmature com o nome especificado.

Exemplo ( Como usar este exemplo )

O exemplo a seguir recupera a primeira armadura na árvore:

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

setStage

()

método

public static function setStage(stage:DisplayObjectContainer):void

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS4

Versões de runtime:

Flash Player 10, AIR 1.5

Use este método para indicar o container de símbolos em um arquivo SWF carregado. Quando você carrega um arquivo SWF que contém uma armadura, você tem de indicar o local dos símbolos da armadura ao arquivo SWF pai. Se o arquivo SWF filho tiver os símbolos de armadura no palco, então o valor é stage ou uma variável para palco.

Parâmetros

stage:DisplayObjectContainer — O local dos símbolos de armadura em um arquivo SWF carregado.

Exemplo ( Como usar este exemplo )

No seguinte exemplo, um arquivo SWF carregará outro arquivo SWF que contém uma armadura. O arquivo SWF filho (aquele que contém os símbolos de armadura) é gerado do arquivo myAnimation.fla. O arquivo SWF pai (aquele que carrega o arquivo myAnimation.swf) é gerado do arquivo Main.fla. O arquivo myAnimation.fla contém o grupo de símbolos de armadura inseridos no palco. Uma linha de ActionScript estabelece a variável myAnimationStage para a etapa, que nesta caixa é o container dos símbolos de armadura. O ActionScript no arquivo Main.fla usa setStage() para dizer ao arquivo SWF pai o nome do container de símbolo no arquivo SWF filho.

ActionScript para o arquivo myAnimation.fla (para gerar o arquivo SWF filho):

         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 para o arquivo Main.fla (para gerar o arquivo SWF pai):

         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

()

método

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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS4

Versões de runtime:

Flash Player 10, AIR 1.5

Ativa ou desativa o rastreamento ao vivo de todas as armaduras. Quando o rastreamento ao vivo é ativado, o usuário de um arquivo SWF que contém armaduras pode mover uma armadura clicando nela e arrastando-a.

Parâmetros

enable:Boolean (default = true) — Se definido como false, o tracking instantâneo será desativado. Caso contrário, o tracking instantâneo será ativado.

Elementos da API relacionados

trackIKArmature()
trackIKObject()

Exemplo ( Como usar este exemplo )

O exemplo a seguir impede que o usuário de um arquivo SWF controle o movimento de qualquer armadura:

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

trackIKArmature

()

método

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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS4

Versões de runtime:

Flash Player 10, AIR 1.5

Ativa ou desativa o rastreamento ao vivo para a instância IKArmature especificada. Quando o rastreamento ao vivo é ativado, o usuário de um arquivo SWF que contém armaduras pode mover uma armadura clicando nela e arrastando-a.

Parâmetros

	`theTree:IKArmature` — A armadura que terá o rastreamento ao vivo ativado ou desativado.

	`enable:Boolean` (default = `true`) — Se definido como `false`, o tracking instantâneo será desativado. Caso contrário, o tracking instantâneo será ativado.

Elementos da API relacionados

trackAllArmatures()
trackIKObject()
Classe IKArmature

Exemplo ( Como usar este exemplo )

O exemplo a seguir permite que o usuário de um arquivo SWF controle o movimento de uma figura humana clicando em qualquer parte, exceto no torso, e, em seguida, arraste-a. A figura é representada por uma IKArmature denominada "personTree", que contém um IKObject chamado "torso" que representa o torso da 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

()

método

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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS4

Versões de runtime:

Flash Player 10, AIR 1.5

Ativa ou desativa o rastreamento ao vivo para a instância de objeto de exibição IK especificada. Quando o rastreamento ao vivo é ativado para uma ocorrência de objeto de exibição IK específica, o usuário pode mover a armadura que contém a ocorrência de objeto de exibição IK clicando nesse objeto e arrastando-o.

Parâmetros

	`target:DisplayObject` — A ocorrência de objeto de exibição IK que terá o rastreamento ao vivo ativado ou desativado.

	`enable:Boolean` (default = `true`) — Se definido como `false`, o tracking instantâneo será desativado. Caso contrário, o tracking instantâneo será ativado.

Retorna

*

Elementos da API relacionados

trackAllArmatures()
trackIKArmature()

Exemplo ( Como usar este exemplo )

O exemplo a seguir permite que o usuário de um arquivo SWF controle o movimento de uma figura humana clicando somente nas mãos da figura e arrastando-as. As mãos são representadas pelas ocorrências de objetos de exibição IK rightHand e leftHand; ambas são ocorrências de 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);

Aspectos jurídicos | Política de privacidade on-line

IKManager - AS3 Flash

Pacotesx

Elementos de linguagem

Apêndices

Pacote fl.ik

numArmatures

getArmatureAt

getArmatureByName

setStage

trackAllArmatures

trackIKArmature

trackIKObject