Paket | spark.effects.animation |
Klasse | public final class Animation |
Vererbung | Animation Object |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Diese Klasse definiert die Zeit und den Wert der Animation. In weiterem Code, entweder in Effekten oder in Anwendungscode, wird die Animation mit Zielobjekten und Eigenschaften verknüpft, sodass die animierten Werte, die von der Animation-Klasse produziert werden, anschließend auf die Zielobjekte und Eigenschaften angewendet werden können, was letztendlich dazu führt, dass diese Objekte animiert werden.
Wenn Sie Animationseffekte definieren, erstellen Sie normalerweise eine Instanz der Animate-Klasse oder eine Unterklasse der Animation. Auf diese Weise wird eine Animation-Instanz in der play()
-Methode erstellt. Die Animation-Instanz akzeptiert Start- und Endwerte, eine Dauer und optionale Parameter wie easer- und interpolator-Objekte.
Das Animation-Objekt ruft am Anfang und Ende der Animation, wenn die Animation wiederholt wird sowie in regelmäßigen Aktualisierungsintervallen während der Animation, Ereignis-Listener auf. Bei diesen Aufrufen werden Werte übergeben, die von der Animation-Instanz auf Grundlage der Anfangs- und Endwerte sowie der easer- und interpolator-Objekte berechnet wurden. Diese Werte können anschließend verwendet werden, um Eigenschaftswerte für Zielobjekte einzustellen.
Standard-MXML-EigenschaftmotionPaths
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
animationTarget : spark.effects.animation:IAnimationTarget
Das IAnimationTarget-Objekt, das bei allen start-, end-, repeat- und update-Ereignissen für diese Animation benachrichtigt wird. | Animation | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
currentValue : Object
Ein Objekt, das die berechneten Werte als aktuelles Bild der Animation enthält. | Animation | ||
cycleFraction : Number [schreibgeschützt]
Der aktuell abgelaufene Teil der Animation, nachdem die Beschleunigung angewendet wurde. | Animation | ||
cycleTime : Number [schreibgeschützt]
Die aktuelle Position der Millisekunden im aktuellen Animationszyklus. | Animation | ||
duration : Number = 500
Die Länge der Animation in Millisekunden, wobei die durch die repeatCount-Eigenschaft definierten Wiederholungen nicht berücksichtigt werden. | Animation | ||
easer : IEaser
Das Beschleunigungsverhalten für diesen Effekt. | Animation | ||
interpolator : IInterpolator = null
Der Interpolator, der von der Animation-Instanz verwendet wird, um Werte zwischen dem Anfangs- und Endwert der Eigenschaft zu berechnen. | Animation | ||
isPlaying : Boolean [schreibgeschützt]
Bei „true“ wird die Animation gerade abgespielt. | Animation | ||
motionPaths : Vector.<MotionPath>
Die Gruppe von MotionPath-Objekten, die die Eigenschaften und Werte definiert, die die Animation über einen bestimmten Zeitraum animiert. | Animation | ||
playheadTime : Number
Die verstrichene Gesamtzeit der Animation einschließlich Startverzögerung und Wiederholungen. | Animation | ||
playReversed : Boolean
Bei „true“ wird die Animation umgekehrt abgespielt. | Animation | ||
repeatBehavior : String
Legt das Verhalten einer sich wiederholenden Animation fest. | Animation | ||
repeatCount : int
Die Anzahl an Wiederholungen für diese Animation. | Animation | ||
repeatDelay : Number
Die Dauer (in Millisekunden) der Verzögerung, bevor der nächste Wiederholungszyklus beginnt. | Animation | ||
startDelay : Number
Die Wartezeit, bevor die Animation beginnt. | Animation |
Methode | Definiert von | ||
---|---|---|---|
Animation(duration:Number = 500, property:String = null, startValue:Object = null, endValue:Object = null)
Konstruktor. | Animation | ||
Unterbricht die Animation, wechselt unmittelbar an das Ende der Animation und ruft die animationEnd()-Funktion auf dem animationTarget auf. | Animation | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Hält die Animation an, bis die resume()-Methode aufgerufen wird. | Animation | ||
Starten Sie die Animation. | Animation | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Setzt den Effekt fort, nachdem er durch Aufrufen der pause()-Methode vorübergehend unterbrochen wurde. | Animation | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Stoppt die Animation und beendet sie, ohne die end()-Methode aufzurufen. | Animation | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
animationTarget | Eigenschaft |
animationTarget:spark.effects.animation:IAnimationTarget
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Das IAnimationTarget-Objekt, das bei allen start-, end-, repeat- und update-Ereignissen für diese Animation benachrichtigt wird. Der Wert null
gibt an, dass kein Ziel zu benachrichtigen ist.
Der Standardwert ist null.
Implementierung
public function get animationTarget():spark.effects.animation:IAnimationTarget
public function set animationTarget(value:spark.effects.animation:IAnimationTarget):void
currentValue | Eigenschaft |
public var currentValue:Object
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ein Objekt, das die berechneten Werte als aktuelles Bild der Animation enthält. Die Werte werden als Matrixwerte gespeichert, wobei Eigenschaftsnamen als Schlüssel verwendet werden.
cycleFraction | Eigenschaft |
cycleFraction:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der aktuell abgelaufene Teil der Animation, nachdem die Beschleunigung angewendet wurde. Dieser Wert liegt zwischen 0 und 1. Als ein Zyklus einer Animation gilt eine einzige Wiederholung der Animation. Die repeatCount
-Eigenschaft legt die Anzahl der abgespielten Zyklen fest.
Implementierung
public function get cycleFraction():Number
cycleTime | Eigenschaft |
cycleTime:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die aktuelle Position der Millisekunden im aktuellen Animationszyklus. Dieser Wert liegt zwischen 0 und duration
. Als ein Zyklus einer Animation gilt eine einzige Wiederholung der Animation. Die repeatCount
-Eigenschaft legt die Anzahl der abgespielten Zyklen fest. Verwenden Sie die seek()
-Methode zum Ändern der Position der Animation.
Implementierung
public function get cycleTime():Number
duration | Eigenschaft |
public var duration:Number = 500
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Länge der Animation in Millisekunden, wobei die durch die repeatCount
-Eigenschaft definierten Wiederholungen nicht berücksichtigt werden.
Der Standardwert ist 500.
easer | Eigenschaft |
easer:IEaser
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Das Beschleunigungsverhalten für diesen Effekt. Dieses IEaser-Objekt wird verwendet, um den abgelaufenen Teil der Animation in einen beschleunigten Teil zu konvertieren, der anschließend verwendet wird, um den Wert für den beschleunigten abgelaufenen Teil zu berechnen.
Der Wert null
gibt an, dass keine Beschleunigung verwendet wird, was einer linearen Beschleunigung entspricht (animation.easer = Linear.getInstance();
).
Der Standardwert ist Sine(.5).
Implementierung
public function get easer():IEaser
public function set easer(value:IEaser):void
interpolator | Eigenschaft |
public var interpolator:IInterpolator = null
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Interpolator, der von der Animation-Instanz verwendet wird, um Werte zwischen dem Anfangs- und Endwert der Eigenschaft zu berechnen. Standardmäßig verwendet die Klasse die NumberInterpolator-Klasse. Wenn die Start- und Endwerte Arrays oder Vektoren sind, wird die Interpolation von der MultiValueInterpolator-Klasse verarbeitet. Die Interpolation von anderen Datentypen oder von Zahlen, die unterschiedlich zu interpolieren sind (z. B. uint
-Werte mit Farbkanalinformationen), können verarbeitet werden, indem ein anderer Interpolator verfügbar gemacht wird.
Verwandte API-Elemente
isPlaying | Eigenschaft |
isPlaying:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Bei true
wird die Animation gerade abgespielt. Der Wert ist auf false
eingestellt, es sei denn, die Animation wurde abgespielt und noch nicht gestoppt (entweder programmgesteuert oder automatisch) oder angehalten.
Der Standardwert ist false.
Implementierung
public function get isPlaying():Boolean
motionPaths | Eigenschaft |
public var motionPaths:Vector.<MotionPath>
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Gruppe von MotionPath-Objekten, die die Eigenschaften und Werte definiert, die die Animation über einen bestimmten Zeitraum animiert.
Verwandte API-Elemente
playheadTime | Eigenschaft |
playheadTime:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die verstrichene Gesamtzeit der Animation einschließlich Startverzögerung und Wiederholungen. Bei einer Animation, deren erster Zyklus abgespielt wird, entspricht dieser Wert dem Wert für cycleTime
.
Implementierung
public function get playheadTime():Number
public function set playheadTime(value:Number):void
playReversed | Eigenschaft |
playReversed:Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Bei true
wird die Animation umgekehrt abgespielt. Wenn die Animation derzeit in der entgegengesetzten Richtung des angegebenen Werts von playReversed
abgespielt wird, ändert die Animation die Richtung dynamisch.
Der Standardwert ist false.
Implementierung
public function get playReversed():Boolean
public function set playReversed(value:Boolean):void
repeatBehavior | Eigenschaft |
repeatBehavior:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Legt das Verhalten einer sich wiederholenden Animation fest. Für eine sich wiederholende Animation ist die repeatCount
-Eigenschaft auf 0 oder einen Wert größer als 1 eingestellt. Bei diesem Wert sollte es sich entweder um RepeatBehavior.LOOP
(die Animation wird immer in derselben Reihenfolge wiederholt) oder um RepeatBehavior.REVERSE
(für jede Iteration wird die Richtung der Animation umgekehrt) handeln.
Der Standardwert ist RepeatBehavior.LOOP.
Implementierung
public function get repeatBehavior():String
public function set repeatBehavior(value:String):void
Verwandte API-Elemente
repeatCount | Eigenschaft |
repeatCount:int
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Anzahl an Wiederholungen für diese Animation. Bei einem Wert von 0 wird sie unendlich oft abgespielt.
Der Standardwert ist 1.
Implementierung
public function get repeatCount():int
public function set repeatCount(value:int):void
repeatDelay | Eigenschaft |
repeatDelay:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Dauer (in Millisekunden) der Verzögerung, bevor der nächste Wiederholungszyklus beginnt. Indem dieser Wert auf eine Zahl ungleich null eingestellt wird, wird der vorherige Animationszyklus genau am Endwert beendet. Nicht verzögerte Wiederholungen können diesen Wert jedoch vollständig überspringen, da die Animation glatt vom Ende eines Zyklus auf den Anfang des nächsten Zyklus übergeht. Diese Eigenschaft muss einen Wert >= 0 aufweisen.
Diese Eigenschaft wird für die erste Wiederholung nach dem ersten Animationszyklus verwendet. Um den ersten Zyklus der Animation zu verzögern, verwenden Sie die startDelay
-Eigenschaft.
Der Standardwert ist 0.
Implementierung
public function get repeatDelay():Number
public function set repeatDelay(value:Number):void
Verwandte API-Elemente
startDelay | Eigenschaft |
startDelay:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Wartezeit, bevor die Animation beginnt. Diese Eigenschaft muss einen Wert >= 0 aufweisen.
Der Standardwert ist 0.
Implementierung
public function get startDelay():Number
public function set startDelay(value:Number):void
Animation | () | Konstruktor |
public function Animation(duration:Number = 500, property:String = null, startValue:Object = null, endValue:Object = null)
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor. Die optionalen Parameter property
, startValue
und endValue
definieren eine einfache Animation mit einem einzigen MotionPath-Objekt mit zwei Schlüsselbildern. Wenn einer der Werte ungleich null ist, wird startValue
zu value
des ersten KeyFrames, wobei „time“ = 0, und endValue
zum value
des zweiten KeyFrames am Ende der Animation.
duration:Number (default = 500 ) — Die Länge der Animation in Millisekunden.
| |
property:String (default = null ) — Die zu animierende Eigenschaft.
| |
startValue:Object (default = null ) — Der Ausgangswert der Eigenschaft.
| |
endValue:Object (default = null ) — Der letzte Wert der Eigenschaft.
|
end | () | Methode |
public function end():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Unterbricht die Animation, wechselt unmittelbar an das Ende der Animation und ruft die animationEnd()-Funktion auf dem animationTarget
auf.
pause | () | Methode |
public function pause():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Hält den Effekt an, bis die resume()
-Methode aufgerufen wird. Wenn stop()
vor resume()
aufgerufen wird, kann die Animation nicht fortgesetzt werden.
play | () | Methode |
public function play():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Starten Sie die Animation. Wenn die Animation bereits abgespielt wird, wird sie zunächst gestoppt und danach weiter abgespielt.
resume | () | Methode |
public function resume():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Setzt den Effekt fort, nachdem er durch Aufrufen der pause()
-Methode vorübergehend unterbrochen wurde.
stop | () | Methode |
public function stop():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Stoppt die Animation und beendet sie, ohne die end()
-Methode aufzurufen. Die animationStop()-Funktion auf dem animationTarget
wird aufgerufen.
Tue Jun 12 2018, 10:04 AM Z