Keyframe

Paket	spark.effects.animation
Klasse	public class Keyframe
Vererbung	Keyframe Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Die Keyframe-Klasse definiert den Wert einer Eigenschaft zu einer bestimmten Zeit während eines Effekts. Sie können beispielsweise drei Schlüsselbilder erstellen, die den Wert einer Eigenschaft zu Beginn des Effekts, am Mittelpunkt des Effekts und am Ende des Effekts definieren. Der Effekt animiert während der Ausführung des Effekts die Änderung der Eigenschaft des Ziels von Schlüsselbild zu Schlüsselbild.

Die Sammlung an Schlüsselbildern für einen Effekt wird als Bewegungspfad des Effekts bezeichnet. Ein Bewegungspfad kann eine beliebige Anzahl an Schlüsselbildern definieren. Anschließend berechnet der Effekt den Wert der Eigenschaft, indem er zwischen den von zwei Schlüsselbildern angegebenen Werten interpoliert.

Verwenden Sie die MotionPath-Klasse für die Sammlung der Keyframe-Objekte, die den Bewegungspfad des Effekts darstellen. Die MotionPath-Klasse gibt den Namen der Eigenschaft auf dem Ziel an. Die Sammlung von Keyframe-Objekten gibt die Werte der Eigenschaft zu verschiedenen Zeiten während des Effekts an.

MXML-Syntax expanded

MXML-Syntax ausblenden

The <s:Keyframe> tag inherits the tag attributes of its superclass, and adds the following tag attributes:

  <s:Keyframe 
    id="ID"
    easier="Linear"
    time="val"
    value="val"
    valueBy="val"
  />

Beispiele anzeigen

Verwandte API-Elemente

MotionPath

Ö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
		easer : IEaser Das auf die Bewegung angewendete Beschleunigungsverhalten zwischen dem vorhergehenden Keyframe-Objekt im Bewegungspfad und diesem Keyframe-Objekt.	Keyframe
		time : Number Der Zeitpunkt in Millisekunden, bis zu dem das Effektziel dieses Schlüsselbilds den durch den value-Parameter angegebenen Wert aufweisen sollte.	Keyframe
		value : Object Der Wert, den die Eigenschaft des Effektziels zu dem durch die time-Eigenschaft angegebenen Zeitpunkt aufweisen soll.	Keyframe
		valueBy : Object Optionaler Parameter, der, sofern angegeben, verwendet wird, um den value-Parameter für dieses oder das vorherige Schlüsselbild zu berechnen.	Keyframe

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		Keyframe(time:Number = NaN, value:Object = null, valueBy:Object = null) Konstruktor.	Keyframe
		clone():Keyframe Gibt eine Kopie dieses Keyframe-Objekts zurück.	Keyframe
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		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
		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
		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
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Eigenschaftendetails

easer

Eigenschaft

public var easer:IEaser

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Das auf die Bewegung angewendete Beschleunigungsverhalten zwischen dem vorhergehenden Keyframe-Objekt im Bewegungspfad und diesem Keyframe-Objekt. Standardmäßig erfolgt die Beschleunigung linear oder überhaupt nicht.

Beachten Sie, dass der übergeordnete Effekt die Beschleunigung möglicherweise bereits auf den gesamten Verlauf der Animation angewendet hat. Wenn daher stattdessen eine Beschleunigung pro Schlüsselbildintervall gewünscht wird, muss der Beschleuniger für den Gesamteffekt auf eine lineare Beschleunigung (spark.effects.easing.Linear) und anschließend der Beschleuniger (easer) auf jedem Schlüsselbild entsprechend festgelegt werden.

Da diese Eigenschaft im Intervall zwischen dem vorhergehenden Keyframe-Objekt in einer Sequenz und diesem Keyframe-Objekt verwendet wird, wird die easer-Eigenschaft auf dem ersten Keyframe-Objekt in einer Sequenz ignoriert.

Der Standardwert ist Linear.

time

Eigenschaft

public var time:Number

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Der Zeitpunkt in Millisekunden, bis zu dem das Effektziel dieses Schlüsselbilds den durch den value-Parameter angegebenen Wert aufweisen sollte. Dieser Zeitpunkt ist relativ zur Startzeit des Effekts, die für dieses Schlüsselbild definiert ist.

value

Eigenschaft

public var value:Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Der Wert, den die Eigenschaft des Effektziels zu dem durch die time-Eigenschaft angegebenen Zeitpunkt aufweisen soll.

valueBy

Eigenschaft

public var valueBy:Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Optionaler Parameter, der, sofern angegeben, verwendet wird, um den value-Parameter für dieses oder das vorherige Schlüsselbild zu berechnen. Wenn der value-Parameter im vorherigen Schlüsselbild nicht eingestellt ist, aber in diesem Schlüsselbild sowohl value als auch valueBy definiert werden, wird der value-Parameter für das vorherige Schlüsselbild mit der Gleichung value in diesem Schlüsselbild minus valueBy in diesem Schlüsselbild berechnet.

Wenn der value-Parameter in diesem Schlüsselbild nicht definiert ist, aber valueBy in diesem Schlüsselbild und value im vorherigen Schlüsselbild eingestellt sind, wird value in diesem Schlüsselbild durch die Gleichung value im vorherigen Schlüsselbild plus valueBy in diesem Schlüsselbild berechnet.

valueBy wird für das erste Schlüsselbild einer Sequenz ignoriert, da dieser Parameter nur auf das Intervall vor dem Schlüsselbild angewendet wird und das erste Schlüsselbild über kein vorheriges Intervall verfügt.

Konstruktordetails

()

Konstruktor

public function Keyframe(time:Number = NaN, value:Object = null, valueBy:Object = null)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Konstruktor.

Parameter

	`time:Number` (default = `NaN`) — Der Zeitpunkt in Millisekunden, bis zu dem das Effektziel dieses Schlüsselbilds den durch den `value`-Parameter angegebenen Wert aufweisen sollte.

	`value:Object` (default = `null`) — Der Wert, den das Effektziel zur angegebenen `time` aufweisen soll.

	`valueBy:Object` (default = `null`) — Optionaler Parameter, der, sofern angegeben, dazu führt, dass `value` dynamisch berechnet wird, indem `valueBy` zu `value` des vorherigen Schlüsselbilds innerhalb der Gruppe von Schlüsselbildern in einem MotionPath-Objekt hinzugefügt wird. Dieser Wert wird ignoriert, wenn es sich um das erste Schlüsselbild in einer Sequenz handelt.

Methodendetails

clone

()

Methode

public function clone():Keyframe

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Gibt eine Kopie dieses Keyframe-Objekts zurück.

Rückgabewerte

Keyframe — Eine Kopie dieses Keyframe-Objekts.

Beispiele Verwendung dieses Beispiels

KeyFrameEffectExample.mxml

<?xml version="1.0"?>
<!-- Simple example to demonstrate the s:Keyframe and s:MotionPath classes. -->
<s:Application
    xmlns:fx="http://ns.adobe.com/mxml/2009"
    xmlns:mx="library://ns.adobe.com/flex/mx"
    xmlns:s="library://ns.adobe.com/flex/spark">

    <fx:Declarations>
        <fx:Vector id="kf" type="spark.effects.animation.MotionPath">
            <s:MotionPath property="scaleX">
                <s:Keyframe time="250" value="0.5"/>
                <s:Keyframe time="500" value="1.0"/>
                <s:Keyframe time="750" value="0.5"/>
                <s:Keyframe time="1000" value="1.0"/> 
                <s:Keyframe time="1250" value="0.5"/>
                <s:Keyframe time="1500" value="1.0"/>
            </s:MotionPath> 
            <s:MotionPath property="scaleY">
                <s:Keyframe time="250" value="0.5"/>
                <s:Keyframe time="500" value="1.0"/>
                <s:Keyframe time="750" value="0.5"/>
                <s:Keyframe time="1000" value="1.0"/>
                <s:Keyframe time="1250" value="0.5"/>
                <s:Keyframe time="1500" value="1.0"/>
            </s:MotionPath>
        </fx:Vector>
        
        <s:Animate id="shrinkEffect"
            motionPaths="{kf}"
            target="{myImage}"/>
    </fx:Declarations>

    <s:Panel id="examplePanel"
        title="Keyframe and MotionPath Effect Example"
        width="75%" height="75%">
        <s:layout>
            <s:VerticalLayout paddingTop="10" paddingLeft="10"/>
        </s:layout>

        <!-- Directions -->
        <s:VGroup id="detailsBox" width="50%" left="0">
            <s:Label width="99%" color="blue"
                text="Click the Adobe logo to watch the effect."/>
        </s:VGroup>

        <mx:Image id="myImage" 
            source="@Embed(source='assets/logo.jpg')"
            click="shrinkEffect.end();shrinkEffect.play();"/>
    </s:Panel>
</s:Application>

Rechtliche Hinweise | Onlinedatenschutzerklärung

Keyframe - AS3 Flex

Klassen x

easer

time

value

valueBy

Keyframe

clone