MotionBase

Pakket	fl.motion
Klasse	public class MotionBase
Overerving	MotionBase Object
Subklassen	Motion

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

De klasse MotionBase slaat een hoofdframe-animatiereeks op die op een visueel object kan worden toegepast. De animatiegegevens hebben betrekking op positie, schaal, rotatie, scheeftrekking, kleur, filters en versnelling. De klasse MotionBase bevat methoden om gegevens op specifieke punten in het hoofdframe op het halen. Gebruik de klasse Motion om geïnterpoleerde waarden tussen hoofdframes op te halen.

Bekijk de voorbeelden

Verwante API-elementen

Motion-klasse
Elementen van bewegings-XML

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
		duration : int Hiermee wordt de duur van de bewegingsinstantie ingesteld, gemeten in frames.	MotionBase
		is3D : Boolean Bepaalt of de beweging gewijzigde 3D-eigenschappen bevat.	MotionBase
		keyframes : Array Een array van hoofdframes die het gedrag van de beweging in de loop van de tijd definieert.	MotionBase

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		MotionBase(xml:XML = null) Constructor voor MotionBase-instanties.	MotionBase
		addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Hiermee wordt een filtereigenschap voor een Motion-object gewijzigd in alle corresponderende hoofdframes.	MotionBase
		addKeyframe(newKeyframe:KeyframeBase):void Hiermee wordt een hoofdframeobject aan de instantie Motion toegevoegd.	MotionBase
		addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Slaat een array van waarden op in overeenkomstige hoofdframes voor een gedeclareerde eigenschap van de klasse Motion.	MotionBase
		getColorTransform(index:int):flash.geom:ColorTransform Hiermee wordt een geïnterpoleerd object ColorTransform opgehaald bij een specifieke tijdindex in de instantie Motion.	MotionBase
		getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase Hiermee wordt het hoofdframe opgehaald dat op dit moment op een specifiek frame in de instantie Motion actief is.	MotionBase
		getFilters(index:Number):Array Hiermee wordt een geïnterpoleerde array van filters opgehaald bij een bepaalde tijdindex in de instantie Motion.	MotionBase
		getMatrix(index:int):Matrix Retourneert het Matrix-object voor de opgegeven indexpositie van het animatieframe.	MotionBase
		getMatrix3D(index:int):Object Retourneert het Matrix3D-object voor de opgegeven indexpositie van het animatieframe.	MotionBase
		getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase Hiermee wordt het volgende hoofdframe na een specifiek frame in de instantie Motion opgehaald.	MotionBase
		getValue(index:Number, tweenableName:String):Number Hiermee wordt de waarde van een animatie-eigenschap opgehaald op een bepaald tijdstip.	MotionBase
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void Initialiseert de lijst met filters voor het doelobject en kopieert de lijst met filters naar elke Keyframe-instantie van het Motion-object.	MotionBase
		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
		overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void	MotionBase
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		setValue(index:int, tweenableName:String, value:Number):void Hiermee wordt de waarde ingesteld van een specifieke tweenbare eigenschap bij een opgegeven tijdindex in de instantie Motion.	MotionBase
		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
		useRotationConcat(index:int):Boolean Hiermee wordt het doelobject geroteerd wanneer gegevens voor de beweging door de methode addPropertyArray() worden verstrekt.	MotionBase
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object

Eigenschapdetails

duration

eigenschap

duration:int

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

Hiermee wordt de duur van de bewegingsinstantie ingesteld, gemeten in frames. De duur kan niet korter zijn dan de tijd die door de hoofdframes van de bewegingsinstantie wordt ingenomen.

De standaardwaarde is 0.

Implementatie
public function get duration():int
public function set duration(value:int):void

is3D

eigenschap

is3D:Boolean

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 10, AIR 1.5, AIR 1.0

Bepaalt of de beweging gewijzigde 3D-eigenschappen bevat. Als de waarde true is, bevat de beweging gewijzigde 3D-eigenschappen.

De standaardwaarde is false.

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

keyframes

eigenschap

public var keyframes:Array

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

Een array van hoofdframes die het gedrag van de beweging in de loop van de tijd definieert. Deze eigenschap is een verspreide array, waarbij een hoofdframe op een index in de array wordt geplaatst die overeenkomt met de eigen index. Een bewegingsobject met hoofdframes op 0 en 5 heeft een array van hoofdframes met een lengte van 6. Indexen van 0 en 5 in de array bevatten elk een hoofdframe, en indexen van 1 tot en met 4 bevatten waarden null.

Constructordetails

()

Constructor

public function MotionBase(xml:XML = null)

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

Constructor voor MotionBase-instanties. Standaard wordt automatisch één eerste hoofdframe met standaardtransformatie-eigenschappen gemaakt.

Parameters

xml:XML (default = null) — Optioneel XML-object E4X dat een bewegingsinstantie definieert.

Methodedetails

addFilterPropertyArray

()

methode

 public function addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

Hiermee wordt een filtereigenschap voor een Motion-object gewijzigd in alle corresponderende hoofdframes. Roep initFilters() aan voordat u deze methode gebruikt. De volgorde van de waarden in de array bepaalt de toewijzing van elke waarde aan de eigenschap filter voor alle hoofdframes. Voor elke niet-lege waarde in de gegeven values-array, zoekt deze methode het hoofdframe dat overeenkomt met de indexpositie van de waarde in de array en wordt de naam-/waardecombinatie voor het filter in het hoofdframe opgeslagen.

Parameters

	`index:int` — De op nul gebaseerde indexpositie in de array van filters.

	`name:String` — De naam van de filtereigenschap die in elk hoofdframe moet worden opgeslagen.

	`values:Array` — De waardenarray voor de eigenschap die is opgegeven in de parameter `name`. Elke niet-lege waarde wordt aan de filter toegewezen in een hoofdframe dat overeenkomt met de index van de waarde in de array.

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

Verwante API-elementen

initFilters()
flash.filters

addKeyframe

()

methode

public function addKeyframe(newKeyframe:KeyframeBase):void

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

Hiermee wordt een hoofdframeobject aan de instantie Motion toegevoegd.

Parameters

newKeyframe:KeyframeBase — Een hoofdframe-object waarvan de indexeigenschap al is ingesteld.

Verwante API-elementen

fl.motion.Keyframe

addPropertyArray

()

methode

public function addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

Slaat een array van waarden op in overeenkomstige hoofdframes voor een gedeclareerde eigenschap van de klasse Motion. De volgorde van de waarden in de array bepaalt de toewijzing van elke waarde aan een hoofdframe. Voor elke niet-lege waarde in de gegeven values-array, zoekt deze methode het hoofdframe dat overeenkomt met de indexpositie van de waarde in de array, of maakt de methode een nieuw hoofdframe voor die indexpositie, en wordt de naam-/waardecombinatie van de eigenschap in het hoofdframe opgeslagen.

Parameters

	`name:String` — De naam van de eigenschap in de klasse Motion die in elk hoofdframe moet worden opgeslagen.

	`values:Array` — De waardenarray voor de eigenschap die is opgegeven in de parameter `name`. Elke niet-lege waarde wordt toegewezen aan een hoofdframe dat overeenkomt met de volgorde van de waarde in de array.

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

Verwante API-elementen

fl.motion.Motion

getColorTransform

()

methode

public function getColorTransform(index:int):flash.geom:ColorTransform

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

Hiermee wordt een geïnterpoleerd object ColorTransform opgehaald bij een specifieke tijdindex in de instantie Motion.

Parameters

index:int — De tijdindex van een frame in de instantie Motion, als een geheel getal dat groter dan of gelijk aan nul is.

Geretourneerde waarde

flash.geom:ColorTransform — Het geïnterpoleerde object ColorTransform.

Verwante API-elementen

flash.geom.ColorTransform

getCurrentKeyframe

()

methode

public function getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

Hiermee wordt het hoofdframe opgehaald dat op dit moment op een specifiek frame in de instantie Motion actief is. Een frame dat geen hoofdframe is, leidt de waarden af van het hoofdframe dat eraan voorafging.

Deze methode kan ook waarden op naam filteren van een specifieke tweenbare eigenschap. U kunt het hoofdframe vinden dat momenteel voor x actief is. Dit mag niet hetzelfde zijn als het hoofdframe dat over het algemeen actief is.

Parameters

	`index:int` — De index van een frame in de instantie Motion, als een geheel getal dat groter dan of gelijk aan nul is.

	`tweenableName:String` (default = "") — Optionele naam van een tweenbare eigenschap, zoals `"x"` of `"rotation"`.

Geretourneerde waarde

KeyframeBase — Het hoofdframe dat op of voor de opgegeven frame-index het meest overeenkomt.

Verwante API-elementen

fl.motion.Tweenables

getFilters

()

methode

public function getFilters(index:Number):Array

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

Hiermee wordt een geïnterpoleerde array van filters opgehaald bij een bepaalde tijdindex in de instantie Motion.

Parameters

index:Number — De tijdindex van een frame in de beweging, als een geheel getal dat groter dan of gelijk aan nul is.

Geretourneerde waarde

Array — De geïnterpoleerde array van filters. Wanneer er geen toepasbare filters zijn, wordt een lege array geretourneerd.

Verwante API-elementen

flash.filters

getMatrix

()

methode

public function getMatrix(index:int):Matrix

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 10, AIR 1.5, AIR 1.0

Retourneert het Matrix-object voor de opgegeven indexpositie van het animatieframe.

Parameters

index:int — De op nul gebaseerde indexpositie van het animatieframe dat de matrix bevat.

Geretourneerde waarde

Matrix — Het MatrixD-object, of de waarde null. Deze methode kan een null-waarde retourneren, zelfs als MotionBase.is3D false is, omdat wijzigingen in andere bewegingstweeneigenschappen zonder een Matrix-object kunnen worden gebruikt.

Verwante API-elementen

flash.geom.Matrix

getMatrix3D

()

methode

public function getMatrix3D(index:int):Object

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 10, AIR 1.5, AIR 1.0

Retourneert het Matrix3D-object voor de opgegeven indexpositie van het animatieframe.

Parameters

index:int — De op nul gebaseerde indexpositie van het animatieframe dat de 3D-matrix bevat.

Geretourneerde waarde

Object — Het Matrix3D-object, of de waarde null. Deze methode kan een null-waarde retourneren, zelfs als MotionBase.is3D waar is, omdat wijzigingen in andere 3D-bewegingstweeneigenschappen zonder Matrix3D-object kunnen worden gebruikt.

Verwante API-elementen

flash.geom.Matrix3D

getNextKeyframe

()

methode

public function getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

Hiermee wordt het volgende hoofdframe na een specifiek frame in de instantie Motion opgehaald. Wanneer een frame geen hoofdframe is en zich middenin een tween bevindt, leidt deze methode de waarden af van zowel het voorafgaande als het volgende hoofdframe.

Met deze methode kunt u op naam van een specifieke eigenschap tweenables filteren om het volgende hoofdframe voor een eigenschap te vinden; dit is in het algemeen niet altijd het volgende hoofdframe.

Parameters

	`index:int` — De index van een frame in de instantie Motion, als een geheel getal dat groter dan of gelijk aan nul is.

	`tweenableName:String` (default = "") — Optionele naam van een tweenbare eigenschap, zoals `"x"` of `"rotation"`.

Geretourneerde waarde

KeyframeBase — Het hoofdframe dat na de aangeboden frame-index het meest overeenkomt.

Verwante API-elementen

fl.motion.Tweenables

getValue

()

methode

public function getValue(index:Number, tweenableName:String):Number

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

Hiermee wordt de waarde van een animatie-eigenschap opgehaald op een bepaald tijdstip.

Parameters

	`index:Number` — De tijdindex van een frame in de instantie Motion, als een geheel getal dat groter dan of gelijk aan nul is.

	`tweenableName:String` — De naam van een tweenbare eigenschap, zoals `"x"` of `"rotation"`.

Geretourneerde waarde

Number — De numerieke waarde voor de eigenschap die is opgegeven in de parameter tweenableName.

Verwante API-elementen

fl.motion.Tweenables

initFilters

()

methode

 public function initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

Initialiseert de lijst met filters voor het doelobject en kopieert de lijst met filters naar elke Keyframe-instantie van het Motion-object.

Parameters

	`filterClasses:Array` — Een array met filterklassen. Elk item in de array is de volledig gekwalificeerde klassenaam (als een tekenreeks) voor het filtertype dat deze index in beslag neemt.

	`gradientSubarrayLengths:Array` — Een array met getallen die een waarde bevatten voor elk filter dat in de lijst met filters staat voor de beweging (elke klassenaam in de array `filterClasses`). Een waarde in de array `gradientSubarrayLengths` wordt alleen gebruikt als de vermelding van de filterklasse op dezelfde indexpositie in de array `filterClasses` GradientGlowFilter of GradientBevelFilter is. De corresponderende waarde in de array `gradientSubarrayLengths` is een getal dat de lengte bepaalt voor de arrays die de parameters `colors`, `alphas` en `ratios` initialiseren voor de constructorfuncties GradientGlowFilter en GradientBevelFilter.

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

Verwante API-elementen

flash.filters
flash.filters.GradientGlowFilter
flash.filters.GradientBevelFilter

overrideTargetTransform

()

methode

public function overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void

Parameters

	`scale:Boolean` (default = `true`)

	`skew:Boolean` (default = `true`)

	`rotate:Boolean` (default = `true`)

setValue

()

methode

public function setValue(index:int, tweenableName:String, value:Number):void

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 9.0.28.0, AIR 1.0

Hiermee wordt de waarde ingesteld van een specifieke tweenbare eigenschap bij een opgegeven tijdindex in de instantie Motion. Wanneer een hoofdframe niet in de index bestaat, wordt er automatisch een gemaakt.

Parameters

	`index:int` — De tijdindex van een frame in de instantie Motion, als een geheel getal dat groter dan nul is. Wanneer de index nul is, worden er geen wijzigingen aangebracht. Transformatie-eigenschappen zijn relatief ten opzichte van de begintransformatiewaarden van het doelobject; de waarden voor het eerste frame (met indexwaarde nul) zijn altijd standaardwaarden en mogen niet worden gewijzigd.

	`tweenableName:String` — De naam van de eigenschap van een tweenbaar item als een tekenreeks (zoals `"x"` of `"rotation"`).

	`value:Number` — De nieuwe waarde van de tweenbare eigenschap.

Verwante API-elementen

fl.motion.Tweenables

useRotationConcat

()

methode

public function useRotationConcat(index:int):Boolean

Taalversie:

ActionScript 3.0

Productversie:

Flash CS3

Runtimeversies:

Flash Player 10, AIR 1.5, AIR 1.0

Hiermee wordt het doelobject geroteerd wanneer gegevens voor de beweging door de methode addPropertyArray() worden verstrekt.

Parameters

index:int — De indexpositie van het frame met animatie.

Geretourneerde waarde

Boolean — Hiermee wordt aangegeven of het doelobject roteert met de opgeslagen eigenschap vanuit KeyframeBase.rotationConcat.

Verwante API-elementen

addPropertyArray()
fl.motion.KeyframeBase.rotationConcat

Voorbeelden Hoe dit voorbeeld te gebruiken

MotionBaseExample.as

In dit voorbeeld wordt weergegeven hoe u een sprite kunt animeren met behulp van de klassen MotionBase en AnimatorFactory. Aan een MotionBase-object worden arrays van x- en y-coördinaten toegewezen; dit wordt vervolgens gebruikt om een AnimatorFactory-object te maken. De AnimatorFactory wordt uiteindelijk ingesteld op een sprite, in de vorm van een gevulde rechthoek.

package 
{
     import flash.display.MovieClip;
     import flash.display.Sprite;
     import fl.motion.AnimatorFactory;
     import fl.motion.MotionBase;
     import flash.geom.Point;
    
     public class  MotionBaseExample extends MovieClip
     {
          private var motionBase:MotionBase;
          private var animFactory:AnimatorFactory;
          private var size:uint    = 100;
          private var bgColor:uint = 0xFFCC00;

          public function MotionBaseExample():void
          {
               var boxObj:sprite = new Sprite();
               boxObj.graphics.beginFill(bgColor);
               boxObj.graphics.drawRect(0, 0, size, size);
               boxObj.graphics.endFill();
               addChild(boxObj);

               motionBase = new MotionBase();
               motionBase.duration = 20;
               motionBase.addPropertyArray("x",[0,50,95,134,169,199,225,247,265,280]);
               motionBase.addPropertyArray("y",[0,1,0,4,12,21,32,44,52,38]);
               animFactory = new AnimatorFactory(motionBase);
               animFactory.transformationPoint = new Point(2, 2);
               animFactory.addTarget(boxObj, 0);
          }
     }    
}

Juridische kennisgeving | Online privacybeleid

MotionBase - AS3 Flash

Pakkettenx

Taalelementen

Bijlagen

Pakket fl.motion

duration

is3D

keyframes

MotionBase

addFilterPropertyArray

addKeyframe

addPropertyArray

getColorTransform

getCurrentKeyframe

getFilters

getMatrix

getMatrix3D

getNextKeyframe

getValue

initFilters

overrideTargetTransform

setValue

useRotationConcat