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

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