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 エレメント

Motion クラス
モーション XML エレメント

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		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 モーションオブジェクトに対して、対応するすべてのキーフレームのフィルターのプロパティを変更します。	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 特定の時点におけるアニメーションプロパティの値を取得します。	MotionBase
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void ターゲットオブジェクトのフィルターリストを初期化し、そのフィルターのリストをモーションオブジェクトのそれぞれの 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 のキーフレームがあるモーションオブジェクトには、長さが 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) — Motion インスタンスを定義するオプションの E4X XML オブジェクト。

メソッドの詳細

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

モーションオブジェクトに対して、対応するすべてのキーフレームのフィルターのプロパティを変更します。このメソッドを使用する前に initFilters() を呼び出します。配列内の値の順序によって、すべてのキーフレームのフィルターのプロパティへのそれぞれの値の割り当てが決まります。指定された values 配列内の null 以外の値のそれぞれについて、このメソッドは配列内のインデックス位置の値に対応したキーフレームを見つけ、キーフレームのフィルターのプロパティ名と値のペアを格納します。

パラメーター

	`index:int` — フィルターの配列内の 0 から始まるインデックス位置です。

	`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 — インデックスプロパティが既に設定されたキーフレームオブジェクト。

関連する 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 — ゼロ以上の整数としてモーション内のフレームの時間インデックスを示します。

戻り値

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 — マトリックスを含むアニメーションのフレームの 0 から始まるインデックス位置です。

戻り値

Matrix — Matrix オブジェクトまたは null の値。他のモーショントゥイーンプロパティは、Matrix オブジェクトなしで使用できるので、このメソッドは MotionBase.is3D が false でも null 値を返すことができます。

関連する 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 マトリックスを含むアニメーションのフレームの 0 から始まるインデックス位置です。

戻り値

Object — Matrix3D オブジェクトまたは null の値。他の 3D モーショントゥイーンプロパティは、Matrix3D なしで使用できるため、このメソッドは MotionBase.is3D が true でも null を返すことができます。

関連する 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

特定の時点におけるアニメーションプロパティの値を取得します。

パラメーター

	`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

ターゲットオブジェクトのフィルターリストを初期化し、そのフィルターのリストをモーションオブジェクトのそれぞれの Keyframe インスタンスにコピーします。

パラメーター

	`filterClasses:Array` — フィルタークラスの配列です。配列のそれぞれのアイテムは、そのインデックスに置かれているフィルター型の完全修飾クラス名（String 型）です。

	`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 インスタンス内のフレームの時間インデックスを示します。インデックスがゼロの場合、変更は行われません。変換プロパティは、ターゲットオブジェクトの開始変換値を基準としており、最初のフレームに対する値（ゼロインデックス値）が、常にデフォルト値となって変更できません。

	`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 から格納されたプロパティを使用して、ターゲットオブジェクトを回転するかどうかを示します。

例この例の使用方法

MotionBaseExample.as

この例では、MotionBase クラスと AnimatorFactory クラスを使用して、スプライトをアニメーション化する方法を示します。MotionBase オブジェクトに x 軸と y 軸の配列を割り当ててから、このオブジェクトを使用して AnimatorFactory オブジェクトを作成します。AnimatorFactory の最終的なターゲットは、塗りつぶし長方形のスプライトです。

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