Keyframe

套件	spark.effects.animation
類別	public class Keyframe
繼承	Keyframe Object

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The Keyframe class defines the value of a property at a specific time during an effect. For example, you can create three keyframes that define the value of a property at the beginning of the effect, at the midpoint of the effect, and at the end of the effect. The effect animates the property change on the target from keyframe to keyframe over the effect duration.

The collection of keyframes for an effect is called the effect's motion path. A motion path can define any number of keyframes. The effect then calculates the value of the property by interpolating between the values specified by two key frames.

Use the MotionPath class to hold the collection of Keyframe objects that represent the motion path of the effect. The MotionPath class specifies the name of the property on the target, and the collection of Keyframes objects specify the values of the property at different times during the effect.

MXML 語法

隱藏 MXML 語法

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"
  />

相關 API 元素

公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		easer : IEaser The easing behavior applied to the motion between the previous Keyframe object in motion path and this Keyframe object.	Keyframe
		time : Number The time, in milliseconds, at which the effect target for this keyframe should have the value specified by the value property.	Keyframe
		value : Object The value that the property of the effect target should have at the time specified by the time property.	Keyframe
		valueBy : Object Optional parameter which, if specified, is used to calculate value in this keyframe or the previous one.	Keyframe

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		Keyframe(time:Number = NaN, value:Object = null, valueBy:Object = null) Constructor.	Keyframe
		clone():Keyframe Returns a copy of this Keyframe object.	Keyframe
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		valueOf():Object 會傳回指定之物件的基本值。	Object

屬性詳細資訊

easer

屬性

public var easer:IEaser

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The easing behavior applied to the motion between the previous Keyframe object in motion path and this Keyframe object. By default, the easing is linear, or no easing at all.

Note that the parent effect might have easing applied already over the entire animation. Therefore, if easing per keyframe interval is desired instead, it is necessary to set the overall effect easer to linear easing (spark.effects.easing.Linear) and then set the easer on each Keyframe as appropriate.

Because this property acts on the interval between the previous Keyframe object in a sequence and this Keyframe object, the easer property is ignored on the first Keyframe object in a sequence.

預設值為 Linear。

time

屬性

public var time:Number

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The time, in milliseconds, at which the effect target for this keyframe should have the value specified by the value property. This time is relative to the starting time of the effect defined with this keyframe.

value

屬性

public var value:Object

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

The value that the property of the effect target should have at the time specified by the time property.

valueBy

屬性

public var valueBy:Object

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

Optional parameter which, if specified, is used to calculate value in this keyframe or the previous one. If value is not set in the previous keyframe, but this keyframe defines both value and valueBy, then value in the previous keyframe is calculated as value in this keyframe minus valueBy in this keyframe.

Similarly, if value in this keyframe is not defined, but valueBy in this keyframe and value in the previous keyframe are both set, then value in this keyframe is calculated as value in the previous keyframe plus valueBy in this keyframe.

valueBy is ignored for the first keyframe in a sequence, since it applies only to the interval preceding a keyframe, and there is no preceding interval for the first keyframe.

建構函式詳細資料

()

建構函式

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

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

Constructor.

參數

	`time:Number` (default = `NaN`) — The time, in milliseconds, at which the effect target of this keyframe should have the value specified by the `value` parameter.

	`value:Object` (default = `null`) — The value that the effect target should have at the given `time`.

	`valueBy:Object` (default = `null`) — Optional parameter which, if provided, causes `value` to be calculated dynamically by adding `valueBy` to the `value` of the previous keyframe in the set of keyframes in a MotionPath object. This value is ignored if this is the first Keyframe in a sequence.

方法詳細資訊

clone

()

方法

public function clone():Keyframe

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

Returns a copy of this Keyframe object.

傳回值

Keyframe — A copy of this Keyframe object.

範例如何使用本範例

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>

法律聲明 | 線上隱私權政策

Keyframe - AS3 Flex

類別 x

easer

time

value

valueBy

Keyframe

clone