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

Pakket	fl.ik
Klasse	public class IKArmature
Overerving	IKArmature Object

Taalversie:

ActionScript 3.0

Productversie:

Flash CS4

Runtimeversies:

Flash Player 10, AIR 1.5

De klasse IKArmature beschrijft een IK-armatuur (inverse kinematics). Een armatuur is een verzameling segmenten, "ruggen" genoemd, die met elkaar zijn verbonden op "joints". Een armatuur wordt vaak beschreven als een boom- of kettingstructuur. Armaturen kunnen gebruik maken van de veer- en dempingsfuncties van de dynamische fysica-engine via de springsEnabled-eigenschap.

Omdat armaturen alleen in het Flash-ontwerpgereedschap kunnen worden gemaakt, mag u de constructor van de klasse IKArmature niet gebruiken om instanties van deze klasse te maken. Flash Player maakt alle instanties van de klasse IKArmature wanneer de uitvoering van een SWF-bestand start. U kunt een verwijzing naar een armatuur maken met de methode getArmatureAt() of de methode getArmatureByName() in de klasse IKManager.

Opmerking: als de armatuur zich niet op het eerste frame van de eerste scène bevindt, gebruikt u de methode registerElements() om de armatuur te initialiseren voor een bepaald DisplayObject.

Verwante API-elementen

fl.ik.IKManager.getArmatureAt()
fl.ik.IKManager.getArmatureByName()

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
		container : DisplayObjectContainer [alleen-lezen] Retourneert DisplayObjectContainer dat in een oproep aan registerElements wordt doorgegeven.	IKArmature
		name : String [alleen-lezen] De naam van de armatuur.	IKArmature
		rootJoint : IKJoint [alleen-lezen] De hoofdjoint in de armatuur.	IKArmature
		springsEnabled : Boolean Geeft aan of er voor een armatuur veren zijn ingeschakeld.	IKArmature

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		getBoneByName(targetName:String):IKBone Retourneert de opgegeven rug.	IKArmature
		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
		registerElements(container:DisplayObjectContainer):* Activeert IK-verplaatsing (inverse kinematic) voor een instantie van een symbool in de bibliotheek dat een armatuur bevat.	IKArmature
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		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
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object

Eigenschapdetails

container

eigenschap

container:DisplayObjectContainer [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Retourneert DisplayObjectContainer dat in een oproep aan registerElements wordt doorgegeven.

Implementatie
public function get container():DisplayObjectContainer

name

eigenschap

name:String [alleen-lezen]

Taalversie:

ActionScript 3.0

Productversie:

Flash CS4

Runtimeversies:

Flash Player 10, AIR 1.5

De naam van de armatuur. De naam van een armatuur kan alleen worden opgegeven in het Flash-ontwerpgereedschap.

Implementatie
public function get name():String

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld ziet u hoe u de naam ophaalt van de eerste armatuur in een document.

         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

eigenschap

rootJoint:IKJoint [alleen-lezen]

Taalversie:

ActionScript 3.0

Productversie:

Flash CS4

Runtimeversies:

Flash Player 10, AIR 1.5

De hoofdjoint in de armatuur. Elke armatuur bevat exact één hoofdjoint, maar kan meerdere onderliggende joints bevatten. U kunt een armatuur doorlopen door de hoofdjoint op te halen en met behulp van methoden uit de klasse IKJoint van de ene joint naar de andere joint te gaan.

Implementatie
public function get rootJoint():IKJoint

Verwante API-elementen

fl.ik.IKJoint

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld ziet u hoe u de eerste armatuur in een document ophaalt en de hoofdjoint van die armatuur ophaalt:

         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

eigenschap

springsEnabled:Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 1.5

Geeft aan of er voor een armatuur veren zijn ingeschakeld. Wanneer deze waarde true is, kan de armatuur gebruik maken van de nieuwe dynamische fysica-engine, die veer en demping aan de animatie toevoegt. De standaardwaarde is true.

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

Implementatie
public function get springsEnabled():Boolean
public function set springsEnabled(value:Boolean):void

Methodedetails

getBoneByName

()

methode

public function getBoneByName(targetName:String):IKBone

Taalversie:

ActionScript 3.0

Productversie:

Flash CS4

Runtimeversies:

Flash Player 10, AIR 1.5

Retourneert de opgegeven rug. Aan elke rug kan een naam worden toegewezen in het Flash-ontwerpgereedschap. Gebruik deze methode om een verwijzing naar een rug te maken zodat u de rug in runtime kunt manipuleren.

Parameters

targetName:String

Geretourneerde waarde

IKBone — Een IKBone-instantie opgegeven door de parameter targetName.

Verwante API-elementen

IKBone-klasse

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld ziet u hoe u een rug met de naam "firstBone" ophaalt en de rug toewijst aan een variabele met de naam "bone":

         import fl.ik.*;
         // Retrieve bone named "firstBone" and store in variable "bone"
         var bone:IKBone = IKArmature.getBoneByName("firstBone");

registerElements

()

methode

public function registerElements(container:DisplayObjectContainer):*

Taalversie:

ActionScript 3.0

Productversie:

Flash CS4

Runtimeversies:

Flash Player 10, AIR 1.5

Activeert IK-verplaatsing (inverse kinematic) voor een instantie van een symbool in de bibliotheek dat een armatuur bevat. Een filmclip in de bibliotheek die een armatuur bevat en in runtime wordt geactiveerd, moet deze methode aanroepen om runtime IK-effecten te activeren.

Opmerking: deze methode moet worden aangeroepen als de armatuur zich niet op het eerste frame van de eerste scène bevindt.

Parameters

container:DisplayObjectContainer — Een verwijzing naar het werkgebied, dat toegankelijk is via de eigenschap stage van een willekeurig DisplayObject dat in het weergaveoverzicht voorkomt.

Geretourneerde waarde

*

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld ziet u hoe u IK-verplaatsing activeert voor een bibliotheeksymbool dat in runtime wordt geactiveerd. Het bibliotheeksymbool is een filmclip met de naam "IKPerson" die een armatuur bevat.

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

In het volgende voorbeeld ziet u hoe u de methode registerElements() gebruikt om een armatuur te initialiseren die zich niet in het eerste frame van een scène bevindt. Als u een armatuur wilt initialiseren, koppelt u de volgende code aan het eerste frame met de armatuur:

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

Juridische kennisgeving | Online privacybeleid

IKArmature - AS3 Flash

Pakkettenx

Taalelementen

Bijlagen

Pakket fl.ik

container

name

rootJoint

springsEnabled

getBoneByName

registerElements