KeyframeBase

套件	fl.motion
類別	public class KeyframeBase
繼承	KeyframeBase Object
子類別	Keyframe

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

KeyframeBase 類別會定義移動補間動畫中特定時間的視覺狀態。主要的動畫屬性為 position、scale、rotation、skew 和 color。若要使用 KeyframeBase，所有屬性必須具備每個 KeyframeBase 的值，而且必須針對移動中的每個影格定義 KeyframeBase。在移動補間動畫內，每個時間索引只能有一個關鍵影格。關鍵影格還有其他屬性，如 blend mode、filters 和 cacheAsBitmap，隨時都可使用。例如，關鍵影格一定會有混合模式。

相關 API 元素

移動 XML 元素

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		adjustColorObjects : Dictionary = null 儲存 AdjustColor 實體 (對應至其在此關鍵影格之濾鏡 Array 中的相應索引)。	KeyframeBase
		blank : Boolean = false 指出目標物件不該顯示於此關鍵影格上。	KeyframeBase
		blendMode : String = "normal" BlendMode 類別的值，可用來指定 Flash Player 混合顯示物件的顏色與此物件底下圖像的方式。	KeyframeBase
		cacheAsBitmap : Boolean = false 如果設為 true，Flash Player 會快取顯示物件的內部點陣圖表示法。	KeyframeBase
		color : Color 在目標物件中調整顏色轉換的顏色物件。	KeyframeBase
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		filters : Array 陣列，其中包含在特定關鍵影格要套用至目標物件的每個濾鏡物件。	KeyframeBase
		firstFrame : String 儲存移動補間動畫第一個影格的名稱，此名稱只會影響圖像元件。	KeyframeBase
		index : int 關鍵影格在移動補間動畫中的唯一時間值。	KeyframeBase
		label : String 用來描述關鍵影格的字串。	KeyframeBase
		loop : String 儲存移動補間動畫之「循環」核取方塊的值，此值只會影響圖像元件。	KeyframeBase
		matrix : Matrix = null 如果此關鍵影格具有 matrix 屬性的話，則會加以儲存。	KeyframeBase
		matrix3D : Object = null 如果此關鍵影格具有 matrix3d 屬性的話，則會加以儲存。	KeyframeBase
		opaqueBackground : Object = null 控制目標物件是否具有不透明的背景。	KeyframeBase
		orientToPath : Boolean = false 如果設定為 true，則此屬性會讓目標物件自動旋轉以順應路徑的角度。	KeyframeBase
		rotateDirection : String = "auto" 使用 RotateDirection 類別的值，控制目標物件在移動補間動畫期間旋轉的方式。	KeyframeBase
		rotateTimes : uint = 0 除了現有的任何旋轉以外，會在移動補間動畫期間將旋轉加入至目標物件。	KeyframeBase
		rotation : Number 會指出從變形點套用的目標物件旋轉度數 (依該物件原本的方向計算)。	KeyframeBase
		rotationConcat : Number = NaN 相對於先前方向，並從變形點套用的移動中目標物件之旋轉 (z 軸) 值，與絕對旋轉值相反，並與 skewY 值不同。	KeyframeBase
		rotationX : Number = NaN 儲存此關鍵影格的 rotationX 屬性。	KeyframeBase
		rotationY : Number = NaN 儲存此關鍵影格的 rotationY 屬性。	KeyframeBase
		scaleX : Number = NaN 會指出從變形點套用的物件水平縮放 (百分比)。	KeyframeBase
		scaleY : Number = NaN 會指出從變形點套用的物件垂直縮放 (百分比)。	KeyframeBase
		skewX : Number = NaN 會指出從變形點套用的目標物件水平傾斜角度，以度數為單位。	KeyframeBase
		skewY : Number = NaN 會指出從變形點套用的目標物件垂直傾斜角度，以度數為單位。	KeyframeBase
		tweensLength : int [唯讀] 補間動畫的影格數目。	KeyframeBase
		useRotationConcat : Boolean = false 如果設為 true，則當 addpropertyarray 提供了移動的資料，此屬性會導致目標物件旋轉。	KeyframeBase
		visible : Boolean = true 控制目標物件是否為可見。	KeyframeBase
		x : Number = NaN 在其父輩的座標空間中，目標物件變形點的水平位置。	KeyframeBase
		y : Number = NaN 在其父輩的座標空間中，目標物件變形點的垂直位置。	KeyframeBase
		z : Number = NaN 目標物件變形點 (在其父輩的座標空間中) 的深度 (z 軸) 位置。	KeyframeBase

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		KeyframeBase(xml:XML = null) 關鍵影格實體的建構函式。	KeyframeBase
		affectsTweenable(tweenableName:String = ""):Boolean 指出關鍵影格是否會影響特定 animation 屬性。	KeyframeBase
		getValue(tweenableName:String):Number 擷取關鍵影格上特定可補間屬性的值。	KeyframeBase
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		setAdjustColorProperty(filterIndex:int, propertyName:String, value:*):void 將四個 AdjustColor 屬性中的任何一個設為指定濾鏡索引的 AdjustColor 物件。	KeyframeBase
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		setValue(tweenableName:String, newValue:Number):void 變更關鍵影格上特定可補間屬性的值。	KeyframeBase
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		valueOf():Object 會傳回指定之物件的基本值。	Object

屬性詳細資訊

adjustColorObjects

屬性

public var adjustColorObjects:Dictionary = null

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

儲存 AdjustColor 實體 (對應至其在此關鍵影格之濾鏡 Array 中的相應索引)。此作法用於 Flash 編寫的 AdjustColor 濾鏡 (對應至 Flash Player 中的 ColorMatrixFilters)。

blank

屬性

public var blank:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

指出目標物件不該顯示於此關鍵影格上。

blendMode

屬性

public var blendMode:String = "normal"

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

BlendMode 類別的值，可用來指定 Flash Player 混合顯示物件的顏色與此物件底下圖像的方式。

相關 API 元素

flash.display.BlendMode

cacheAsBitmap

屬性

public var cacheAsBitmap:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

如果設定為 true，Flash Player 便會快取顯示物件的內部點陣圖。使用此屬性通常可以讓顯示速度較預設使用的向量格式更快。

color

屬性

public var color:Color

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

在目標物件中調整顏色轉換的顏色物件。

filters

屬性

public var filters:Array

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

陣列，其中包含在特定關鍵影格要套用至目標物件的每個濾鏡物件。

firstFrame

屬性

public var firstFrame:String

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

儲存移動補間動畫第一個影格的名稱，此名稱只會影響圖像元件。此屬性可用於 Flash CS4 中的「複製移動」和「貼上移動」功能，但是不影響使用 ActionScript 所定義的移動補間動畫。將此屬性納入，是為了要與 Flex 2 編譯器相容。

index

屬性

index:int

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

關鍵影格在移動補間動畫中的唯一時間值。移動補間動畫中第一個影格的索引為 0。

實作
public function get index():int
public function set index(value:int):void

label

屬性

public var label:String

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

用來描述關鍵影格的字串。

loop

屬性

public var loop:String

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

儲存移動補間動畫之「循環」核取方塊的值，此值只會影響圖像元件。此屬性可用於 Flash CS4 中的「複製移動」和「貼上移動」功能，但是不影響使用 ActionScript 所定義的移動補間動畫。將此屬性納入，是為了要與 Flex 2 編譯器相容。

matrix

屬性

public var matrix:Matrix = null

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 10, AIR 1.5, AIR 1.0

如果此關鍵影格具有 matrix 屬性的話，則會加以儲存。matrix 是用於沒有 3D 功能的非影格補間動畫中。您可以使用 matrix 屬性或其他位置以及比例屬性 (x、y、scaleX、scaleY)，但是二者不可以同時一起設定。如果 matrix 設為 null 以外的值，則會使用此值，而不是其他任何屬性 (包括 3D 屬性)。

matrix3D

屬性

public var matrix3D:Object = null

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 10, AIR 1.5, AIR 1.0

如果此關鍵影格具有 matrix3d 屬性的話，則會加以儲存。matrix3d 可用於內含 3D 的非補間動畫影格。您可以使用 matrix3d 屬性或是其他 3D 屬性 (z、rotationX、rotationY)，但不能同時使用兩者。如果 matrix3d 設為 null 以外的值，則會使用此值，而不是其他任何屬性 (包括 2D 屬性)。

opaqueBackground

屬性

public var opaqueBackground:Object = null

語言版本:

ActionScript 3.0

產品版本:

Flash CS5.5

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

控制目標物件是否具有不透明的背景。值如果是數字即是以 0xrrggbb 形式描述色彩，如果是空值則表示沒有不透明的背景。

orientToPath

屬性

public var orientToPath:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

如果設定為 true，則此屬性會讓目標物件自動旋轉以順應路徑的角度。

rotateDirection

屬性

public var rotateDirection:String = "auto"

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

使用 RotateDirection 類別的值，控制目標物件在移動補間動畫期間旋轉的方式。

相關 API 元素

fl.motion.RotateDirection

rotateTimes

屬性

public var rotateTimes:uint = 0

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

除了現有的任何旋轉以外，會在移動補間動畫期間將旋轉加入至目標物件。此旋轉會視 rotateDirection 屬性 (必須設定為 RotateDirection.CW 或 RotateDirection.CCW) 的值而定。 rotateTimes 值必須是等於或大於零的整數。

例如，如果物件一般會從 0 度旋轉到 40 度，那麼將 rotateTimes 設定為 1，以及將 rotateDirection 設定為 RotateDirection.CW，就會增加一整圈 400 度的旋轉。

如果 rotateDirection 設定為 RotateDirection.CCW，便會從一般旋轉減去 360 度，因而逆時針轉動 320 度。

相關 API 元素

rotateDirection

rotation

屬性

rotation:Number

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會指出從變形點套用的目標物件旋轉度數 (依該物件原本的方向計算)。值為 NaN 表示關鍵影格不會影響此屬性。

實作
public function get rotation():Number
public function set rotation(value:Number):void

rotationConcat

屬性

public var rotationConcat:Number = NaN

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 10, AIR 1.5, AIR 1.0

相對於先前方向，並從變形點套用的移動中目標物件之旋轉 (z 軸) 值，與絕對旋轉值相反，並與 skewY 值不同。

rotationX

屬性

public var rotationX:Number = NaN

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

儲存此關鍵影格的 rotationX 屬性。此屬性是目標物件從其原始方向沿著 x 軸的旋轉。

rotationY

屬性

public var rotationY:Number = NaN

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

儲存此關鍵影格的 rotationY 屬性。此屬性是目標物件從其原始方向沿著 y 軸的旋轉。

scaleX

屬性

public var scaleX:Number = NaN

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會指出從變形點套用的物件水平縮放 (百分比)。值為 1 表示 100% 的一般大小。值為 NaN 表示關鍵影格不會影響此屬性。

scaleY

屬性

public var scaleY:Number = NaN

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會指出從變形點套用的物件垂直縮放 (百分比)。值為 1 表示 100% 的一般大小。值為 NaN 表示關鍵影格不會影響此屬性。

skewX

屬性

public var skewX:Number = NaN

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會指出從變形點套用的目標物件水平傾斜角度，以度數為單位。值為 NaN 表示關鍵影格不會影響此屬性。

skewY

屬性

public var skewY:Number = NaN

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會指出從變形點套用的目標物件垂直傾斜角度，以度數為單位。值為 NaN 表示關鍵影格不會影響此屬性。

tweensLength

屬性

tweensLength:int [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

補間動畫的影格數目。

實作
public function get tweensLength():int

useRotationConcat

屬性

public var useRotationConcat:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 10, AIR 1.5, AIR 1.0

如果設為 true，則當 addpropertyarray 提供了移動的資料，此屬性會導致目標物件旋轉。同時，若為 true，則會使用 rotationConcat 屬性，而不是 rotation。預設值為 false。

visible

屬性

public var visible:Boolean = true

語言版本:

ActionScript 3.0

產品版本:

Flash CS5.5

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

控制目標物件是否為可見。

x

屬性

public var x:Number = NaN

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

在其父輩的座標空間中，目標物件變形點的水平位置。值為 NaN 表示關鍵影格不會影響此屬性。

y

屬性

public var y:Number = NaN

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

在其父輩的座標空間中，目標物件變形點的垂直位置。值為 NaN 表示關鍵影格不會影響此屬性。

z

屬性

public var z:Number = NaN

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 10, AIR 1.5, AIR 1.0

目標物件變形點 (在其父輩的座標空間中) 的深度 (z 軸) 位置。一旦參照到 3D 平面，則 z 軸指的是 3D 物件的深度。值為 NaN 表示關鍵影格不會影響此屬性。

建構函式詳細資料

()

建構函式

public function KeyframeBase(xml:XML = null)

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

關鍵影格實體的建構函式。

參數

xml:XML (default = null) — 選擇性的 E4X XML 物件，會以 Motion XML 格式定義關鍵影格。

方法詳細資訊

affectsTweenable

()

方法

public function affectsTweenable(tweenableName:String = ""):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

指出關鍵影格是否會影響特定 animation 屬性。

參數

tweenableName:String (default = "") — 可補間屬性的名稱，如 "x" 或 "rotation"。

傳回值

Boolean

getValue

()

方法

public function getValue(tweenableName:String):Number

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

擷取關鍵影格上特定可補間屬性的值。

參數

tweenableName:String — 可補間屬性的名稱，如 "x" 或 "rotation"。

傳回值

Number — 可補間屬性的數值。

setAdjustColorProperty

()

方法

public function setAdjustColorProperty(filterIndex:int, propertyName:String, value:*):void

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

將四個 AdjustColor 屬性中的任何一個設為指定濾鏡索引的 AdjustColor 物件。如果該索引尚未擁有任何物件，它會建立 AdjustColor 實體。可以設定的四個屬性為：

adjustColorBrightness
adjustColorContrast
adjustColorSaturation
adjustColorHue

這四個 AdjustColor 屬性全部都需要加以設定才能建立濾鏡。一旦在 AdjustColor 實體上設定了全部四個屬性，函數就會從 AdjustColor 物件取得一個內含 20 個值 (代表全部四個屬性) 的平面陣列，並建立需要平面化陣列的 ColorMatrixFilter 實體。

參數

	`filterIndex:int` — 濾鏡陣列中要加入 `propertyName` 屬性之濾鏡的索引位置。

	`propertyName:String` — 其中一個允許的屬性值：`"adjustColorBrightness"`, `"adjustColorContrast"`、`"adjustColorSaturation"`或`"adjustColorHue"`。

	`value:*` — 要針對指定之屬性設定的值。

相關 API 元素

fl.motion.AdjustColor

setValue

()

方法

public function setValue(tweenableName:String, newValue:Number):void

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

變更關鍵影格上特定可補間屬性的值。

參數

	`tweenableName:String` — 可補間屬性的名稱，如 `"x"` 或 `"rotation"`。

	`newValue:Number` — 要指定給可補間屬性的數值。

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

KeyframeBase - AS3 Flash

套件x

語言元素

附錄

套件 fl.motion

adjustColorObjects

blank

blendMode

cacheAsBitmap

color

filters

firstFrame

index

label

loop

matrix

matrix3D

opaqueBackground

orientToPath

rotateDirection

rotateTimes

rotation

rotationConcat

rotationX

rotationY

scaleX

scaleY

skewX

skewY

tweensLength

useRotationConcat

visible

x

y

z

KeyframeBase

affectsTweenable

getValue

setAdjustColorProperty

setValue