ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: Pobieranie danych z serwera...
Pobieranie danych z serwera...
fl.ik 

IKArmature  - AS3 Flash

Pakietfl.ik
Klasapublic class IKArmature
DziedziczenieIKArmature Inheritance Object

Wersja języka: ActionScript 3.0
Wersja produktu: Flash CS4
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Klasa IKArmature opisuje szkielet kinematyki odwrotnej (KO). Szkielet jest kolekcją segmentów, nazywanych „kośćmi”, połączonych wzajemnie w „stawach”. Szkielet jest często opisywany jako struktura przypominająca drzewo lub łańcuch. Korzystając z właściwości springsEnabled, w szkieletach można stosować efekty sprężystości i tłumienia drgań udostępniane przez mechanizm symulacji dynamiki ruchu.

Ponieważ szkielety można tworzyć wyłącznie w narzędziu Flash do tworzenia treści, nie należy używać konstruktora klasy IKArmature do tworzenia instancji tej klasy. Program Flash Player tworzy wszystkie instancje klasy IKArmature podczas uruchamiania pliku SWF. Istnieje możliwość utworzenia odwołania do szkieletu przy użyciu metody getArmatureAt() lub getArmatureByName() klasy IKManager.

Uwaga: Jeśli szkielet nie znajduje się w pierwszej klatce sceny, należy użyć metody registerElements() w celu zainicjowania szkieletu dla określonego obiektu DisplayObject.

Powiązane elementy interfejsu API



Właściwości publiczne
 WłaściwośćZdefiniowane przez
 Inheritedconstructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.
Object
  container : DisplayObjectContainer
[tylko do odczytu] Zwraca obiekt DisplayObjectContainer przekazany w wywołaniu metody registerElements.
IKArmature
  name : String
[tylko do odczytu] Nazwa szkieletu.
IKArmature
  rootJoint : IKJoint
[tylko do odczytu] Główny staw szkieletu.
IKArmature
  springsEnabled : Boolean
Określa, czy w szkielecie jest włączony efekt sprężystości.
IKArmature
Metody publiczne
 MetodaZdefiniowane przez
  
Zwraca określoną kość.
IKArmature
 Inherited
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
 Inherited
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
 Inherited
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
  
Aktywuje kinematykę odwrotną (KO) dla instancji symbolu bibliotecznego zawierającej szkielet.
IKArmature
 Inherited
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
 Inherited
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
 Inherited
Zwraca ciąg reprezentujący określony obiekt.
Object
 Inherited
Zwraca pierwotną wartość dla określonego obiektu.
Object
Szczegół właściwości

container

właściwość
container:DisplayObjectContainer  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Zwraca obiekt DisplayObjectContainer przekazany w wywołaniu metody registerElements.



Implementacja
    public function get container():DisplayObjectContainer

name

właściwość 
name:String  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersja produktu: Flash CS4
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Nazwa szkieletu. Nazwę szkieletu można określić tylko w narzędziu Flash do tworzenia treści.



Implementacja
    public function get name():String

Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje sposób pobrania nazwy pierwszego szkieletu w dokumencie.
         import fl.ik.*;
         // Retrieve the first armature and store in variable "arm0"
         var arm0:IKArmature = IKManager.getArmatureAt(0);
         // Trace the name of the first armature
         trace(arm0.name);
         

rootJoint

właściwość 
rootJoint:IKJoint  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersja produktu: Flash CS4
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Główny staw szkieletu. Każdy szkielet zawiera dokładnie jeden staw główny, ale może mieć wiele stawów podrzędnych. Istnieje możliwość przechodzenia przez szkielet. Należy w tym celu pobrać staw główny i za pomocą metod klasy IKJoint przechodzić od stawu do stawu.



Implementacja
    public function get rootJoint():IKJoint

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje sposób pobierania pierwszego szkieletu w dokumencie i pobrania głównego stawu tego szkieletu:
         import fl.ik.*;
         // Retrieve the first armature and store in variable "arm0"
         var arm0:IKArmature = IKManager.getArmatureAt(0);
         // Retrieve the armature's root joint
         var rootJnt:IKJoint = arm0.rootJoint;
         

springsEnabled

właściwość 
springsEnabled:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10.1, AIR 1.5

Określa, czy w szkielecie jest włączony efekt sprężystości. Wartość true powoduje, że w animacji szkieletu mogą być stosowane efekty sprężystości i tłumienia drgań udostępniane przez nowy mechanizm symulacji dynamiki ruchu. Wartością domyślną jest true.

         myArmature:IKArmature = fl.ik.IKManager.getArmatureAt(0);
         myArmature.springsEnabled = true; // turns springs on
         



Implementacja
    public function get springsEnabled():Boolean
    public function set springsEnabled(value:Boolean):void
Szczegół metody

getBoneByName

()metoda
public function getBoneByName(targetName:String):IKBone

Wersja języka: ActionScript 3.0
Wersja produktu: Flash CS4
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Zwraca określoną kość. Każdej kości można przypisać nazwę w narzędziu Flash do tworzenia treści. Ta metoda służy do tworzenia odwołania do kości, co umożliwia manipulowanie nimi w środowisku wykonawczym.

Parametry

targetName:String

Zwraca
IKBone — Instancja klasy IKBone określona parametrem targetName.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje pobieranie kości o nazwie "firstBone" i przypisywanie jej do zmiennej o nazwie "bone":
         import fl.ik.*;
         // Retrieve bone named "firstBone" and store in variable "bone"
         var bone:IKBone = IKArmature.getBoneByName("firstBone");
         

registerElements

()metoda 
public function registerElements(container:DisplayObjectContainer):*

Wersja języka: ActionScript 3.0
Wersja produktu: Flash CS4
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Aktywuje kinematykę odwrotną (KO) dla instancji symbolu bibliotecznego zawierającej szkielet. Obiekt MovieClip z biblioteki zawierający szkielet, którego instancja jest tworzona w środowisku wykonawczym, musi wywołać tę metodę w celu aktywowania efektów kinematyki odwrotnej.

Uwaga: Ponadto metodę tę należy wywołać, jeśli szkielet nie znajduje się w pierwszej klatce pierwszej sceny.

Parametry

container:DisplayObjectContainer — Odwołanie do stołu montażowego, dostępne przez właściwość stage dowolnego obiektu DisplayObject znajdującego się obecnie na liście wyświetlania.

Zwraca
*

Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje sposób aktywowania kinematyki odwrotnej dla symbolu bibliotecznego, którego instancja jest tworzona w środowisku wykonawczym. Symbolem bibliotecznym jest obiekt MovieClip o nazwie "IKPerson" zawierający szkielet.
         import fl.ik.*;
         // Add a Library Symbol named "IKPerson"
         // that contains an armature.
         // The symbol must be marked "Export for ActionScript"
         var myPerson:IKPerson = new IKPerson();
         
         // add MovieClip to display list
         addChild(myPerson);
         
         // The IKPerson MovieClip contains an IK Armature with the name
         // "Armature_Person" and marked as Runtime Armature instead of Authortime Armature
         var myArmature:IKArmature = IKManager.getArmatureByName("Armature_Person");
         
         // Allow armature to perform inverse kinematic
         // movement at run time
         myArmature.registerElements(stage);
         
         // Allow user to track armature and perform
         // IK movement with the mouse
         IKManager.trackIKArmature(myArmature, true);
         

Poniższy przykład ilustruje użycie metody registerElements() w celu zainicjowania szkieletu, który nie znajduje się w pierwszej klatce sceny. W celu zainicjowania szkieletu należy dołączyć następujący kod do pierwszej klatki zawierającej szkielet:

         import fl.ik.*;
         var arm:IKArmature = IKManager.getArmatureAt(0);
         arm.registerElements(stage);
         




[ X ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.