AnimPlayType

# アニメーションの再生モード

## 説明

アニメーションコントローラ は、アニメーションを再生させる方法として、大きくワンタイム再生モードとリピート再生モードの２種類のモードを持っています。 以下にこれらの再生モードについて説明します。

## ワンタイム再生モード

アニメーションを1度だけ再生します。アニメーションの最終フレームを再生した後、アニメーションは停止します。

## リピート再生モード

アニメーションを繰り返し再生します。アニメーションには、リピートフレームを持ち、最終フレームを再生した後、指定されているリピートフレームにジャンプすることにより、アニメーションを繰り返して再生します。アニメーションの開始フレームとリピートフレームの前までは、一度しか再生されません。

## 往復再生モード

アニメーションの最終フレームを再生した後、リピートフレームに向かって逆再生を行います。逆再生でリピートフレームの表示が完了した後、アニメーションは停止します。アニメーションの開始フレームとリピートフレームの前までは、一度しか再生されません。

## 往復リピート再生モード

アニメーションのリピートフレームと最終フレームの間の往復再生を繰り返します。アニメーションの開始フレームとリピートフレームの前までは、一度しか再生されません。

# アニメーションの特殊再生機能

## 説明

アニメーションコントローラでは、以下に示すような特殊なアニメーションの再生を行う事が出来ます。

## 逆再生

アニメーションを最終フレームから逆方向に再生することが可能です。ワンタイム再生モードでは、最初のフレームを再生した後に、アニメーションは停止します。リピート再生モードでは、リピートフレームを再生した後、最終フレームにジャンプします。よって、リピート再生モードでの逆再生の場合、開始フレームから、リピートフレームまでのアニメーションは再生されないことになります。

## 更新フレーム倍率変更

アニメーションコントローラはアニメーション更新の際に、アニメーションの更新フレーム倍率を変更する事が出来ます。更新フレーム倍率はfx32型で指定し、1.0より大きい場合はアニメーションが早く、1.0より小さい場合には、アニメーションが遅くなります。コントローラ内部では、更新フレーム倍率にアニメーション再生スピードが乗算され、実際の更新フレーム数が決定されています。 なお、更新フレーム倍率にたいしてマイナスの値は設定不能です。

## コールバック関数の呼び出し機能

アニメーションコントローラは、アニメーションの特定のフレームを再生した時に、ユーザが何らかの処理を行う事が出来るようにコールバック関数を呼び出す機能を持っています。コールバック関数は、以下に示す３種類のタイミングで呼び出されるように設定することが可能です。
アニメーションを構成するセルまたはマルチセルが切り替わる度にコールバック関数を呼び出す。
アニメーション中の指定した特定のセルまたはマルチセルが表示された時にコールバック関数を呼び出す。
アニメーションの最終フレームでコールバック関数を呼び出す。
コールバック関数には、ユーザが指定した４バイトのデータを１つだけ渡す事が出来ます。

## 参照

なし

## 履歴

2004/12/06 初版