現在開発中の”群弾”で使用しているバージョンです。先のエントリーにあったMOVER_MOVETO_L以降のMOVER定義が使用できるようになっています。MOVERの拡張以外にも色々機能が増えているのですが、追々エントリーとして説明していきます。

• addGraphicHit(グラフィックハンドル, テクスチャのX座標, テクスチャのY座標, 当たり判定の幅, 当たり判定の高さ)

この関数で、グラフィックの特定位置に当たり判定に使用する矩形を追加します。当たり判定矩形は最大16個まで設定できます。

当たり判定は「矩形同士が重なっているか？」で判定しています。
重なっているかどうかを取得するには以下の関数を使用します。

• isHitActor([アクターハンドル],アクターハンドル)
• getHitLayer([アクターハンドル],レイヤー番号)

isHitActorは指定されたアクター同士が重なっているかどうかをboolean値として返します。
getHitLayerは指定されたアクターに対して「指定レイヤー上で重なっているアクターのハンドル」をLuaのテーブルとして取得します。
複数のアクターを相手に判定を取る場合、isHitActorで1対1の判定を複数取るよりは、getHitLayerでまとめて判定を取った方が高速になります。レイヤーを使ってアクターをうまく分けておくのがコツです。(STGなら自機と敵の弾は別のレイヤーに置くとか)

• アクターハンドル = createActor(グラフィックハンドル, 初期X座標, 初期Y座標[, 初期角度, 初期速度], 表示レイヤー番号[, クラス名])
• addMover(アクターハンドル, 開始時間, 継続時間, 動作命令[, 命令引数1[, 命令引数2[, 命令引数3]]])
• clearMover(アクターハンドル)

「createActor関数でアクターを作る」→「作ったアクターにaddMover関数で動きを与える」がAIMSにおけるキャラクタ制御の基本です。

addMoverで動作を操作するためには、createActorを実行したときに返ってくるアクターハンドル（number）を保存しておく必要があります。

開始時刻はその動作を開始する時刻(単位フレーム)です。この命令を呼んた直後を0として、指定したフレーム数だけ経過したら動作が始まります。継続時間は動作を続ける時間となります。

addMoverで指定できる動作命令は「MOVER定義一覧」のページを参考にしてください。
（現在公開されている1.01ではMOVER_MOVETO_L以降の定義は実装されていません）

clearMover関数は登録されている動作命令（待機中のもの含む）を全て消去します。ただし、既に変更されてしまった値（速度・角度・透明度・カラーなど）は元に戻りません。

AIMS addMoverサンプル

• getJoyPressCount([ゲームパッドID,]キーID)
• isJoyPressed([ゲームパッドID,]キーID)

キーIDはそれぞれ以下のようなものが定義されています。

• BUTTON_UP/BUTTON_DOWN/BUTTON_RIGHT/BUTTON_LEFT
  キーボード・USBゲームパッドの上下左右キー。
• BUTTON_TRIG1～BUTTON_TRIGXX
  ゲームパッドのボタン。キーボードでは設定ファイルの記述に準拠します。

getJoyPressCountはそのボタンが押されている時間(フレーム数)を、isJoyPressedは押されているかどうかのboolean値(trueかfalse)を、それぞれ返します。あるボタンが1秒間(60フレーム)押しっぱなしになっていたらgetJoyPressCountは60を返すという仕組みです。

サンプルの中で表示位置を移動するのに使っているaddMover関数は別のページで説明します。

AIMSキー入力サンプル

• 画像のロード：loadGraphic(AIMS.exeからの相対パス)
• 画像の表示：createActor(グラフィックハンドル, X座標, Y座標, レイヤー番号)

これらの関数を用いて画像を読み込み、表示させます。

また、表示している画像は明示的に開放を行う必要があります。

• 画像の消去：vanish(アクターハンドル)
• 画像リソースの開放：deleteGraphic(グラフィックハンドル)

開放しない場合VGAのメモリに残り続けるため、メモリ不足になる可能性があります。

AIMSでは表示させた画像ひとつひとつを「アクター」と呼びます。
正確には「画像を表示している」のではなく「アクターが画像を表示している」と言うのが正しい表現になります。

AIMS 画像表示サンプル

• common.lua
  ゲームの制作に必要と思われる関数一式を記述するファイル。
  DNA-Sで制作に使っている関数などが記述されています。
• AIMS.lua
  AIMSの起動に必要な設定が一式記述されたファイル。
  書き換えする必要はほとんどありません。
• boot.lua
  AIMSが起動して一番最初に読み込むスクリプトファイル。

AIMSは起動するとまずboot.luaをオープンします。
そしてLuaの流儀に従い、functionの外で宣言された変数をグローバル変数として組み込みます。
サンプルでははじめに”prequire(“common.lua”);”と記述されていますが、これでcommon.luaの中に記述された関数などが組み込まれます。
次に素材の各種リソースハンドルを保存するための「G」「S」「A」というテーブルをグローバル変数として宣言しています。

※別にリソースハンドルはどんな名前の変数に保存してもいいんですが、テーブルの中に入れておくと解放が楽だったり、他の変数との衝突が避けられるという理由から、D.N.A. Softwaresとしては上記のテーブルの中に保持することを推奨しています。

それらの動作が終了したら、まず「OnLoad」という関数を実行します。
この「OnLoad」という関数を実行するとbootシーンという最初のシーンを起動します。
（※シーンに付いては後述）

スクリプト内部で「quit」という終了関数が呼ばれるか、Windowsの閉じるボタンが押されると現在実行中のすべてのシーンを強制終了し「OnVanish」という関数を実行しプログラムを終了します。

リリースビルドで不正終了する不具合が見つかりましたので、その点を修正しています。
スクリプト部分についてですが、互換性に関わる仕様変更はありません。1.00で動いていたコードはすべて修正なく動くと思います。

また、一部デバッグ関連のコマンドラインオプションを変更しています。debugOut関数のタイトルバーへの出力がデフォルトでオフになりました。詳細はreadmeをご覧ください。

AIMS のドキュメントページからごらんいただけます。

また、SVNの方にも追加しております。docs/の下に追加されますので、SVNを見ておられる方はご利用ください。

このサンプルは

• 画像のロード
• 画像の切り出し
• 画像のアニメーション
• 入力情報の取得
• addMoverの使い方

について簡単な説明を入れてあります。
起動の際には「proto\AIMS.exe」「proto\AIMS.lua」「proto\common.lua」を解凍した先にコピーしてください。

SVN中では「sample1 Graphic」に同様のファイルがあります。

SUiCA32は構想2時間制作2日なのです。