Motion

套件	fl.motion
類別	public class Motion
繼承	Motion MotionBase Object

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

Motion 類別會儲存可套用至視覺物件的關鍵影格連續動畫。動畫資料包括位置、縮放、旋轉、傾斜、顏色、濾鏡以及加/減速。 Motion 類別提供了一些方法，可以用來擷取特定時間點資料，並自動插補關鍵影格之間的值。

注意：在 Flash CS3 中，此類別支援的許多屬性和方法是此類別專屬的成員。Flash CS4 為此類別的這些屬性和方法引進了基礎類別 KeyframeBase，現在這些屬性和方法會透過繼承鏈結來與其他類別共用。如果您正在使用 Flash CS3，請注意這些屬性和方法仍然受到 Keyframe 類別的支援，不過在 Flash CS3 之後的 Flash Professional 版本中會變成 KeyframeBase 的成員。針對此參考中的其他類別，請選取「顯示繼承公用屬性」和「顯示繼承公用方法」，查看此類別支援的所有屬性和方法。

預設 MXML 屬性keyframesCompact

相關 API 元素

移動 XML 元素

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		duration : int 控制 Motion 實體的時間長度 (以影格為單位)。	MotionBase
		is3D : Boolean 指定此移動是否包含 3D 屬性變更。	MotionBase
		keyframes : Array 關鍵影格的陣列，這些關鍵影格會定義移動在一段時間中的行為指令。	MotionBase
		keyframesCompact : Array 精簡的關鍵影格陣列，其中每個索引都由某個關鍵影格佔用。	Motion
		source : Source 物件，其中儲存用於建立移動之內容的相關資訊，如影格速率、尺寸、變形點、初始位置、縮放、旋轉及傾斜。	Motion

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		Motion(xml:XML = null) Motion 實體的建構函式。	Motion
		addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void 修改 Motion 物件的所有對應關鍵影格中的濾鏡屬性。	MotionBase
		addKeyframe(newKeyframe:KeyframeBase):void 將關鍵影格物件加入至 Motion 實體。	MotionBase
		addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void 將值陣列儲存在與 Motion 類別的已宣告屬性對應的關鍵影格中。	MotionBase
		fromXMLString(xmlString:String):Motion [靜態] 從 XML 字串建立 Motion 實體所需的方法。	Motion
		getColorTransform(index:int):flash.geom:ColorTransform [覆寫] 會擷取 Motion 實體中特定時間索引的內插補 ColorTransform 物件。	Motion
		getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase 擷取位於 Motion 實體內特定影格之目前作用中的關鍵影格。	MotionBase
		getFilters(index:Number):Array [覆寫] 會擷取 Motion 實體中特定時間索引的內插補濾鏡陣列。	Motion
		getMatrix(index:int):Matrix 針對動畫影格的指定索引位置傳回 Matrix 物件。	MotionBase
		getMatrix3D(index:int):Object 針對動畫影格的指定索引位置傳回 Matrix3D 物件。	MotionBase
		getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase 擷取 Motion 實體中特定影格之後的下一個關鍵影格。	MotionBase
		getValue(index:Number, tweenableName:String):Number 會擷取某個時間點的 animation 屬性值。	MotionBase
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void 初始化目標物件的濾鏡清單，並將此濾鏡清單複製到 Motion 物件的每個 Keyframe 實體。	MotionBase
		interpolateFilter(fromFilter:BitmapFilter, toFilter:BitmapFilter, progress:Number):BitmapFilter [靜態] 會將濾鏡從某個濾鏡物件平順地轉換成另一個物件。	Motion
		interpolateFilters(fromFilters:Array, toFilters:Array, progress:Number):Array [靜態] 會將濾鏡從某個濾鏡物件的陣列平順地轉換成另一個陣列。	Motion
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void	MotionBase
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		setValue(index:int, tweenableName:String, value:Number):void 設定 Motion 實體中所指定時間索引的特定可補間屬性值。	MotionBase
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		useRotationConcat(index:int):Boolean 當 addPropertyArray() 方法提供移動資料時，則旋轉目標物件。	MotionBase
		valueOf():Object 會傳回指定之物件的基本值。	Object

屬性詳細資訊

keyframesCompact

屬性

keyframesCompact:Array

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

精簡的關鍵影格陣列，其中每個索引都由某個關鍵影格佔用。相較之下，稀疏陣列會有空的索引 (如 keyframes 屬性中的情形)。在精簡陣列中，沒有任何用來填滿關鍵影格之間索引的 null 值。不過，keyframesCompact 中的關鍵影格索引可能會與 keyframes 陣列中的索引不相符。

此屬性主要用來與 Flex MXML 編譯器達成相容性，以便從 Motion XML 產生精簡陣列。

實作
public function get keyframesCompact():Array
public function set keyframesCompact(value:Array):void

相關 API 元素

keyframes

source

屬性

public var source:Source

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

物件，其中儲存用於建立移動之內容的相關資訊，如影格速率、尺寸、變形點、初始位置、縮放、旋轉及傾斜。

建構函式詳細資料

()

建構函式

public function Motion(xml:XML = null)

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

Motion 實體的建構函式。根據預設，會自動建立一個初始關鍵影格，並具有預設的變形屬性。

參數

xml:XML (default = null) — 選擇性的 E4X XML 物件，會定義 Motion 實體。

方法詳細資訊

fromXMLString

()

方法

public static function fromXMLString(xmlString:String):Motion

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

從 XML 字串建立 Motion 實體所需的方法。

參數

xmlString:String — Motion XML 的字串。

傳回值

Motion — 新的 Motion 實體。

getColorTransform

()

方法

override public function getColorTransform(index:int):flash.geom:ColorTransform

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會擷取 Motion 實體中特定時間索引的內插補 ColorTransform 物件。

參數

index:int — Motion 實體中影格的時間索引 (大於或等於零的整數)。

傳回值

flash.geom:ColorTransform — 漸變 ColorTransform 物件。

相關 API 元素

flash.geom.ColorTransform

getFilters

()

方法

override public function getFilters(index:Number):Array

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會擷取 Motion 實體中特定時間索引的內插補濾鏡陣列。

參數

index:Number — Motion 實體中影格的時間索引 (大於或等於零的整數)。

傳回值

Array — 漸變濾鏡陣列。如果沒有適用的濾鏡，就會傳回空陣列。

相關 API 元素

flash.filters

interpolateFilter

()

方法

public static function interpolateFilter(fromFilter:BitmapFilter, toFilter:BitmapFilter, progress:Number):BitmapFilter

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會將濾鏡從某個濾鏡物件平順地轉換成另一個物件。

參數

	`fromFilter:BitmapFilter` — 開始端濾鏡物件。

	`toFilter:BitmapFilter` — 結束端濾鏡物件。

	`progress:Number` — 轉換的百分比 (採十進位制)，其中 `0` 是起點而 `1` 是終點。

傳回值

BitmapFilter — 內插補濾鏡物件。

相關 API 元素

flash.filters

interpolateFilters

()

方法

public static function interpolateFilters(fromFilters:Array, toFilters:Array, progress:Number):Array

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會將濾鏡從某個濾鏡物件的陣列平順地轉換成另一個陣列。

參數

	`fromFilters:Array` — 開始端濾鏡物件陣列。

	`toFilters:Array` — 結束端濾鏡物件陣列。

	`progress:Number` — 轉換的百分比 (採十進位制)，其中 `0` 是起點而 `1` 是終點。

傳回值

Array — 內插補濾鏡物件陣列。

相關 API 元素

flash.filters

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

Motion - AS3 Flash

類別 x

keyframesCompact

source

Motion

fromXMLString

getColorTransform

getFilters

interpolateFilter

interpolateFilters