Referência do ActionScript® 3.0 para Adobe® Flash® Platform
Início  |  Ocultar listas de Pacotes e Classes |  Pacotes  |  Classes  |  Novidades  |  Índice  |  Apêndices  |  Por que inglês?
Filtros: Recuperando dados do servidor...
Recuperando dados do servidor...
fl.ik 

IKManager  - AS3 Flash

Pacotefl.ik
Classepublic class IKManager
HerançaIKManager Inheritance EventDispatcher Inheritance 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
 PropriedadeDefinido por
 Inheritedconstructor : 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
 MétodoDefinido por
 Inherited
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
 Inherited
Envia um evento para o fluxo de eventos.
EventDispatcher
  
[estático] Retorna a armadura no índice especificado.
IKManager
  
[estático] Retorna a armadura com o nome especificado.
IKManager
 Inherited
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.
EventDispatcher
 Inherited
Indica se um objeto tem uma propriedade especificada definida.
Object
 Inherited
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.
Object
 Inherited
Indica se a propriedade especificada existe e é enumerável.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Remove um ouvinte do objeto EventDispatcher.
EventDispatcher
 Inherited
Define a disponibilidade de uma propriedade dinâmica para operações de repetição.
Object
  
[estático] Use este método para indicar o container de símbolos em um arquivo SWF carregado.
IKManager
 Inherited
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.
Object
 Inherited
Retorna a representação de string do objeto especificado.
Object
  
[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
 Inherited
Retorna o valor primitivo do objeto especificado.
Object
 Inherited
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
 Evento Resumo Definido por
 Inherited[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
 Inherited[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


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


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


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




[ X ]Por que inglês?
O conteúdo na Referência do ActionScript 3.0 aparece em inglês

Nem todas as partes da Referência do ActionScript 3.0 estão traduzidas em todos os idiomas. Quando um elemento de um idioma não está traduzido, ele é exibido em inglês. Por exemplo, a classe ga.controls.HelpBox não está traduzida em nenhum idioma. Por isso, na versão da referência em português do Brasil, a classe ga.controls.HelpBox é exibida em inglês.