MotionBase

Paket	fl.motion
Klasse	public class MotionBase
Vererbung	MotionBase Object
Unterklassen	Motion

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

In der MotionBase-Klasse wird eine Schlüsselbildanimationssequenz gespeichert, die auf ein visuelles Objekt angewendet werden kann. Die Animationsdaten beinhalten Position, Skalierung, Drehung, Neigung, Farbe, Filter und Beschleunigung. Die MotionBase-Klasse verfügt über Methoden zum Abrufen von Daten an bestimmten Schlüsselbildpunkten. Um interpolierte Werte zwischen Schlüsselbildern zu erhalten, verwenden Sie die Motion-Klasse.

Beispiele anzeigen

Verwandte API-Elemente

Motion-Klasse
Motion-XML-Elemente

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		duration : int Steuert die zeitliche Länge der Motion-Instanz, gemessen in Bildern.	MotionBase
		is3D : Boolean Gibt an, ob die Bewegung 3D-Eigenschaften enthält.	MotionBase
		keyframes : Array Ein Array von Schlüsselbildern, die das Verhalten der Motion-Instanz im Laufe der Zeit definieren.	MotionBase

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		MotionBase(xml:XML = null) Konstruktor für MotionBase-Instanzen.	MotionBase
		addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Modifiziert eine Filtereigenschaft in allen entsprechenden Schlüsselbildern für ein Motion-Objekt.	MotionBase
		addKeyframe(newKeyframe:KeyframeBase):void Fügt der Motion-Instanz ein Schlüsselbildobjekt hinzu.	MotionBase
		addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Speichert ein Array von Werten in entsprechenden Schlüsselbildern für eine deklarierte Eigenschaft der Motion-Klasse.	MotionBase
		getColorTransform(index:int):flash.geom:ColorTransform Ruft ein interpoliertes ColorTransform-Objekt an einer bestimmten Zeitindexposition in der Motion-Instanz ab.	MotionBase
		getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase Ruft das Schlüsselbild ab, das derzeit in einem bestimmten Bild einer Motion-Instanz aktiv ist.	MotionBase
		getFilters(index:Number):Array Ruft ein interpoliertes Filter-Array an einer bestimmten Zeitindexposition in der Motion-Instanz ab.	MotionBase
		getMatrix(index:int):Matrix Gibt das Matrix-Objekt für die angegebene Indexposition des Animationsbilds zurück.	MotionBase
		getMatrix3D(index:int):Object Gibt das Matrix3D-Objekt für die angegebene Indexposition des Animationsbilds zurück.	MotionBase
		getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase Ruft das nächste Schlüsselbild nach einem bestimmten Bild in der Motion-Instanz ab.	MotionBase
		getValue(index:Number, tweenableName:String):Number Ruft den Wert einer Animationseigenschaft zu einem bestimmten Zeitpunkt ab.	MotionBase
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void Initialisiert die Filterliste für das Zielobjekt und kopiert die Filterliste in jede Keyframe-Instanz des Motion-Objekts.	MotionBase
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void	MotionBase
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		setValue(index:int, tweenableName:String, value:Number):void Legt den Wert einer bestimmten tweenbaren Eigenschaft an einer gegebenen Zeitindexposition in der Motion-Instanz fest.	MotionBase
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		useRotationConcat(index:int):Boolean Dreht das Zielobjekt, wenn von der addPropertyArray()-Methode Daten für die Bewegung bereitgestellt werden.	MotionBase
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Eigenschaftendetails

duration

Eigenschaft

duration:int

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Steuert die zeitliche Länge der Motion-Instanz, gemessen in Bildern. Die Dauer kann nicht unter der von den Schlüsselbildern der Motion-Instanz belegten Zeit liegen.

Der Standardwert ist 0.

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

is3D

Eigenschaft

is3D:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 10, AIR 1.5, AIR 1.0

Gibt an, ob die Bewegung 3D-Eigenschaften enthält. Bei der Einstellung true enthält die Bewegung Änderungen an 3D-Eigenschaften.

Der Standardwert ist false.

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

keyframes

Eigenschaft

public var keyframes:Array

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Ein Array von Schlüsselbildern, die das Verhalten der Motion-Instanz im Laufe der Zeit definieren. Diese Eigenschaft ist ein weites Array, bei dem ein Schlüsselbild an einer Indexposition im Array platziert wird, die der eigenen Indexposition entspricht. Ein Motion-Objekt mit Schlüsselbildern an Position 0 und 5 verfügt über ein Schlüsselbild-Array mit einer Länge von 6. Die Indexpositionen 0 und 5 im Array enthalten je ein Schlüsselbild. Die Indexpositionen 1 bis 4 haben Null-Werte.

Konstruktordetails

()

Konstruktor

public function MotionBase(xml:XML = null)

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Konstruktor für MotionBase-Instanzen. Standardmäßig wird automatisch ein Anfangsschlüsselbild mit standardmäßigen Transformationseigenschaften erstellt.

Parameter

xml:XML (default = null) — Optionales E4X-XML-Objekt, das eine Motion-Instanz definiert.

Methodendetails

addFilterPropertyArray

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Modifiziert eine Filtereigenschaft in allen entsprechenden Schlüsselbildern für ein Motion-Objekt. Rufen Sie initFilters() auf, bevor Sie diese Methode verwenden. Die Reihenfolge der Werte im Array bestimmt die Zuweisung der einzelnen Werte zur Filtereigenschaft für alle Schlüsselbilder. Für jeden Nicht-Null-Wert im angegebenen values-Array sucht diese Methode das Schlüsselbild, das der Indexposition des Werts im Array entspricht, und speichert das Eigenschaftenname/Wert-Paar für den Filter im Schlüsselbild.

Parameter

	`index:int` — Die auf null basierende Indexposition im Filterarray.

	`name:String` — Der Name der Filtereigenschaft, die in jedem Schlüsselbild gespeichert werden soll.

	`values:Array` — Das Array von Werten für die im `name`-Parameter angegebene Eigenschaft. Jeder Nicht-Null-Wert wird dem Filter in einem Schlüsselbild zugewiesen, das dem Index des Werts im Array entspricht.

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

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

Verwandte API-Elemente

initFilters()
flash.filters

addKeyframe

()

Methode

public function addKeyframe(newKeyframe:KeyframeBase):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Fügt der Motion-Instanz ein Schlüsselbildobjekt hinzu.

Parameter

newKeyframe:KeyframeBase — Ein Schlüsselbildobjekt, für das bereits eine Indexeigenschaft festgelegt wurde.

Verwandte API-Elemente

fl.motion.Keyframe

addPropertyArray

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Speichert ein Array von Werten in entsprechenden Schlüsselbildern für eine deklarierte Eigenschaft der Motion-Klasse. Die Reihenfolge der Werte im Array bestimmt die Zuweisung der einzelnen Werte zu einem Schlüsselbild. Für jeden Nicht-Null-Wert im gegebenen values-Array sucht diese Methode das Schlüsselbild, das der Indexposition des Werts im Array entspricht, oder erstellt ein neues Schlüsselbild für diese Indexposition und speichert das Eigenschaftenname/Wert-Paar im Schlüsselbild.

Parameter

	`name:String` — Der Name der Eigenschaft der Motion-Klasse, die in jedem Schlüsselbild gespeichert werden soll.

	`values:Array` — Das Array von Werten für die im `name`-Parameter angegebene Eigenschaft. Jeder Nicht-Null-Wert wird einem Schlüsselbild zugewiesen, das der Position des Werts im Array entspricht.

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

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

Verwandte API-Elemente

fl.motion.Motion

getColorTransform

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Ruft ein interpoliertes ColorTransform-Objekt an einer bestimmten Zeitindexposition in der Motion-Instanz ab.

Parameter

index:int — Die Zeitindexposition eines Bilds in der Motion-Instanz als Ganzzahl größer als oder gleich Null.

Rückgabewerte

flash.geom:ColorTransform — Das interpolierte ColorTransform-Objekt.

Verwandte API-Elemente

flash.geom.ColorTransform

getCurrentKeyframe

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Ruft das Schlüsselbild ab, das derzeit in einem bestimmten Bild einer Motion-Instanz aktiv ist. Ein Bild, das kein Schlüsselbild ist, erhält seine Werte von dem vorausgehenden Schlüsselbild.

Mit dieser Methode können auch anhand des Namens einer spezifischen tweenbaren Eigenschaft Werte gefiltert werden. Sie können das derzeit aktive Schlüsselbild für x suchen, das in der Regel nicht unbedingt dem derzeit aktiven Schlüsselbild entspricht.

Parameter

	`index:int` — Die Indexposition eines Bilds in der Motion-Instanz als Ganzzahl größer als oder gleich null.

	`tweenableName:String` (default = "") — Der optionale Name einer tweenbaren Eigenschaft (z. B. `"x"` oder `"rotation"`).

Rückgabewerte

KeyframeBase — Das am weitesten übereinstimmende Schlüsselbild an oder vor der angegebenen Indexposition des Bildes.

Verwandte API-Elemente

fl.motion.Tweenables

getFilters

()

Methode

public function getFilters(index:Number):Array

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Ruft ein interpoliertes Filter-Array an einer bestimmten Zeitindexposition in der Motion-Instanz ab.

Parameter

index:Number — Die Zeitindexposition eines Bildes in der Motion-Instanz als Ganzzahl größer als oder gleich null.

Rückgabewerte

Array — Das interpolierte Filter-Array. Falls keine anwendbaren Filter vorhanden sind, wird ein leeres Array zurückgegeben.

Verwandte API-Elemente

flash.filters

getMatrix

()

Methode

public function getMatrix(index:int):Matrix

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 10, AIR 1.5, AIR 1.0

Gibt das Matrix-Objekt für die angegebene Indexposition des Animationsbilds zurück.

Parameter

index:int — Die auf null basierende Indexposition des Animationsbilds, das die Matrix enthält.

Rückgabewerte

Matrix — Das Matrix-Objekt oder ein Null-Wert. Diese Methode kann den Wert null zurückgeben, selbst wenn MotionBase.is3D den Wert false aufweist, da Änderungen an anderen Bewegungs-Tween-Eigenschaften ohne ein Matrix-Objekt verwendet werden können.

Verwandte API-Elemente

flash.geom.Matrix

getMatrix3D

()

Methode

public function getMatrix3D(index:int):Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 10, AIR 1.5, AIR 1.0

Gibt das Matrix3D-Objekt für die angegebene Indexposition des Animationsbilds zurück.

Parameter

index:int — Die auf null basierende Indexposition des Animationsbilds, das die 3D-Matrix enthält.

Rückgabewerte

Object — Das Matrix3D-Objekt oder ein Null-Wert. Diese Methode kann den Wert null zurückgeben, selbst wenn MotionBase.is3D den Wert true aufweist, da Änderungen an anderen 3D-Bewegungs-Tween-Eigenschaften ohne ein Matrix3D-Objekt verwendet werden können.

Verwandte API-Elemente

flash.geom.Matrix3D

getNextKeyframe

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Ruft das nächste Schlüsselbild nach einem bestimmten Bild in der Motion-Instanz ab. Handelt es sich bei einem Bild nicht um ein Schlüsselbild und liegt dieses Bild in der Mitte eines Tweens, erhält diese Methode seine Werte sowohl vom vorangehenden als auch vom nachfolgenden Schlüsselbild.

Mit dieser Methode können Sie auch nach dem Namen einer bestimmten tweenbaren Eigenschaft filtern, um das nächste Schlüsselbild für eine Eigenschaft zu finden, das nicht unbedingt das nächste Schlüsselbild überhaupt sein muss.

Parameter

	`index:int` — Die Indexposition eines Bilds in der Motion-Instanz als Ganzzahl größer als oder gleich null.

	`tweenableName:String` (default = "") — Der optionale Name einer tweenbaren Eigenschaft (z. B. `"x"` oder `"rotation"`).

Rückgabewerte

KeyframeBase — Das am weitesten übereinstimmende Schlüsselbild nach der angegebenen Indexposition des Bildes.

Verwandte API-Elemente

fl.motion.Tweenables

getValue

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Ruft den Wert einer Animationseigenschaft zu einem bestimmten Zeitpunkt ab.

Parameter

	`index:Number` — Die Zeitindexposition eines Bilds in der Motion-Instanz als Ganzzahl größer als oder gleich Null.

	`tweenableName:String` — Der Name einer tweenbaren Eigenschaft (z. B. `"x"` oder `"rotation"`).

Rückgabewerte

Number — Der Nummernwert für die Eigenschaft, die im tweenableName-Parameter angegeben wird.

Verwandte API-Elemente

fl.motion.Tweenables

initFilters

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Initialisiert die Filterliste für das Zielobjekt und kopiert die Filterliste in jede Keyframe-Instanz des Motion-Objekts.

Parameter

	`filterClasses:Array` — Ein Array von Filterklassen. Jedes Element im Array ist der vollständige Klassenname (in Stringform) für den Filtertyp, der diese Indexposition belegt.

	`gradientSubarrayLengths:Array` — Ein Array von Zahlen mit einem Wert für jeden Filter, der in der Filterliste der Bewegung aufgeführt ist (jeder Klassenname im `filterClasses`-Array). Ein Wert im `gradientSubarrayLengths`-Array wird nur verwendet, wenn der Filterklasseneintrag an derselben Indexposition im `filterClasses`-Array GradientGlowFilter oder GradientBevelFilter ist. Der entsprechende Wert im `gradientSubarrayLengths`-Array ist eine Zahl, die die Länge für die Arrays, die die Parameter `colors`, `alphas` und `ratios` für die Konstruktorfunktionen GradientGlowFilter und GradientBevelFilter initialisieren, bestimmt.

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

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

Verwandte API-Elemente

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

overrideTargetTransform

()

Methode

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

Parameter

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

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

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

setValue

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Legt den Wert einer bestimmten tweenbaren Eigenschaft an einer gegebenen Zeitindexposition in der Motion-Instanz fest. Ist an der Indexposition kein Schlüsselbild vorhanden, wird automatisch ein Schlüsselbild erstellt.

Parameter

	`index:int` — Die Zeitindexposition eines Bilds in der Motion-Instanz als Ganzzahl größer als null. Ist die Indexposition null, wird keine Änderung vorgenommen. Transformationseigenschaften sind relativ zu den Anfangstransformationswerten des Zielobjekts, die Werte für das erste Bild (Indexwert null) sind immer Standardwerte und sollten nicht geändert werden.

	`tweenableName:String` — Der Name einer tweenbaren Eigenschaft als String (z. B. `"x"` oder `"rotation"`).

	`value:Number` — Der neue Wert der tweenbaren Eigenschaft.

Verwandte API-Elemente

fl.motion.Tweenables

useRotationConcat

()

Methode

public function useRotationConcat(index:int):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 10, AIR 1.5, AIR 1.0

Dreht das Zielobjekt, wenn von der addPropertyArray()-Methode Daten für die Bewegung bereitgestellt werden.

Parameter

index:int — Die Indexposition des Animationsbilds.

Rückgabewerte

Boolean — Gibt an, ob das Zielobjekt mit der gespeicherten Eigenschaft aus KeyframeBase.rotationConcat gedreht wird.

Verwandte API-Elemente

addPropertyArray()
fl.motion.KeyframeBase.rotationConcat

Beispiele Verwendung dieses Beispiels

MotionBaseExample.as

In diesem Beispiel wird gezeigt, wie ein Sprite unter Verwendung der MotionBase- und AnimatorFactory-Klasse animiert wird. Einem MotionBase-Objekt werden Arrays von x- und y-Koordinaten zugewiesen und es wird dann zum Erstellen eines AnimatorFactory-Objekts verwendet. AnimatorFactory zielt dann in Form eines ausgefüllten Rechtecks auf ein Sprite.

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

Rechtliche Hinweise | Onlinedatenschutzerklärung

MotionBase - AS3 Flash

Klassen x

duration

is3D

keyframes

MotionBase

addFilterPropertyArray

addKeyframe

addPropertyArray

getColorTransform

getCurrentKeyframe

getFilters

getMatrix

getMatrix3D

getNextKeyframe

getValue

initFilters

overrideTargetTransform

setValue

useRotationConcat