| メソッド | フレームあり | フレームなし |
Tween クラスはアニメーションの実装に使用できるユーティリティクラスです。Tween オブジェクトでは、開始値、終了値、および補間関数を使用できます。このオブジェクトは、一定の時間間隔でコールバック関数を呼び出し、開始値と終了値の間の補間値をそのコールバック関数に渡します。通常、コールバック関数はオブジェクトのプロパティをいくつか更新することで、そのオブジェクトのプロパティを長時間アニメーション化します。
| コンストラクタ | |
Tween ( listenerObj, init, end, dur, minFps)
コンストラクタです。 |
|
| メソッド | |
| endTween( )
トゥイーンを中断し、直ちにトゥイーンの終わりにジャンプします。 |
| setEasingEquation( targetObj:Object, easing)
: Void アニメーションのイージング関数を設定します。 |
| コンストラクタの詳細 |
Tween( listenerObj, init, end, dur, minFps)
パラメータ
listenerObj - アニメーションの各フレームで通知されるオブジェクトを表します。listenerObj では、onTweenUpdate() と onTweenEnd() の 2 つのメソッドを定義する必要があります。前者はアニメーションのフレームごとに呼び出され、後者はアニメーションが完了した後にのみ呼び出されます。
init - アニメーションの初期値を表します (1 つまたは複数)。数値、または数値の配列のいずれかになります。数値が渡された場合、Tween はその数値と end パラメータで渡された数値との間で補間を実行します。数値の配列が渡された場合は、配列内の各数値が補間されます。
end - アニメーションの終了値を表します (1 つまたは複数)。この引数の型は init パラメータの型と同じである必要があります。
dur - アニメーションの再生時間を表します (ミリ秒単位)。
minFps - onTweenUpdate() メソッドを呼び出す必要がある 1 秒ごとの最小回数を表します。トゥイーンコードは、できるだけ多くの頻度で onTweenUpdate を呼び出そうとします (最大で 1 秒あたり 100 回)。ただし、頻度が minFps よりも少なくなった場合は、アニメーションの再生時間が自動的に増やされます。その結果、CPU サイクルが得られずに一時的にフリーズしたアニメーションは、フリーズした位置から再生が再開されます。フリーズした位置よりも後の位置から突然再開することはありません。
| メソッドの詳細 |
endTween( )
setEasingEquation( targetObj:Object, easing)
: Void
init 値と end 値の間の補間に使用されます。一般のイージング関数は線形補間を実行しますが、より高度なイージング関数では加速と減速の効果を生成して、アニメーションがより自然になるようにします。イージング関数を指定しない場合は、Math.sin に基づくイージング関数が使用されます。
イージング関数は、Robert Penner 氏が普及に尽力した関数シグネチャに従っています。この関数では 4 つの引数を使用できます。1 番目の引数は、アニメーションの開始時刻を 0 とした "現在の時刻" です。2 番目の引数は、アニメーション開始時の初期値 (数値) です。3 番目の引数は、終了値から初期値を引いた値です。4 番目の引数は、アニメーションの再生時間です。戻り値は、現在の時刻に対する補間値になります。通常は、初期値と終了値の間の値になります。
パラメータ
targetObj:Object - イージングパラメータがイージング関数の名前である場合は、その名前に一致するメソッドを targetObj で探します。メソッドが見つからない場合は、targetObj.parent でメソッドを探し、イージング関数が見つかるまでオブジェクト階層の上位に向かって探し続けます。イージングパラメータに (関数の名前ではなく) 関数が含まれている場合は、この引数は無視されます。
easing - 関数か、またはイージング関数の名前を含んでいるストリングを表します。