指定された名前で登録されている情報を元にして「コマ送り描画オブジェクト」を生成する. このオブジェクトは次のメソッドを持つ.

• paint(ctx, x, y) - 指定された位置に現在のコマを描画し, 内部状態を更新する
• finished() - 描画するコマが残っていないときtrue, そうでないときfalse

paintメソッドを呼び出されるたびに内部状態が更新され, 自動的にコマ送りが進行する. すべてのコマを描画し終えたときの挙動は repeatによって変わる.

• repeatがtrueならば, 最初のコマに戻る
• repeatがfalseならば, これ以上何も描画しない

ImageCutterオブジェクトと「アニメーション定義リスト」の組を 指定された名前で登録する. ここで, アニメーション定義リストは,

[a, b, frames, offX, offY]

という形のリストをアニメーションのコマの数だけ並べた 2重配列である (offX, offYは省略可).

各成分は次の意味を持つ.

• (a,b) : ImageCutter内のどのブロックを描画するか指定する
• frames : そのコマを表示するフレーム数
• offX : 横方向に表示位置をどれだけずらすか (省略時は0)
• offY : 縦方向に表示位置をどれだけずらすか (省略時は0)

たとえば, 各コマの画像を横一列に並べて連結したものを ImageCutterにより分割して使う場合, 次のようなコードになる.

const IC = new stdgam.ImageCutter(連結した画像, 1コマの横幅, 1コマの縦幅);
const IA = new stdgam.ImageAnimator();
IA.register("animation_01", [
    [0, 0, 表示フレーム数],
    [1, 0, 表示フレーム数],
    [2, 0, 表示フレーム数], ...
]);