| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
AnimatorBase クラスは、モーショントゥイーンの XML 記述を表示オブジェクトに適用します。AnimatorBase クラスのプロパティおよびメソッドはモーションの再生を制御し、Flash Player はモーションのステータスの変化に応じてイベントをブロードキャストします。AnimatorBase クラスは、主に Flash CS4 の「ActionScript としてのモーションのコピー」コマンドで使用されています。これにより、アプリケーションプログラミングインターフェイス(API)を使用して ActionScript を編集できるようになります。また、独自のカスタムアニメーションを作成することもできます。AnimatorBase クラスは、単独で使用しないでください。代わりに、サブクラス(Animator または Animator3D)を使用してください。
AnimatorBase クラスのメソッドを関数内で呼び出す場合、AnimatorBase インスタンスを関数の外部で宣言し、オブジェクトのスコープが関数内に限定されないようにします。関数の内部でインスタンスを宣言すると、関数の最後に、Flash Player の「ガベージコレクション」ルーチンによって AnimatorBase インスタンスが削除され、ターゲットオブジェクトのアニメーションが無効になります。
motion
public var autoRewind:Boolean = false| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
アニメーションが終了後に再開するように設定します。
frameEvent:String [読み書き可能]
実装 public function get frameEvent():String public function set frameEvent(value:String):voidinitialPosition:Array [書き込み専用]
実装 public function set initialPosition(value:Array):voidisPlaying:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
アニメーションが現在再生中かどうかを示します。
実装 public function get isPlaying():Booleanmotion:MotionBase [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
アニメーションのモーショントゥイーンプロパティを含んでいるオブジェクトです。
実装 public function get motion():MotionBase public function set motion(value:MotionBase):voidpublic var orientToPath:Boolean = false| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
モーションパスに沿って表示オブジェクトの位置を設定します。true に設定すると、表示オブジェクトのベースラインがモーションパスに指定されます。それ以外の場合は、基準点がモーションパスに指定されます。
public var positionMatrix:Matrix| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
全体的な変換をモーションパスに適用する Matrix オブジェクトです。このマトリックスを使用すると、表示オブジェクトの外観を変更せずに、パスをシフト、拡大 / 縮小、傾斜、または回転することができます。
public var repeatCount:int = 1| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
アニメーションを繰り返す回数を表します。有効な値は 0 以上の整数です。 値が 1 の場合、アニメーションが 1 回再生されます。値が 0 の場合、end() メソッドを呼び出すなどして明示的に停止するまでアニメーションが無期限に再生されます。
デフォルト値 : 1.
関連項目
sceneName:String [読み書き可能]
実装 public function get sceneName():String public function set sceneName(value:String):voidspanEnd:int [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
ターゲットのアニメーションが終了する、ターゲットの親のフレームを返します。この値は、spanStart およびモーションの duration プロパティを使用して決定されます。
実装 public function get spanEnd():intspanStart:int [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
ターゲットのアニメーションが開始する、ターゲットの親のフレームを返します。
実装 public function get spanStart():inttarget:DisplayObject [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
アニメーション中の表示オブジェクトです。MovieClip、Sprite、Bitmap など、flash.display.DisplayObject のサブクラスを利用できます。
実装 public function get target():DisplayObject public function set target(value:DisplayObject):void関連項目
targetName:String [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
ターゲットオブジェクトの名前は、親 DisplayObjectContainer で表示して確認できます。 ターゲットオブジェクトが削除され、タイムライン上で置き換えられた後、これを targetParent と組み合わせて使用して、ターゲットオブジェクトを取得できます。
実装 public function get targetName():String public function set targetName(value:String):voidtargetParent:DisplayObjectContainer [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
アニメーションされターゲットとなる親 DisplayObjectContainer。ターゲットオブジェクトが削除され、タイムライン上で置き換えられた後、targetName と組み合わせて使用してターゲットオブジェクトを取得できます。
実装 public function get targetParent():DisplayObjectContainer public function set targetParent(value:DisplayObjectContainer):voidtargetState3D:Array [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
ターゲットオブジェクトの最初の位置です。すべての 3D 回転は、モーションデータに対して絶対です。3D の開始位置の異なる別のオブジェクトをターゲットにすると、まず、このターゲットの状態にリセットされます。
実装 public function get targetState3D():Array public function set targetState3D(value:Array):voidtime:int [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
現在のアニメーションの時間を表示および制御するゼロから始まる整数です。アニメーションの最初のフレームでは、time 値は 0 です。 アニメーションの継続時間が 10 フレームである場合、最後のフレームの time 値は 9 です。
実装 public function get time():int public function set time(value:int):voidpublic var transformationPoint:Point| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
表示オブジェクトを回転または拡大 / 縮小するための基準点です。2D モーションの場合、変換ポイントは、表示オブジェクトの境界ボックスを基準にして表します。ポイントの座標は 1px × 1px のボックスに縮小 / 拡大されます。ここで、(1, 1)はオブジェクトの右下隅を表し、(0, 0)は左上隅を表します。3D モーションの場合(AnimatorBase インスタンスが Animator3D)の場合、transformationPoint の x と y に transformationPointZ を加えたものが、ターゲットとなる親座標空間の絶対値になります。
public var transformationPointZ:intusingCurrentFrame:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
新しいフレームが入力されるたびに、currentFrame プロパティが確認されるかどうか、およびターゲットのアニメーションが親のタイムラインのフレームと同期されているかどうか、または親の現在のフレームにかかわらず、常に進んでいるかどうかを示します。
実装 public function get usingCurrentFrame():Booleanpublic function AnimatorBase(xml:XML = null, target:DisplayObject = null)| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
AnimatorBase オブジェクトを作成して、XML ベースのモーショントゥイーン記述を表示オブジェクトに適用します。XML が null(デフォルト値)の場合、XML を Motion インスタンスに直接指定するか、Motion インスタンスで、プロパティ値の配列を設定できます。
パラメータ | xml:XML (default = null) — XML ベースのモーショントゥイーン記述を含んでいる E4X オブジェクトです。 |
| |
| target:DisplayObject (default = null) — モーショントゥイーンを使用する表示オブジェクトです。 |
関連項目
public function end(reset:Boolean = false, stopEnterFrame:Boolean = true):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
アニメーションを停止し、Flash Player がアニメーションシーケンスの最後のフレームに直ちに移動します。autoRewind プロパティを true に設定すると、Flash Player がアニメーションシーケンスの最初のフレームに移動します。
パラメータ
| reset:Boolean (default = false) —
_lastRenderedTime および _target を元の値にリセットするかどうかを示します。_target は、targetParent および targetName が指定されている場合のみリセットされます。
|
| |
| stopEnterFrame:Boolean (default = true) |
関連項目
public function nextFrame():void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
Flash Player をアニメーションシーケンス内の次のフレームに進めます。
public function pause():void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
resume() メソッドを呼び出すまでアニメーションを一時停止します。
関連項目
public function play(startTime:int = -1, startEnterFrame:Boolean = true):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
アニメーションを開始します。end() メソッドを呼び出した後で play() メソッドを呼び出すことで、それまで実行されていたアニメーションのインスタンスをすべて終了してから新しいインスタンスを開始できます。
パラメータ
| startTime:int (default = -1) — 代わりに使用する開始時間(相対フレーム)を示します。指定されていない場合、デフォルトの開始時間として 0 が使用されます。 |
| |
| startEnterFrame:Boolean (default = true) —
フレームイベントをキャプチャするために、イベントリスナーを親に追加する必要があるかどうかを示します。値を false に設定できるのは、親が registerParentFrameHandler() を介して、AnimatorBase インスタンスに登録されている場合です。
|
関連項目
public static function processCurrentFrame(parent:MovieClip, anim:AnimatorBase, startEnterFrame:Boolean, playOnly:Boolean = false):void パラメータ
public static function registerButtonState(targetParentBtn:SimpleButton, anim:AnimatorBase, stateFrame:int):void パラメータ
public static function registerParentFrameHandler(parent:MovieClip, anim:AnimatorBase, spanStart:int, repeatCount:int = 0, useCurrentFrame:Boolean = false):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
与えられた MovieClip の子に対して、AnimatorBase インスタンスおよびその MovieClip を登録します。 親 MovieClip の FRAME_CONSTRUCTED イベントが処理され、その currentFrame と AnimatorBase の spanStart プロパティが、再生されるアニメーションの現在の相対フレームを決定するために使用されます。
この関数を呼び出すと、同じ名前のパラメータを使用して、AnimatorBase の useCurrentFrame プロパティが自動的に true に設定され、その spanStart プロパティも自動的に同じ値に設定されます。
パラメータ
| parent:MovieClip — AnimatorBase インスタンスの親 MovieClip です。 |
| |
| anim:AnimatorBase — 親 MovieClip に関連付けられた AnimatorBase インスタンスです。 |
| |
| spanStart:int — 親 MovieClip のタイムラインに関するアニメーションの開始フレームです。 |
| |
| repeatCount:int (default = 0) — アニメーションを再生する回数です。デフォルト値の 0 では、アニメーションが無限にループします。 |
| |
| useCurrentFrame:Boolean (default = false) — 新しいフレームが入力されるたびに useCurrentFrame プロパティが確認されるかどうかを示します。 |
public function resume():void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
pause() メソッドで一時停止されていたアニメーションを再開します。
関連項目
public function rewind():void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
Flash Player をアニメーションの最初のフレームに設定します。アニメーションが再生中だった場合は、最初のフレームから再生が続行されます。アニメーションが停止していた場合は、最初のフレームで停止状態になります。
public function startFrameEvents():void public function stop():void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
アニメーションを停止し、Flash Player がアニメーションシーケンスの最初のフレームに戻ります。
関連項目
public function useCurrentFrame(enable:Boolean, spanStart:int):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
新しいフレームが入力されるたびに、currentFrame プロパティを設定し、ターゲットのアニメーションを親 MovieClips のタイムラインのフレームと同期するかどうかを設定します。spanStart は、親のタイムラインに関するアニメーションの開始フレームです。enable が true の場合、アニメーションの範囲内の任意のフレーム開始イベントにおいて、time プロパティが spanStart フレームを基準としたフレーム番号に対して設定されます。
例えば、フレーム 5 で開始する(spanStart=5)4 フレームのアニメーションで、フレーム 8 に gotoAndPlay するというスクリプトがフレーム 5 にある場合、フレーム 8 に入ると、time プロパティが 3 に設定され、time = 1 および time = 2 がスキップされます。
パラメータ
| enable:Boolean — currentFrame プロパティが確認されるかどうかを決定する true または false の値です。 |
| |
| spanStart:int — 親 MovieClip のタイムラインに関するアニメーションの開始フレームです。 |
イベントオブジェクトの型: fl.motion.MotionEventプロパティ MotionEvent.type = fl.motion.MotionEvent.MOTION_END| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
モーションの最後に到達したか、stop() メソッドまたは end() メソッドによってモーションが中断されたために、再生が完了したときに送出されます。
Animator.stop() または
Animator.end() が明示的に呼び出されるか、Motion インスタンスの最後に到達することによって、モーションが停止されたことを示します。
イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|
bubbles
| false |
cancelable
| false |
currentTarget
|
イベント処理を行うイベントリスナーの定義用オブジェクトを表します。例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。
|
target
|
イベントを送出したオブジェクトを表します。このオブジェクトは必ずイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用します。
|
イベントオブジェクトの型: fl.motion.MotionEventプロパティ MotionEvent.type = fl.motion.MotionEvent.MOTION_START| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
モーションの再生開始時に送出されます。
Motion インスタンスの再生が開始されたことを示します。
イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|
bubbles
| false |
cancelable
| false |
currentTarget
|
イベント処理を行うイベントリスナーの定義用オブジェクトを表します。例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。
|
target
|
イベントを送出したオブジェクトを表します。このオブジェクトは必ずイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用します。
|
イベントオブジェクトの型: fl.motion.MotionEventプロパティ MotionEvent.type = fl.motion.MotionEvent.MOTION_UPDATE| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
モーションが変更され、画面が更新された場合に送出されます。
Motion インスタンスが変更され、画面が更新されたことを示します。
イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|
bubbles
| false |
cancelable
| false |
currentTarget
|
イベント処理を行うイベントリスナーの定義用オブジェクトを表します。例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。
|
target
|
イベントを送出したオブジェクトを表します。このオブジェクトは必ずイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用します。
|
イベントオブジェクトの型: fl.motion.MotionEventプロパティ MotionEvent.type = fl.motion.MotionEvent.TIME_CHANGE| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9.0.28.0 |
Animator の time 値が変化したとき、画面の更新 (motionUpdate イベントなど) 前に送出されます。
Animator インスタンスの
time 値は変化したが、画面はまだ更新されていない (
motionUpdate イベントが送出されていない) ことを示します。
イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|
bubbles
| false |
cancelable
| false |
currentTarget
|
イベント処理を行うイベントリスナーの定義用オブジェクトを表します。例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。
|
target
|
イベントを送出したオブジェクトを表します。このオブジェクトは必ずイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用します。
|
© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 12:14 AM -08:00