MotionBase

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

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

MotionBase 類別會儲存可套用至視覺物件的關鍵影格連續動畫。動畫資料包括位置、縮放、旋轉、傾斜、顏色、濾鏡以及加/減速。 MotionBase 類別具有可在特定關鍵影格點擷取資料的方法。若要取得關鍵影格當中的內插補值，請使用 Motion 類別。

相關 API 元素

公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		duration : int 控制 Motion 實體的時間長度 (以影格為單位)。	MotionBase
		is3D : Boolean 指定此移動是否包含 3D 屬性變更。	MotionBase
		keyframes : Array 關鍵影格的陣列，這些關鍵影格會定義移動在一段時間中的行為指令。	MotionBase

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		MotionBase(xml:XML = null) MotionBase 實體的建構函式。	MotionBase
		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
		getColorTransform(index:int):flash.geom:ColorTransform 會擷取 Motion 實體中特定時間索引的內插補 ColorTransform 物件。	MotionBase
		getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase 擷取位於 Motion 實體內特定影格之目前作用中的關鍵影格。	MotionBase
		getFilters(index:Number):Array 會擷取 Motion 實體中特定時間索引的內插補濾鏡陣列。	MotionBase
		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
		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

屬性詳細資訊

duration

屬性

duration:int

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

控制 Motion 實體的時間長度 (以影格為單位)。持續時間不能少於 Motion 實體之關鍵影格所佔用的時間。

預設值為 0。

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

is3D

屬性

is3D:Boolean

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 10, AIR 1.5, AIR 1.0

指定此移動是否包含 3D 屬性變更。如果為 true，就表示此移動包含 3D 屬性變更。

預設值為 false。

實作
public function get is3D():Boolean
public function set is3D(value:Boolean):void

keyframes

屬性

public var keyframes:Array

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

關鍵影格的陣列，這些關鍵影格會定義移動在一段時間中的行為指令。這個屬性是稀疏陣列，其中會將關鍵影格放置於陣列中符合其本身索引的索引位置。因此，關鍵影格位於 0 和 5 的 Motion 物件將會具有長度為 6 的關鍵影格陣列。陣列中的索引 0 和 5 分別包含一個關鍵影格，而索引 1 至 4 具有 null 值。

建構函式詳細資料

()

建構函式

public function MotionBase(xml:XML = null)

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

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

參數

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

方法詳細資訊

addFilterPropertyArray

()

方法

 public function addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

修改 Motion 物件的所有對應關鍵影格中的濾鏡屬性。使用這個方法之前，請先呼叫 initFilters()。陣列中的值順序決定了將每個值指定給所有關鍵影格之濾鏡屬性的方式。對於指定之 values 陣列中的每個非 null 值來說，這個方法會尋找在陣列中對應至值索引位置的關鍵影格，然後將濾鏡的屬性名稱/值配對儲存在此關鍵影格中。

參數

	`index:int` — 濾鏡陣列中的索引位置 (從零開始)。

	`name:String` — 要儲存在每個關鍵影格中的濾鏡屬性名稱。

	`values:Array` — 在 `name` 參數中指定之屬性的值陣列。每個非 null 值會指定給在陣列中與值索引對應之關鍵影格的濾鏡。

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

相關 API 元素

initFilters()
flash.filters

addKeyframe

()

方法

public function addKeyframe(newKeyframe:KeyframeBase):void

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

將關鍵影格物件加入至 Motion 實體。

參數

newKeyframe:KeyframeBase — 已經設定 index 屬性的關鍵影格物件。

相關 API 元素

fl.motion.Keyframe

addPropertyArray

()

方法

public function addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

將值陣列儲存在與 Motion 類別的已宣告屬性對應的關鍵影格中。陣列中的值順序會決定將每個值指定給關鍵影格的方式。對於指定之 values 陣列中的每個非 null 值來說，這個方法會尋找在陣列中對應至值索引位置的關鍵影格，或針對該索引位置建立新的關鍵影格，然後將屬性名稱/值配對儲存在此關鍵影格中。

參數

	`name:String` — 要儲存在每個關鍵影格中之 Motion 類別屬性的名稱。

	`values:Array` — 在 `name` 參數中指定之屬性的值陣列。每個非 null 值會指定給在陣列中對應至值順序的關鍵影格。

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

相關 API 元素

fl.motion.Motion

getColorTransform

()

方法

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

getCurrentKeyframe

()

方法

public function getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

擷取位於 Motion 實體內特定影格之目前作用中的關鍵影格。非關鍵影格的影格會從之前的關鍵影格衍生值。

此方法也可以依據特定可補間屬性的名稱，對值進行篩選。您可以尋找 x 的目前作用中關鍵影格，這可能與一般的目前作用中關鍵影格不同。

參數

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

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

傳回值

KeyframeBase — 位於所提供之影格索引位置或之前的最接近相符關鍵影格。

相關 API 元素

fl.motion.Tweenables

getFilters

()

方法

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

getMatrix

()

方法

public function getMatrix(index:int):Matrix

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 10, AIR 1.5, AIR 1.0

針對動畫影格的指定索引位置傳回 Matrix 物件。

參數

index:int — 包含矩陣之動畫影格的索引位置 (從零開始)。

傳回值

Matrix — Matrix 物件，或是 null 值。即使 MotionBase.is3D 為 false，此方法仍舊可以傳回 null 值，因為使用其他的移動補間動畫屬性變更不需要搭配 Matrix3D 物件一起使用。

相關 API 元素

flash.geom.Matrix

getMatrix3D

()

方法

public function getMatrix3D(index:int):Object

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 10, AIR 1.5, AIR 1.0

針對動畫影格的指定索引位置傳回 Matrix3D 物件。

參數

index:int — 包含 3D 矩陣之動畫影格的索引位置 (從零開始)。

傳回值

Object — Matrix3D 物件，或是 null 值。即使 MotionBase.is3D 為 true，此方法仍舊可以傳回 null 值，因為其他的 3D 移動補間動畫屬性變更不需要搭配 Matrix3D 物件一起使用。

相關 API 元素

flash.geom.Matrix3D

getNextKeyframe

()

方法

public function getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

擷取 Motion 實體中特定影格之後的下一個關鍵影格。如果某個影格不是關鍵影格，而且位於補間動畫的中間，此方法就會從之前和之後的關鍵影格衍生值。

此方法同時可讓您依據特定可補間屬性名稱來篩選，以找出某個屬性的下一個關鍵影格，一般來說，此屬性不會與下一個關鍵影格相同。

參數

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

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

傳回值

KeyframeBase — 位於所提供之影格索引之後的最接近相符關鍵影格。

相關 API 元素

fl.motion.Tweenables

getValue

()

方法

public function getValue(index:Number, tweenableName:String):Number

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會擷取某個時間點的 animation 屬性值。

參數

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

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

傳回值

Number — tweenableName 參數中指定的屬性數值。

相關 API 元素

fl.motion.Tweenables

initFilters

()

方法

 public function initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

初始化目標物件的濾鏡清單，並將此濾鏡清單複製到 Motion 物件的每個 Keyframe 實體。

參數

	`filterClasses:Array` — 濾鏡類別的陣列。此陣列中的每個項目都是佔用該索引之濾鏡類型的完整類別名稱 (採用字串形式)。

	`gradientSubarrayLengths:Array` — 數字陣列，內含每個濾鏡的值，且該值將列於移動的濾鏡清單中 (`filterClasses` 陣列中的每個類別名稱)。 `gradientSubarrayLengths` 陣列中的值，只有當位於 `filterClasses` 陣列中相同索引位置上的濾鏡類別項目為 GradientGlowFilter 或 GradientBevelFilter 時才會使用。`gradientSubarrayLengths` 陣列中的對應值是一個可決定陣列長度的數字，用以初始化 GradientGlowFilter 和 GradientBevelFilter 建構函數的 `colors`、`alphas`，以及 `ratios` 參數。

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

overrideTargetTransform

()

方法

public function overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void

參數

	`scale:Boolean` (default = `true`)

	`skew:Boolean` (default = `true`)

	`rotate:Boolean` (default = `true`)

setValue

()

方法

public function setValue(index:int, tweenableName:String, value:Number):void

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

設定 Motion 實體中所指定時間索引的特定可補間屬性值。如果該索引位置沒有關鍵影格，則會自動建立一個關鍵影格。

參數

	`index:int` — Motion 實體中影格的時間索引 (大於零的整數)。如果索引為零，就不會進行任何變更。由於 Transformation 屬性是相對於目標物件的開始變形值，所以第一個影格的值 (零開始的值) 一定是預設值，而且不應該變更。

	`tweenableName:String` — 可補間屬性的名稱字串 (如 `"x"` 或 `"rotation"`)。

	`value:Number` — 可補間屬性的新值。

相關 API 元素

fl.motion.Tweenables

useRotationConcat

()

方法

public function useRotationConcat(index:int):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 10, AIR 1.5, AIR 1.0

當 addPropertyArray() 方法提供移動資料時，則旋轉目標物件。

參數

index:int — 動畫影格的索引位置。

傳回值

Boolean — 指出目標物件是否會使用來自 KeyframeBase.rotationConcat 的 stored 屬性來旋轉。

範例如何使用本範例

MotionBaseExample.as

範例顯示如何使用 MotionBase 和 AnimatorFactory 類別，呈現 Sprite 的動畫。MotionBase 物件是指定的 x 和 y 座標陣列，且用於建立 AnimatorFactory 物件。AnimatorFactory 最終是以 sprite 為目標，以填滿色彩的矩形出現。

package 
{
     import flash.display.MovieClip;
     import flash.display.Sprite;
     import fl.motion.AnimatorFactory;
     import fl.motion.MotionBase;
     import flash.geom.Point;
    
     public class  MotionBaseExample extends MovieClip
     {
          private var motionBase:MotionBase;
          private var animFactory:AnimatorFactory;
          private var size:uint    = 100;
          private var bgColor:uint = 0xFFCC00;

          public function MotionBaseExample():void
          {
               var boxObj:sprite = new Sprite();
               boxObj.graphics.beginFill(bgColor);
               boxObj.graphics.drawRect(0, 0, size, size);
               boxObj.graphics.endFill();
               addChild(boxObj);

               motionBase = new MotionBase();
               motionBase.duration = 20;
               motionBase.addPropertyArray("x",[0,50,95,134,169,199,225,247,265,280]);
               motionBase.addPropertyArray("y",[0,1,0,4,12,21,32,44,52,38]);
               animFactory = new AnimatorFactory(motionBase);
               animFactory.transformationPoint = new Point(2, 2);
               animFactory.addTarget(boxObj, 0);
          }
     }    
}

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

MotionBase - AS3 Flash

套件x

語言元素

附錄

套件 fl.motion

duration

is3D

keyframes

MotionBase

addFilterPropertyArray

addKeyframe

addPropertyArray

getColorTransform

getCurrentKeyframe

getFilters

getMatrix

getMatrix3D

getNextKeyframe

getValue

initFilters

overrideTargetTransform

setValue

useRotationConcat