Antirrhinum は EntisGLS4 で提供される疑似言語フレームワークで、ゲーム中のスクリプト記述を容易にカスタマイズして提供することを目的としたインタプリタ言語です。
　コマンドの実装や書式を容易にカスタマイズできるというコンセプトは EntisGLS3 での詞葉言語と同様のものですが、Antirrhinum では付け加え、実装面でのカプセル化が大幅に強化されています。

　EntisGLS4 には独自言語として、Sakura2（詞葉言語）仮想マシン、Rosetta スクリプト言語、Antirrhinum の３つが提供されており、それぞれの位置づけが異なります。

　Sakura2（詞葉）は EntisGLS3 で提供されていた独自の言語と仮想マシンのサブセットでしたが、EntisGLS4 では実行のための仮想マシンのみのサブセットが提供されています。
　EntisGLS4 自体は元々詞葉コンパイラの C++ 互換モードでコンパイルできるコードとして記述されています。
（但し、現在は Android での C++ 開発環境が整ってきていることなどから詞葉は使用せず専ら C++ でコンパイルすることしか想定されていませんが、API 群は EntisGLS4 をベース、使用できる文法は C++ 互換モード（凡そ C++98～C++03 相当）を基準としたコードとなっています）

　一方、Rosetta は EntisGLS4 で提供されるスクリプト言語で、ゲーム中のスクリプト言語や、その他テキスト、画像、音声、動画などを簡易に処理することを目的としたインタプリタ言語です。
　また実行時には Sakura2 仮想マシン用のバイナリを出力するコンパイル機能を有しており、Sakura2 の JIT コンパイル機能を利用してネイティブコード化して高速に実行することもできます。
　Antirrhinum コンパイラも Rosetta で記述されています。

　一方で、Antirrhinum は主にゲーム中のスクリプトを記述（高級な処理手順を記述）することを目的としています。
　特にスクリプトとして利用する際に、スクリプト呼び出し側から、スクリプトの途中まで（１フレーム分の処理のみを）実行できる機能を有していることが特徴です（これは Sakura2 仮想マシンにもある機能ですが、Rosetta にはない機能です）。
　EntisGLS4 には Rosetta のインタプリタ、及びコンパイラ機能が提供されるため、Antirrhinum のソースコードは EntisGLS4 上で動的にコンパイルして実行することもできます。

　Antirrhinum コンパイラはプレーンテキストのソースコードをコンパイルし、xml 形式のファイルを出力します。
　コンパイラは Rosetta で記述されており、任意の書式のユーザーコマンドを追加することができます。
　ほとんどの書式は書式定義ファイルをコンパイラに渡すことで任意のコマンドを追加することができます。
　あるいはもっと簡単に、マクロスクリプトでより高級なマクロを定義することができます。ユーザー定義コマンドを追加しないならばマクロは非常に強力です。
　またユーザー定義コマンドでなくても、Antirrhinum スクリプト上から Rosetta スクリプトを実行できるため、Rosetta クラス／関数を供給すれば、ゲーム固有の処理をスクリプト上で容易に記述できます。

　Antirrhinum 仮想マシンでは、実行コマンドとそれの実行プロセッサー（後述 EpicProcessor）は高度にカプセル化されています。
　１つの EpicProcessor は１つのコマンドセットを実装しており、仮想マシンには複数の EpicProcessor を任意に組み合わせて使用できます。
　正しく設計・実装された EpicProcessor は、仮に他の EpicProcessor と依存関係にあっても疎な結合であり、自由な組み合わせで使用することができます。
　GUI の構造が大幅に変更されようとも、あるいは、ノベル・アドベンチャー、RPG、シミュレーション、シューティング、アクション等、ジャンルに依らず、同様の要素は容易に使いまわすことができます。

　本書の後半には標準実装のコマンドを収録していますが、Antirrhinum のコンセプトはユーザー定義コマンドの自由なカスタマイズと、実装のカプセル化ですから、あくまで標準実装コマンドは標準実装コマンドにすぎません。

　Antirrhinum コンパイラは「基本的に」ソースコードを行単位で解釈します。
　行の先頭（空白やタブなどを除いた）に特定の文字 '.'（ピリオド） '$'（ドル） '#'（シャープ） ';'（セミコロン）を見つけると、その行はディレクティブとして解釈されます。

　ここでは構文の書式は以下のように表記します。

　コメント行は何も出力されません。

　Rosetta スクリプト文を記述できます。
　${ } の場合、波括弧の間は複数行に渡って記述することができます。
　Rosetta 文はすべての構文を記述できます。反復文や任意の関数の呼び出しもできますが、長い処理は推奨されません。
（処理中はステートセーブができません。具体的には後述の AGLKernel::Execute 関数から復帰しないためです。）

　ラベル名を定義します。
　ラベルは .call や .jump、.thread 文で処理を開始する行を指定する識別子です。

　.if ディレクティブは expr 条件式が真の時に .if～.else（又は .elseif、.end）までのブロックを実行します。
　条件式の評価が偽の時に .else～.end ブロックが実行されます。

　expr 条件式が真の間 .while～.end ブロックを実行します。

　.call 呼び出しから復帰、又はスレッドを終了します。
　if で条件式 expr を指定した場合、評価が偽の時には何もしません。

　.while 反復ブロックから脱出します。
　if で条件式 expr を指定した場合、評価が偽の時には何もしません。

　.while 反復ブロックの先頭に（反復条件判定まで）戻ります。
　if で条件式 expr を指定した場合、評価が偽の時には何もしません。

　サブルーチンを呼び出します。
　if で条件式 expr を指定した場合、評価が偽の時には何もしません。
　script はスクリプトファイル名、label は後述のラベル識別子です。空白文字を含む場合には、'（シングルクォーテーション）、又は "（ダブルクォーテーション）で囲みます。script ファイルの拡張子は省略でき（推奨）、省略した場合には .xmlagl が付加されます。
　ラベル名を省略した場合にはスクリプトファイルの先頭から実行されます。

　処理を移行します。
　if で条件式 expr を指定した場合、評価が偽の時には何もしません。
　script#label 指定は .call ディレクティブと同様です。

　サブルーチンをスレッドとして実行します。
　if で条件式 expr を指定した場合、評価が偽の時には何もしません。
　script#label を省略した場合、.thread～.end ブロックをスレッドとして実行します。
　as で name を指定した場合、@terminate 文でスレッドを即時終了させることができます。

　実行を１フレーム待機します。

　.macro ～ .endm ブロックをマクロとして定義します。
　定義したマクロは、ユーザー定義コマンドと同様に、行頭に記述することでマクロを呼び出して展開することができます。
（ユーザー定義コマンドと同名のマクロを定義した場合、マクロ定義が優先されます）
　マクロ引数の定義で、"arg0" のようにダブルクォーテーションで囲むと、その引数は文字列引数として定義され、ダブルクォーテーションで囲んで引数が渡されると、クォーテーション内部の文字列が引数として解釈されます。
　マクロ引数の後ろに = 記号でデフォルト値を定義することができます。
　マクロを展開する際、引数が省略されているとデフォルト値が使用されます。
　マクロ引数は必ず , （コンマ）記号で区切ることに注意してください。

　.macro ～ .endm 間にはマクロの内容を記述します。
　文中にマクロ引数名に一致するトークンが存在すると、マクロとして展開されます。
　マクロ引数をより明示的に記述するには以下のようにします。


　例えば以下のようなマクロ を定義し、 のように記述した場合、 のように展開されます。
（ユーザー定義コマンド同様、マクロ名はメッセージ文と干渉しないようなマクロ名にすることが必要です）

　マクロ引数に , （コンマ）記号を含めたい場合などには、<> 記号で囲んで記述することができます。
は、 のように展開されます。

　マクロ文はユーザー定義コマンドと同じように複数のコマンドを１行で記述できる点で似ていますがが、以下のようにユーザー定義マクロでは使用できないディレクティブを含むことができます。

　マクロ変数を定義します。
　マクロ変数はコンパイル時に評価される変数で、マクロ式中でのみ使用できます。
　マクロ式は、.mlet の右辺、.mexpr ディレクティブ、マクロ展開文中の %() 内でのみ利用できます。

　マクロ変数は、Antirrhinum スクリプトを超えて保持されます（複数のスクリプトを一度にコンパイルする場合に、以前コンパイルした結果が残っています）。

　マクロ式を実行します。
　一度 .mlet ディレクティブで定義しておけば、以下のように代入演算なども .mexpr ディレクティブで実行できます。

　ディレクティブ以外のコマンドは、任意に追加することができます。
　コマンドの書式には大きく分けて４つのパターンがあり、コマンドごとにそのいずれかを選択して定義することができます。

　初めにコマンド名を記述し、それに続けて引数リストを記述する書式です。
　各引数はクォーテーションで囲むこともでき、また引数同士を ,（コンマ）で区切って記述することもできます。
　引数をクォーテーション記号で囲んだ場合には、文字列は C 言語 \ エスケープシーケンスと同様の処理が施されます。
（但しシングルクォーテーションで囲んだ場合にはダブルクォーテーション、ダブルクォーテーションで囲んだ場合シングルクォーテーションは \ エスケープシーケンス無しでも記述できます）
　クォーテーション記号で囲まない場合、引数は空白（又はタブ）記号で区切られるため、引数に空白を含むことができないことに注意してください。

　引数を省略する場合には、引数を記述せずに（あるいは空白のみで） ,（コンマ）で区切って指定します。
　例１と例２は同じ意味です。
　コマンド名の先頭に @（アットマーク）を付加する必要はありませんが、後述するメッセージコマンドとの干渉を避けたい場合などに、@ や _ などをコマンド名の先頭文字にすることが推奨されます。

　初めにコマンド名を記述し、それに続けて名前付き引数リストを記述する書式です。
　この書式の場合、引数を記述する順序は任意となります。
　但し、name を省略することもでき、その場合にはデフォルトの順序で引数を記述することになります。
　また、parameter をクォーテーション記号で囲んだ場合には、文字列は C 言語 \ エスケープシーケンスと同様の処理が施されます。
（但しシングルクォーテーションで囲んだ場合にはダブルクォーテーション、ダブルクォーテーションで囲んだ場合シングルクォーテーションは \ エスケープシーケンス無しでも記述できます）
　parameter をクォーテーション記号で囲まない場合に、空白を含む引数は記述できません。

　引数を EntisGLS4 の正規表現形式で指定した書式で記述するタイプです。
（EntisGLS4 の正規表現形式については後述）

　いずれのユーザー定義コマンドにも合致しない場合、これをメッセージ文として EntisGLS4 の正規表現形式で指定した書式で記述するタイプです。
　メッセージ文とは、会話やモノローグなどの文章をゲーム中にメッセージウィンドウなどに出力することを想定したもので、ユーザーコマンドの書式ではない文章をそのまま処理することができる、記述効率と視認性を向上させるための構文です。
　メッセージ文書式は他のユーザー定義コマンドとは異なり、１つしか定義できません。

　Core コマンドとは、システムで定義されたユーザー定義コマンドです。

　指定のミリ秒だけ処理を停止します。

　condition-expr の評価値が真になるまで停止します。
　timeout-expr を指定した場合、タイムアウト時間（ミリ秒）を指定することもできます。

　タイマーをリセットし、この文が実行された時間を 0 とします。

　@start_timer 実行時点から、timeout-expr で指定された時間（ミリ秒）が経過するまで停止します。
　timeout-expr は一度の待機につき一度だけ評価されます。毎フレーム再評価はされません。但し、再度実行される際には再評価されます。

　thread-name で指定された名前のスレッドが実行中の場合、即座に終了させます。

　デバッグ用のトレース出力へ trace-string 文字列を出力します。
　文字列中に %(expr) 形式の記述がある場合、expr が Rosetta スクリプトの数式として評価され、文字列に置換されて出力されます。

　このスレッドでの待機命令のスキップを許可します。
※ .thread 文で生成されたスレッドは、デフォルトでは待機命令のスキップは許可されていません。

　このスレッドでの待機命令のスキップを禁止します。
　flags は @permit_skip と同じです。

　割り込み禁止フラグを設定します。
　通常は禁止フラグは設定されていません（0）。
　割り込み禁止フラグが設定されている（1）と、割り込みの発生が禁止されます。
　キー入力等で割り込みが発生する（特定ラベルへジャンプ／コールする）ような特殊なシステムで、割り込みを発生させたくない区間で禁止フラグを設定します。
　設定された割り込み禁止フラグは、現在のブロック（又は関数）を脱出すると以前の状態に復帰します。
　割り込みを利用する場合でも、このコマンドではなく、割り込みを発生させるシステムで用意されたコマンドで制御すべきです（UI等の連動の為）。

　書式定義ファイルは、文字通りユーザー定義コマンドの書式を定義したファイルです。
　xml 形式で記述します。

　Antirrhinum コンパイラはソースコードを xml 形式に変換しますが、各コマンドは基本的に１つの xml タグに対応しています。
　書式定義ファイルは、このコマンドごとの対応を記述します。
　また、変則的な処理を行いたい場合には、その処理を Rosetta スクリプトで定義ファイル内に記述することもできます。

　書式定義ファイルを書き換えるだけでスクリプトの書式を容易に定義／変更することができます。

　agl_usage_definition タグは書式定義ファイルのルート要素です。

　rosetta-script-path に指定された Rosetta スクリプトファイルを読み込みます。
　また、listener-class が指定された場合、インスタンスを作成しコンパイラにリスナを追加します（後述 AGLCompiler.Listener 参照）。

　antirrhinum-macro-path に指定された Antirrhinum マクロファイルを読み込みます。

　def-file-path に指定された書式定義ファイルを追加で読み込みます。
　import タグで読み込まれる書式定義ファイルに import タグがあっても問題ありません。
　また、同じ書式定義ファイルが２回以上 import される場合には、２回目以降は処理はスキップされます。

　command タグはユーザー定義コマンドの書式と、出力する xml タグの対応を定義します。

　command-lead-string はユーザー定義コマンドのコマンド名に該当します。

　ouput-tag-name と arg-def-list は出力する xml タグのタグ名と、属性名に対応しています。
　arg_type 属性には書式のタイプを指定します。
　array は配列タイプ引数、named は名前付き配列タイプ引数、var_named は名前付き配列タイプ引数ですが、定義された引数以外の名前の記述も可能な書式です。
　arg_type="usage" を指定した場合には arg-regular-expression に書式を EntisGLS4 の正規表現で指定します。

　arg-def-list に指定したパラメータ名（xml-attr-name）をそのまま出力しない場合や、複数の xml タグとして出力する場合には、prototype-list を記述します。
　prototype-list では、一つの prototype タグが、出力する一つの xml タグに対応します。
　vararg="1" を指定したコマンドはプロトタイプに定義されていないパラメータも出力します。

　またより複雑なパラメータへの加工を行いたい場合には、proc タグで処理関数を Rosetta スクリプトで記述できます。
　関数は引数に HashMap を受け取り、これはユーザー定義コマンドをパースした arg-def-list に対応しています。
　スクリプトではパラメータを変更したり、追加することができます。
　また、getParserContext() メソッドで取得できる HashMap オブジェクトに値を保存したり取り出したりして、文脈に依存した処理を行うこともできます。
　処理された HashMap をソースとして prototype-list に基づいた xml タグの出力が行われます。

　message タグはメッセージ文の書式と、出力する xml タグの対応を定義します。
　通常は regular-expression に EntisGLS4 の正規表現でメッセージ文全体の書式と、出力する xml タグの属性を指定します。
　但し、parser タグにパーサー関数を記述した場合には regular-expression と arg-def-list を指定する必要はありません（無視されます）。

　パーサー関数は１つ目の引数に HashMap を、２つ目の引数にメッセージ文が設定された StringParser を受け取り、関数はメッセージ文を解釈して、HashMap にパラメータを設定し、構文に誤りがなければ true を返却します。
　パーサー関数は単純に１行を処理するだけではなく、getParserContext() メソッドで取得できる HashMap オブジェクトに値を保存したり取り出したりして、文脈に依存した解釈を行うことができます。

　また、ユーザー関数同様に proc タグでは、既に解釈されたパラメータへの加工を行うことができます。
　但しユーザー定義コマンドとは異なり、加工関数は String を返却し、これは出力する xml タグのタグ名となります。
　デフォルトのメッセージ文の出力する xml タグは msg となります。
　単にタグ名を任意に変更したい場合には のようにタグ名を返却するだけの関数を記述します。
　null を返却するとそのメッセージ行に対応する xml タグは出力されません。
　複数のタグを出力したい場合や完全にマニュアルで出力したい場合には、加工関数内で addCodeCommand を呼び出し、null を返却します。
（getParserContext() で取得する HashMap に文脈情報を保存しておくことによって、複数行で１つの xml タグを出力することもできます）

　コマンドラインツールは、Tools ディレクトリに置かれています。
　コンパイラクラスである AGLCompiler は antirrhinum.rs に記述され、コマンドラインの引数の解釈は antirrhinum_compiler.rs に実装されています。
　antirrhinum.bat は antirrhinum_compiler.rs を呼び出しています。

　デフォルトの書式定義ファイルもこのディレクトリに設置されており、コンパイラは環境変数 ANTIRRHINUM_HOME を参照し、カレントディレクトリにファイルが見つからないとき、%ANTIRRHINUM_HOME%\Tools に相当するディレクトリのファイルを探します。

　usage-def-file には書式定義ファイルを、config-file には設定ファイルを、output-file には出力ファイル名を、destination-directory には出力ディレクトリを、source-file には Antirrhinum スクリプトソースファイルを指定します。
　書式定義ファイルとソースファイルは複数指定することができますが、複数の書式定義ファイルを import する書式ファイルを記述しておけば 1 つにすることができます。
　ソースファイルを複数指定した場合には出力ファイル名は指定できません（同名の .xmlagl ファイルが出力ディレクトリへ出力されます）。

　設定ファイルはコンパイラ（書式定義ファイルから読み込むスクリプトが参照してコンパイルする際）に、設定を反映するためのものです。
　スクリプト毎に自由な設定の書式をとることができますが、基本的に後述の AGLKernel::LoadConfiguration で読み込む設定ファイルと全く同じものを渡してコンパイルできるように設計します。

　AGLCompiler を直接使用してコンパイルする場合には以下のような Rosetta スクリプトを記述します。
　一度 AGLCompiler オブジェクトを作成し、設定ファイル、書式定義ファイルを読み込んでおけば、再度書式定義ファイルを読み込み直さなくても何度でもスクリプトファイルをコンパイルできます。
（ここでは簡略化のためエラー判定を省略しています）

　コンパイル結果をファイルへ書き出さずに直接メモリ上で受け取りたい場合には、run メソッドの代わりに、 のようなコードで、buf に直接 xml ファイルのバイナリを受け取ることができます。
　この場合でも何度もスクリプトファイルをコンパイルすることができます。
（initialize メソッドでは書式定義やマクロ定義は保持されます）

　書式定義ファイルを読み込みます。
　関数が成功すると true が返されます。

　設定ファイルを読み込みます。
　関数が成功すると true が返されます。
　読み込んだ XMLDocument は getConfig 関数で取得できます。

　スクリプトをコンパイルします。
　strSrcPath には Antirrhinum スクリプトファイル名を、strDstPath には出力ファイル名を指定しします。
　関数は発生したエラー数を返します。

　スクリプトコンパイル用リソースを初期設定します。
　但し、書式定義やリスナの設定などは初期化されません。

　Antirrhinum スクリプトを読み込んでコンパイルします。
　strFilePath にはスクリプトのファイルパスを指定します。
　flagNoSuccessReport に true を指定した場合、エラーが発生しなかった場合には標準出力に結果を出力しません。
　関数は発生したエラー数を返します。

　この関数は run から呼び出されます。

　Antirrhinum スクリプトをコンパイルします。
　sparsSrc には Antirrhinum スクリプトを、strFilePath にはスクリプトのファイル名を指定します。
　flagNoSuccessReport に true を指定した場合、エラーが発生しなかった場合には標準出力に結果を出力しません。
　関数は発生したエラー数を返します。

　この関数はファイルを介さずに直接コンパイルすることができます。
　strFilePath は仮のもので構いませんが、AGLCompiler.Listener がファイル名を使って何らかの処理をする場合には、その処理に対して有効な名前にしておく必要があります。
　この関数は loadSourceFile から呼び出されます。

　コンパイルされた xml をファイルへ出力します。
　strFilePath には出力するファイルパスを指定します。
　関数が成功すると true が返されます。

　コンパイルされた xml を SmartBufferFile へ出力します。

　最後に出力された xml タグを取得します。

　コマンド用 xml タグを追加します。

　loadConfigFile で読み込んだ XMLDocument を取得します。
　読み込んでいない場合には null が返されます。

　指定されたクラスに適合する Listener を取得します。

　書式処理関数で利用できる HashMap オブジェクトを取得します。
　自由にオブジェクト要素を追加、変更、削除して構いませんが、処理関数同士で副作用がないように注意しなければなりません。

　エラーを出力します。

　書式定義ファイルで Rosetta スクリプトを読み込む場合、そのスクリプトで AGLCompiler.Listener 派生クラスを記述し、より複雑なコンパイル処理をカスタマイズすることができます。

　リスナの初期化処理が必要な場合、ここで行います。
　xmlTag には書式定義ファイルの <script> タグが渡されます。追加的なパラメータをタグの属性に記述しておき、それを使って初期化することができます。

　Antirrhinum スクリプトのコンパイルを開始する際に、ファイル毎に呼び出されます。
　strScriptFile には AGLCompiler.compileSource に渡されたファイル名が渡されます。

　空白行を通過する際に呼び出されます。

　ディレクティブやユーザー定義コマンドに合致しない行は、メッセージ文として解釈される前に呼び出されます（空白行は呼び出されません）。
　line にはスクリプト１行が設定されています。
　リスナが何らかの処理を行い、この後コンパイルする必要が無い場合には true を返却します。

　何らかのコマンドがコンパイルされて xml タグが追加される前に呼び出されます。
　cmd 引数には追加される xml タグが渡されます。このタグの中身を変更した場合、その変更は出力に反映されます。
　タグの出力を中止したい場合、 のように空の要素に変換すると AGLCompiler はタグを出力しません。
　あるいは setTag 関数で <nop> タグへ置き換えます（<nop> タグは出力されますが、標準実装では何も実行されません）。

　この関数は AGLCompiler.addCodeCommand 関数内から呼び出されるため、この関数内で addCodeCommand 関数を呼び出す場合には無限ループにならないように注意が必要です。

　Antirrhinum スクリプトをすべて処理し終えた時に呼び出されます（必ず onBeginCompile の呼び出しに対応します）。

　EntisLGS4 での正規表現と文字列解釈は SSystem::SUsageMatcher クラスで提供されており、これは EntisGLS3 の正規表現と互換性があります。
　元々この正規表現形式は EntisGLS3 で提供される独自の言語「詞葉」のユーザー定義マクロ構文を記述するためのもので、文字単位より文節単位の処理に適しています。

　１つの文節は、空白記号（タブや改行を含む）か（区切り）記号によって区切られた範囲の文字列です。また当然区切り記号自身も１つの文節となります。
　例えば、 のようなテキストは、 のような文字列配列に分解されます。
　ここで１つ注意すべきことがあります。
　例えば、"+=" はなぜ１つの文節になり、");" は２つの文節に分解されたのでしょうか？
　これに対応する最も原始的な実装は SSystem::SStringParser クラスによって行われ、記号（区切り記号）は、通常の記号（連続した場合１つの文節にする）と、必ず１文字で１つの文節になる特殊区切り記号が定義されていて、この場合、括弧記号はデフォルトで特殊区切り記号として設定されているので分割されます。
　次に疑問に思うのは C 言語などと同等の演算子を記述する場合、>> はどうするのか？ということでしょう。
　このような特殊な文節の判定は、処理したい言語毎に SStringParser から派生したクラスが利用されています。
　しかし正規表現では（直接 SUsageMatcher クラスを利用する場合の除き）SStringParser の実装に暗黙に準じます。
　したがって、文節単位のマッチングでは と は区別できません。>= や <= は注意が必要です。
（厳密には正規表現 >> には > > はマッチングしませんが、正規表現 > > に >> はマッチングします）

　正規表現には文節単位ではない文字や文字列のマッチング書式もあり、組み合わせて記述する必要があります。
　SStringParser では以下の文字が特殊区切り記号として定義されています。
　記述の通り、特殊区切り記号とは、連続していても1文字1文字が独立した文節として解釈される文字記号です。

　また、記号（区切り記号）として以下の文字が定義されています。 　記号は記号同士が連続している場合、繋がった1つの文節として解釈される文字です。
　@（アットマーク）と _（アンダーバー）は区切り記号として扱われないことに注意してください。

　正規表現は文節単位でマッチングされます。
　&! ～ & で囲まれた文字列は、アルファベットの大文字小文字を区別せずに文節単位でマッチングします。
　& 記号で囲んだ文字列に、&、+、!、\ 記号が含まれる場合、\&、\+、\!、\\ などのように記述する必要があります。

　空白記号（タブや改行含む）は無視されるため、例えば以下のような正規表現 は、 にもマッチングします。

　& 記号で囲むことで、文節を考慮しない文字列の一致判定を行うことができます。
　&+ ～ & で囲まれた文字列は、アルファベットの大文字小文字を区別せずに文字列の一致判定を行います。

　\ 記号に続く１文字は無条件に文節を考慮しない１文字として判定されます。

　< ～ > 括弧で囲むと、その範囲の文字のいずれかの１文字として判定されます。ただし、\、-、<、> 記号は \\、\-、\<、\> のように記述する必要があります。
　また、A-Z のようにハイフンが記述されるとその両隣りの文字の文字コード区間のすべての文字と同等の記述になります。つまり、A-Z は ABCDEFGHIJKLMNOPQRSTUVWXYZ と同等です。また、A-Za-z はすべての半角アルファベットを意味します。

　<- ～ > 括弧で囲むと、その範囲の文字のいずれの文字でもない１文字として判定されます。

　正規表現中のスペースは、０文字以上のスペース記号（タブ、改行コードを含む）にマッチングします。

　正規表現末尾の \ 記号は、マッチング対象の文字列の末尾に合致することを指定します。
　正規表現末尾に \ 記号が無い場合には、対象文字列の左側の一致するまでの範囲が対象となります。

　* 記号直前の書式が１回以上反復することを指定します。
　後述の () や []、{} などの入れ子状になった複数の書式を含んでいても有効です。

　任意桁の数値（10進数の整数）を指定します。
　{-|[+]} <0-9>* と同じ意味です。（[]、{} については後述）

　任意の文節を指定します。
　記号のみの文節でもマッチングすることに注意してください。

　close-character までの文字列を指定します。
　close-character 自身は含まないことに注意してください。
　SStringParser（及び派生クラス）の実装によって終端判定が異なることに注意してください。
　デフォルトの SStringParser 実装では、"（ダブルクォーテーション）と '（シングルクォーテーション）が close-character の場合、C 言語と同様の \ 記号エスケープシーケンスが機能するものとして判定されます。

　例えば以下のような正規表現 に対して をマッチングした場合、%c" にマッチングする箇所は \"hello world\" になります。

　任意の文字列を指定します。
　文字列の終端は、%s の直後の書式に合致する最初の位置です。

　任意の数式を指定します。
　数式の終端は、%x の直後の書式に合致する最初の位置です。
　%s との違いは、"（ダブルクォーテーション）と '（シングルクォーテーション）で囲まれた文字列中、あるいは () 括弧、[] 括弧、{} 括弧で入れ子になった途中で %x の次の書式に合致する箇所があったとしても、それは無視されるという点です。

　() 括弧で囲まれた正規表現にマッチングする文字列が引数として抽出され、文字列配列として取得することができます。
　例えば、 のような正規表現（[] については後述）に対して、 のような文字列を処理した場合、 のような文字列配列を受け取ります。（ここでは便宜上文字列は C 言語 \ エスケープシーケンスを伴って表現しています）

　[] 括弧で囲まれた正規表現は、省略可能であることを意味します。

　{} 括弧で囲まれ、| 記号で分割される複数の正規表現は、そのいずれかの書式であることを意味します。
　もし複数の正規表現に合致する場合には、一番初めの正規表現が選択されます。
　但し、| で区切られた各正規表現の末尾まで合致しなけば合致したとはみなされません。

　以下に簡素な Antirrhinum 実装例を示します。
　まず、以下のヘッダファイルをインクルードし、名前空間を以下のように省略するものとします。
　初めに、Sakura2 仮想マシンを準備します。 　Sakura2 仮想マシンは必ずしも必須ではありません。
　また、SGLStdApplication クラスを派生してアプリケーションを記述している場合（推奨）は、GetEnvironmentVM() 関数で初期化済みの ECSSakura2::EnvironmentVM を（StartUpApp、又は Run 関数内で）取得できます。

　次に Rosetta 仮想マシンを準備します。
　AddScriptEnvironmentPath の呼び出しは必須ではありません。
　ここでは ROSETTA_INCLUDE_PATH 環境変数の値をインクルードパスへ追加しています。
　ゲームのような配布環境では必要なスクリプトファイルはすべて同梱しておきます（通常は書庫ファイル化）。

　必要に応じて Rosetta スクリプトを読み込みます。
　CompileToSakura2 は読み込んだ Rosetta スクリプトを Sakura2 仮想マシン用の中間コードへコンパイルし、またネイティブコードへコンパイルします。コンパイルは必ずしも必要ではありません（LoadScript のみで実行はできます）。

　いよいよ Antirrhinum の実装に必要なオブジェクトを準備します。
　aglVars、aglMessage、aglSound, aglGraphics 等は任意です。
　まず、Antirrhinum 仮想マシン環境を準備します。
　AttachEpicProcessor 関数では任意の実装モジュール（EpicProcessor）を追加しています。これによって使用できるコマンドセットを任意にカスタマイズできます。
　AGLEpicCoreProcessor は標準のディレクティブと Core コマンドが実装された EpicProcessor です。
　また、AGLStdMessageProcessor を使用する場合、ここで aglMessage にユーザーインターフェースの設定を行うか、AGLStdMessageProcessor クラス（又は親クラスの AGLMessageProcessor）を派生して実装する必要があります。
　AGLGraphicsProcessor についても表示先の設定を行っておきます。

　次に設定ファイルを読み込みます。
　ルートタグは任意ですが（ここでは <config>）、その要素タグとして各 EpicProcessor 毎の設定を記述し、LoadConfiguration から各 EpicProcessor へ分配され、設定が反映されます。

　ここまでの作業が完了したらコンパイル済みの Antirrhinum スクリプトを実行できます。
　この例では aglKernel.Execute() でループを回していますが、他のループの中で、１フレーム分の処理として aglKernel.Execute() を実行できます。


　尚、終了時には以下のような順序で終了処理を行います。
　これらの解放関数はデストラクタで自動的に呼び出されるものですが、依存関係があるために明示的に AGLKernel → RSVirtualMachine → ECSSakura2::EnvironmentVM の順に終了処理する必要があります。

　Antirrhinum では Rosetta スクリプトを実行できますが、単に実行できるだけではなく、フラグも Rosetta を利用します。
　Rosetta スクリプトであらかじめ使用するフラグを作成しておき、Antirrhinum 側で利用することになりますが、グローバルに直接フラグを作成してしまうとゲーム開始時の初期化処理や、セーブ時の処理が複雑になったり、セーブ漏れが生じる原因になります。
　そこで Antirrhinum で利用するフラグのみを格納するクラスを作っておき、Antirrhinum の変数スコープとして設定することで、Antirrhinum 側からの変数の記述をシンプルにし、かつフラグの初期化やセーブ等を簡略化できます。

　典型的には、まず以下のような Rosetta クラスとオブジェクトを定義しておきます。
　Tools/antirrhinum_vars.rs にもう少し丁寧な AGLVariables 実装がありますので、
としても構いません。
（antirrhinum_vars.rs はゲーム実行時にパスが通る場所に格納（通常は書庫ファイル化するので書庫の中に格納）する必要があります）

　ここで、f は通常のフラグ変数（AGLVariablesProcessor ではゲームフラグと呼び、InitializeGame 関数で初期化されます）、s はゲームを初めからやり直しても初期化されないフラグ変数（同じく共有フラグ）を保存することを想定しています。

　AGLVariables クラスではなく、直接 HashMap を使う場合、 のように freeze することが推奨されます。
（そうでない場合、Antirrhinum 側から Rosetta のグローバル空間へアクセスできなくなります。しかしスクリプト上から Rosetta のグローバル空間にアクセスさせたくない場合や、特定のクラスだけに限定したい場合には、ここにアクセスを許可するクラスを追加し freeze をしないという方法もあります）

　実装側では、上記のような Rosetta スクリプトをロードした後、 のように SetDefaultThisObject で変数スコープを設定します。

　こうすると、Antirrhinum 上では、 のように任意の名前の変数を初期化してから のようにフラグとして利用できます。
（SetDefaultThisObject で g_aglVars を設定しない場合、g_aglVars.f.var1 のような記述が必要になります）

　また、AGLVariables クラスのメソッドをグローバル関数と同じように呼び出すことができますので、antirrhinum_vars.rs を利用した場合、
のような記述をすることもできます。

　AGLKernel::BeginThread でスレッドを作成する際、以下のようにスレッド毎に Rosetta インスタンスを作成して設定することができます。
　スレッドにインスタンスが関連付けられた場合、Antirrhinum スクリプト上からの名前スコープは pInstance になり、AGLKernel::SetDefaultThisObject で設定したものではなくなることに注意してください。
　アクションゲームなどで敵のアルゴリズムを実装する場合などには、このようにスレッド毎にインスタンスを設定します。

　aglKernel.Execute() 実行中でなければ基本的にいつでもセーブ処理を実行することができます。
（EpicProcessor は Execute 中でなければ基本的にいつでも（AGLKernel 以外の処理の副作用のない範囲で（同期などを行い））セーブできるように実装しなければなりません）

　典型的なセーブ処理は以下のようになります。
　Serialize 関数では、すべてのスレッドの実行状態、及びすべての EpicProcessor がそれぞれ xml の要素タグとして記録されます。

　セーブ処理同様、典型的なロード処理は以下のようになります。
　Deserialize 関数では、すべてのスレッドの実行状態、及びすべての EpicProcessor の状態が、それぞれ対応する xml の要素タグから復元されます。
　ほぼセーブと逆の処理を行うだけですが、復元処理が終わった後に AfterDeserialize 関数を呼び出すことを忘れないでください。

　ロード処理をした後に InitializeGame を呼び出すと初期化処理がされてしまうため、InitializeGame の後にロード処理を行います。

　ある EpicProcessor が何かの処理をするとき、別の EpicProcessor の設定等を参照したい場合がまれに生じます。
　例えば、変数の設定や、キャラクターの設定などを参照したい場合、変数の設定なら AGLVariablesProcessor、キャラクターの設定なら AGLMessageProcessor が設定を持っています。
　そういう場合には AGLKernel::GetEpicProcessor 関数を利用します。

　また、ある EpicProcessor から何らかの通知などを行いたい場合には、FirstEpicProcessor 関数と NextEpicProcessor 関数を利用することで複数の EpicProcessor を取得できます。
　例えば、AGLMessageProcessor には VoiceListener サブクラスが定義されており、以下のようにボイスの再生に関する通知を行っています。
　他の EpicProcessor は AGLMessageProcessor::VoiceListener を派生しておくとボイスのロードや再生開始、終了時などに通知を受け取り、例えばキャラクターの表示に連動して音量をパンしたり、口パクをさせたりということが可能です。

　ゲームで使用するフラグのシリアライズ・デシリアライズを行う標準の EpicProcessor です。
　コマンドセットは書式定義ファイル std_variables_cmd.xml に定義されています。

　AGLVariablesProcessor ではゲームフラグ（ゲーム中でフラグとして使用し、セーブの対象になる HashMap の要素）と、共有フラグ（ゲームを初めからプレイする時にクリアされず保持される HashMap の要素）が管理されています。
　これらフラグの標準的な実装は Tools\antirrhinum_vars.rs に記述されています。

　共有フラグの中には既読（read）フラグ（スクリプト毎にインデックスが振られたメッセージを一度でも読んだことがあるか）や、功績（deed）フラグ（スクリプトラベル通過回数、CG閲覧回数、その他なんらかの実行回数などの記録）が規定の機能として提供されます。
　これらのフラグが、Rosetta スクリプト上のどの変数かは設定ファイルに記述され、設定がない場合、コマンドを実行しても何の作用も発生しません。
　標準的な設定は以下のようになります。
　ゲームフラグは標準の初期化・セーブ・ロードフレームワークで処理されますが、共有フラグは AGLKernel 初期設定後（設定ファイル読み込み後）に読み込み、任意タイミング（終了前等）に保存を行う必要があります。

　共有フラグの読み込みは以下のように DeserializeSharedFlags 関数で行うことができます。
　同じく保存処理は以下のように SerializeSharedFlags 関数で行うことができます。

　ゲームフラグはスクリプト上で初期値を代入すれば初期化できますが、共有フラグは代入してしまうと通常のフラグと変わらずゲームを開始するたびに初期化されてします。
　そこで、フラグ未設定時にのみ値を設定する @init_sflag コマンドや AGLVariables.initSFlag 関数が用意されています。
　通常初回プレイ時に共有フラグは undefined になります。
　以下のようなコードは何度実行しても undefined が出力されます。
　以下のように @init_sflag を初めに実行しておくと実行のたびに値が1増えます。

　ゲームフラグ、共有フラグを設定します。
　read-element-name には既読フラグを格納する要素名を、deed-element-name には功績フラグを格納する要素名を指定します。
　省略した場合にはそれぞれ .read、.deed となります。
　既読フラグや功績フラグを機能させたくない場合には shared_read="" や shared_deed="" のように空文字列を明示する必要があります。

　仮に shared_flags="g_aglVars.s" shared_read=".read" shared_deed=".deed" の時、g_aglVars.s[".read"] に既読フラグ用の HashMap が、g_aglVars.s[".deed"] に功績フラグ用の HashMap が生成されます。

　共有フラグが未定義の場合、初期値を設定します。

　共有フラグに値を設定します。
　s["var-name"]=expr と同じ意味です。

　共有フラグに値を加算します。
　フラグが未定義の場合、初期値として設定します。

　功績フラグに値を１加算します。
　功績フラグが未定義の場合、初期値として１を設定します。
　このコマンドで加算されたフラグの値は表現可能な整数の最大値を超えることはありません。
　デフォルトでは、スクリプト上のラベルを通過するたびに功績フラグとしてカウントされます（フラグ名は script#label 形式）。
　それ以外で功績フラグを設定したい場合には、スクリプト上で明示的に @add_deed コマンドを記述してください。

　キャラクターのセリフ等を出力する EpicProcessor です。
　ユーザー入力に関係する処理はここに集約されています。
　コマンドセットは書式定義ファイル std_message_cmd.xml（及び std_message_cmd.rs スクリプト）に定義されています。

　AGLMessageProcessor クラスは抽象クラスで、派生クラスで UI やユーザー入力などの実装を行う必要があります。
　UI やユーザー入力を結び付ける標準的な実装の AGLStdMessageProcessor 派生クラスを利用することもできます。

　AGLMessageProcessor では、特に注記のないコマンドでも、文字列（テキストやファイル名等）を受け取るパラメータには、%(～) 形式で、Rosetta 式を含む記述が可能です。

　<message> タグはメッセージの動作設定を保持しています。
　すべての属性は省略可能で、省略時はデフォルトの設定が適用されます。

　stop_skip_no_read は未読メッセージ表示の際にスキップモードを停止、stop_fast_skip_no_read は同じく未読メッセージで高速スキップモードを停止、stop_skip_selector は選択肢でスキップ・高速スキップモードを停止します。
　save_in_log はメッセージログにメッセージ毎のセーブデータを保存、nosave_in_skip は save_in_log=1 の時、スキップモードでのセーブを省略、nosave_in_fast_skip は同じく高速スキップモード時にセーブを省略します。
　click_cancel_auto は画面クリックでオートモード停止、click_cancel_skip は同じくスキップモード停止、click_cancel_fast_skip は同じく高速スキップモード停止です。
　これらの挙動を動的に変化させたい場合には、派生したクラスで GetBehaviorFlags 関数をオーバーライドしてください。

　skip-effect-speed には 0～100 の値で、スキップモード時の画面効果などの進行速度を（時間比を百分率で）指定します。0 は即時、50 は倍速、100 は等速となります。

　message-window-fade-time にはメッセージウィンドウのフェードイン、フェードアウト時間のデフォルト値をミリ秒単位で指定します。

　message-log-limit にはメッセージログの最大保持数を指定します。

　voice-volume-line-base にはキャラクターボイスの音量を個別に設定する場合、そのボリュームラインのベース番号を指定します。
　<character_definition><character > タグの volume_line 属性で指定する値に、この値を加算した番号が、実際の音量ラインとして使用されます。

　name-start-chars、name-close-chars、must-name-encloser はコンパイル時に使用するパラメータで、メッセージ文の名前部分の開始と終了文字を指定できます（後述メッセージ文参照）。

　warn-msg-lead-chars はコンパイル時に、メッセージの先頭の文字に指定文字のいずれかであった場合、エラーを表示するします。例えば "@" を指定すると、コマンドの書き間違えがメッセージ出力となってしまった場合にエラーを出力できます。


　<character_definition> タグは登場人物全般の設定を保持しています。

　character-index は通常 0 から始まる整数で、ゲームのコンフィグ画面などで管理する人物ごとの設定のインデックスと一致させます。
　但し場合によってはマイナスの値を使用することもできます（例えば名前が指定されないメッセージの設定を行いたい場合には -1 を指定します）。

　character-id は登場人物の識別子です。
　メッセージ文でキャラクターを識別するために指定する識別子です（全言語共通）。

　character-name は登場人物の名前です。メッセージウィンドウの名前表示枠に表示する場合などのデフォルトの名前を設定します。この項目は必須ではありません。
　japanese-char-name、english-char-name はそれぞれ多言語対応する場合の、日本語名、英語名を指定します。デフォルトが日本語名の場合には日本語名は不要です（逆にデフォルトが英語名の場合、英語名は不要です）。

　face-file-lead-name はフェイス画像のファイル名の先頭の共通部分です。

　bs-file-lead-name は立ち絵画像のファイル名の先頭部分で人物を判定する場合の共通部分です。

　user-line-index はボイスの音量に適用するボリュームラインのインデックス（0～15 の範囲の整数）です。この数値は <sound><volume_lines><line> の num 属性と共通の値です。
　登場人物ごとに音量設定を持たない場合にはすべての登場人物を 0 にします。

　text-ARGB-hex、border-ARGB-hex、shadow-ARGB-hex は登場人物のセリフを表示する際の文字色、文字縁色、文字影色を ARGB 形式８桁の１６進数で指定します。黒は 000000 ではなく、FF000000 であることに注意してください。

　voice-filter-reg-expr には登場人物ごとのファイル名を判別するための EntisGLS4 正規表現を指定します。
　filter タグ要素を複数記述した場合には、それいずれかの条件に合致すれば真になります。

　<bs_file_filter> タグ内には、立ち絵ファイルを判別する条件を記述します。立ち絵ファイルは bs-file-lead-name でも指定できますが両方指定した場合には両方の条件が一致した場合が条件となります。

　<voice_file_filter> タグ内には、ボイスファイルを判別する条件を記述します。いずれかの <filter> タグの条件に一致すれば真となります。
　しかし、<voice_file_exception> タグには除外条件を指定することができ、その要素タグのいずれかに一致する場合には偽となります。

　サウンド位置マーカーファイルは、ボイス等の再生位置とスクリプト処理の同期を取るための情報を格納したファイルです。

　メッセージを出力します。
　メッセージ文は std_message_cmd.rs スクリプトによって文字単位の処理が行われるため、上記書式は文字単位であることに注意してください。

　最も単純な以下のようなメッセージ文 は、以下の @msg コマンド（後述）と同等です。
　キャラクターのセリフとして表示させる場合、キャラクター識別子を指定します。
　ここで elena は設定ファイルで定義された任意のキャラクター識別子とします。
　キャラクター識別子とセリフは、\ 記号か、スペース、タブ１文字で区切ります。
　キャラクター識別子は日本語でも問題ありませんので、例えば設定ファイルで "エレナ" と定義しておけば でも問題ありません。但し、名前とセリフの区切り（スペース記号）は必須です。
　より明示的に と書けます。

　名前の表示を設定ファイルのデフォルトの表示名から変更したい場合には / 記号で区切って指定できます。 　フェイス画像を表示するシステムの場合、フェイス画像の差分名を指定できます。 　設定ファイルで face_file_lead="f_elena_" になっている場合、上記で指定されるフェイス画像ファイルは f_elena_n0 となります。
　もちろん表示名を指定した場合にも指定できます。
　メッセージの出力にオプション的なパラメータを指定したい場合には、メッセージ本文の前に +, - 記号、又は & 記号でエスケープします。
　オプションパラメータを指定する場合には必ずしもスペースや \ 記号を挿入する必要はありません（挿入しても構いません）。
　しかし必ず必要な場合はあります。
　これらの出力を行うと となります。
　また、メッセージ文の先頭がキャラクタ識別子からはじまるモノローグは注意が必要です。
　たまたまキャラクタ識別子の直後に半角スペースがある文があるとキャラクターのセリフとして識別されます。
　モノローグは常にタブで始まるなどの取り決めをしておくと事故を防ぐことができます。

　あるいは、設定ファイルの <message> タグ name_start_chars 属性、及び name_close_chars の属性を設定しておき、スクリプトでは常にその文字で名前を囲んで記述しておけばより確実にコンパイルすることができます。

　例えば設定ファイルに と記述しておくと、 のように記述できます。この場合、名前とメッセージ本文間の区切り（\ 記号又はスペース）は省略しても構いません（但しメッセージ本文が半角スペースから始まる場合には余分にスペースを挿入する必要があります）。
　表示名をデフォルトから変更する場合やフェイスを指定する場合も同様に と記述できます。

　因みに、name_start_chars、name_close_chars を利用して記述する場合、設定ファイルで定義されていないキャラクタのセリフも記述できます。
　但し、設定ファイルでキャラクタ識別子を空文字列で定義したキャラクタが存在する場合、名前を指定文字で囲まなくても記述することができます。
　尚、これら定義されていないキャラ、又は "" 識別子のキャラとして処理される場合、常に記述した名前が実行時に表示される名前となります。
　常にスクリプトには常にキャラIDを記述し、もし記述誤りがあった場合にエラーメッセージを出力したい場合には、設定ファイルの <character_definition> タグに strict_char_id="1" 属性を記述してください。
　また、設定ファイルの <message> タグに must_name_encloser="1" を指定すると、名前は常に指定文字で囲む（この例では【～】）ことを意味し、そうでない文はメッセージ本文として解釈されます。

　メッセージ文にボイスファイル指定を記述する場合、文末に | 記号で区切って記述できます。
　複数記述することもできます。
　また実装依存ですが、標準の実装の場合、メッセージ本文にはタグで複雑な書式や処理を記述することができます。
　例えば、 のような記述が可能です。

　ここではメッセージ本文に記述できる書式として、EntisGLS4 の SGLSpriteMessage で利用できる書式を説明します。
　書式は xml と同等のタグによって記述できます。
　タグ（及びエスケープ）に使用する半角の < > & 記号自体を記述したい場合には xml 同様にエスケープ表記（&lt; &gt; &amp;）が必要になります。

　ボイスを再生します。
　ボイスファイル名と同名で拡張子が .wmk のマーカーファイルが存在する場合、そのファイルも暗黙に読み込まれます。

　複数のボイスを同時に再生します。
　ボイスファイル名と同名で拡張子が .wmk のマーカーファイルが存在する場合、そのファイルも暗黙に読み込まれます。

　再生中のボイスを停止します。

　再生中のボイスが sync-id 位置を通過するか、sync-id を省略した場合は再生が完了するまで待機します。

　（吹き出しなどで）メッセージウィンドウが複数存在する場合や、複数のタイプのメッセージウィンドウを切り替えて使用する場合、使用するメッセージウィンドウのタイプを指定します。
　message-id を省略、又は "" を指定した時はデフォルトのメッセージウィンドウです。

　メッセージウィンドウを表示・非表示します。

　フェイス画像を表示します。

　フェイス画像を消去します。

　メッセージウィンドウのキー入力待ちアイコンを表示し、キー入力を待ちます。
　すべてのパラメータは省略可能です。

　メッセージを出力し、キー入力を待ちます。
　text 以外のすべてのパラメータは省略可能です。

　直後の @msg コマンド、又はメッセージ文に英語用のテキストを設定します。

　メッセージ文字列の表示完了、かつボイスの再生完了まで待機します。

　表示しているメッセージ文字列（発言者名含む）を消去します。

　スキップ挙動や、ボタンの有効化を行います。

　スキップ挙動や、ボタンの無効化を行います。
　各パラメータのフラグは @enable_skip と同様です。

　クリック時にスキップ状態を維持するか設定します。
　通常１クリックでは１つの待機状態（画面効果等コマンド）しかスキップしません。
　しかし１クリックで複数のコマンドをスキップしたい場合などで、一連のコマンドの前に @keep_skip all などと記述しておき、スキップを終了したいところで @keep_skip 0 として停止させられます。

　シーンジャンプ UI があるシステムで、シーンジャンプボタンを有効化し、ボタンが押されたときに指定のラベルにジャンプするように設定します。
　ジャンプ先ラベルを省略（又は空文字列を指定）すると、シーンジャンプモードは解除され、シーンジャンプボタンは禁止状態（あるいは非表示：挙動は実装依存）になります。
　シーンジャンプが有効な間、@dis_interrupt で割り込みを禁止状態にすると、シーンジャンプボタンを押してもジャンプは発生しません。

　選択肢項目の設定を開始します。
　すべてのパラメータは省略可能です。
　@selector ～ @endsel コマンド間に @menu コマンドで選択し項目を記述します。

　選択肢として表示する項目を追加します。

　選択肢の設定を完了し、実際に画面に表示しユーザーの入力を待ちます。

　サウンド関係を処理する標準の EpicProcessor です。
　コマンドセットは書式定義ファイル std_sound_cmd_ex.xml （基本コマンドのみは std_sound_cmd.xml）に定義されています。

　サウンドインスタンスはチャネル番号毎に生成されます。
　チャネル番号は 0 から始まる整数で、同じ番号にサウンドを読み込むと以前のデータはフェードアウトされ、置き換えられます。
　異なるチャネル番号を指定すると任意数のサウンドを同時に再生できます。

　再生する際にはボリュームラインを指定できます。
　ボリュームラインはいわばサウンドの種類を指定するもので、ゲームの設定によってマスター音量を変更できます。
　既定のボリュームラインは以下のものがあります。
　サウンドファイルには EntisGLS4 標準のフォーマットである mio 形式の他、wav 形式などが利用できます。拡張子に .wpl または .xml を指定した場合プレイリストファイルを再生することができます。

　ユーザー定義のボリュームライン名の定義を行うことができます。
　user-line-index には 0～15 の範囲の整数を、user-line-id には定義するボリュームライン名を指定します。
　定義されたボリュームライン名は sound_play コマンドで line に指定できます。

　サウンドファイルを読み込み、再生を開始します。

　サウンドの再生を停止して破棄します。

　サウンドの音量を変更します。

　サウンドの再生が終了するまで待機します。

　BGM を再生します。
　@sound_play の BGM 再生用糖衣構文です。
※書式中パラメータの = は省略時のデフォルト値

　SE を再生します。
　@sound_play の SE 再生用糖衣構文です。
※書式中パラメータの = は省略時のデフォルト値

　BGM を停止します。
　@sound_stop の BGM 停止用糖衣構文です。
※書式中パラメータの = は省略時のデフォルト値

　SE を停止します。
　@sound_stop の SE 停止用糖衣構文です。
※書式中パラメータの = は省略時のデフォルト値

　BGM の音量を変更します。
　@sound_volume の BGM 音量変更用糖衣構文です。
※書式中パラメータの = は省略時のデフォルト値

　SE の音量を変更します。
　@sound_volume の SE 音量変更用糖衣構文です。
※書式中パラメータの = は省略時のデフォルト値

　SE の再生が終了するまで待機します。
　@sound_wait の SE 再生完了待機用糖衣構文です。
※書式中パラメータの = は省略時のデフォルト値

　2Dグラフィック関係の処理を行う標準の EpicProcessor です。
　コマンドセットは srd_graphics_cmd_ex.xml（基本コマンドのみは std_graphics_cmd.xml）に定義されています。
（srd_graphics_cmd_ex.xml は、std_graphics_cmd.xml 定義ファイルと std_graphics_cmd_ex.txt マクロファイルを読み込みます）

　実装のベースは EntisGLS4 の Sprite です。
　AGLGraphicsProcessor では階層化された複数のレイヤーと、レイヤーのルートである複数のスクリーンを扱うことができます。

　画像はレイヤーに読み込んで表示することができますが、キャラクターの立ち絵など、レイヤーにはスタイルを指定することができ、座標指定をわかりやすく記述することができます。

　また、AGLGraphicsProcessor では、コマンドのほとんどの引数に、数値の場合には Rosetta での数式、また文字列引数には %(～) 形式で文字列中に数式の評価値を含むことができます。
　座標などの定数を Rosetta で定義しておくと AGLGraphicsProcessor コマンドでも使用できます。

　設定ファイルにはレイヤースタイルの定義と、InitializeGame 時に自動的に初期スクリーンを作成する場合には <init_screen> タグにスタイルを指定します。

　<styles> タグに直接記述したレイヤースタイルは、デフォルトのレイヤースタイルです。空文字列のスタイルIDとして参照できます。
　追加的なスタイルは <style> タグで行えますが、ref-style-id に参照スタイルIDを指定でき、その場合、先に定義したスタイルをベースに変更したいパラメータだけを記述できます。

　layer-type にはレイヤーのバッファの処理方式を指定します。
　単に画像を表示したいだけのレイヤーは layer を指定します。
　スクリーンのスタイルには通常は fb_ram を指定します。
　buf_layer, fb_vram, fb_ram, fb_cpu はフレームバッファを作成します。フレームバッファサイズは layer-width, layer-height になります。
　buf_layer は画像を表示するためのレイヤーですが、新しい画像をそのレイヤーに読み込む場合、古い画像を自動的にクロスフェードして表示する出来る機能を持ったレイヤーです。
　layer_set はフレームバッファを作成せずにサブレイヤーを作成できるレイヤーです。
　サブレイヤーの表示位置（拡大・回転・透明度等含む）はその親レイヤーの影響を受けます。
　fb_vram は VRAM 上にフレームバッファを作成します。
　fb_ram は RAM と VRAM 上にフレームバッファを作成します。GPU での描画の後のフィルター処理を CPU でも行うことができます。fb_vram では一部のフィルターが動作しない可能性がありますが、fb_ram より高速です。
　fb_cpu は RAM 上にフレームバッファを作成し、描画も CPU で行います。

　priority にはデフォルトの表示優先度（整数）を指定します。
　優先度は 0 が基準優先度で、大きな数のほうが奥に表示されます。
　実装上の実際の Sprite の優先度は、AGLGraphicsProcessor に設定された基準優先度に加算されます。
　スクリーンの優先度は、他の画面表示アイテムと干渉しない為に -100～+100 の範囲で使用すべきです。
　レイヤーの優先度は自由な範囲で利用できます（しかし内部の優先度加算処理の結果を安全な範囲に保つため、30ビットで表現可能な程度の数値にすべきです）。

　pivot-x, pivot-y にはソース画像（フレームバッファ）の中心座標を指定します。
　この座標は拡大縮小や回転の中心座標になるほか、表示座標の位置を示すものにもなります。つまり、pivot 座標と同じ表示座標にレイヤーを表示したとき、画像の左上が 0, 0 になります。
　但し、画像ファイルにはオフセット座標が格納されており（eri 形式の場合）、例えばキャンバスサイズが画面サイズに一致する PSD ファイルから透明でない部分のみを書き出した場合、ファイルの画像サイズは PSD のキャンバスサイズとは必ずしも一致しませんが、読み込んで 0,0 に表示した場合（pivot も 0,0 の場合）、PSD で表示した時と同じ位置に表示されます。
　従って、pivot は画像ファイル上のローカル座標ではなく、PSD で表示したときに中心にしたい座標を設定することになります。

　offset-x, offset-y には、実際に表示する座標をコマンド引数で指定した座標に加算する値を指定します。
　pivot を設定した場合、offset を同じ座標にすることによって、スクリプトで指定する 0,0 が pivot の位置になります。

　@layer_～ 系コマンドには、layer パラメータにレイヤーパスを指定します。
　レイヤーには個別に任意の ID を設定することができますが、これは大域的な ID ではなく、そのレイヤーセット内の局所的な ID です。
　レイヤーパスは親レイヤーと子レイヤーを . （コンマ）記号で結合して記述します。
　空文字列、又は . だけのレイヤーパスはルートレイヤー（スクリーン自体）を指定します。

　指定のスクリーン番号に新規スクリーンを作成します。
　既にスクリーン作成済みの場合には何もしません。

　指定のスクリーン番号に複製元スクリーンの複製を作成します。

　指定のスクリーン番号のスクリーンを削除します。

　二つの指定のスクリーンの番号を入れ替えます。
　片方のスクリーン番号が削除（あるいは未作成）の番号でも有効です。

　指定のスクリーン番号を選択します。
　現在選択されているスクリーンは @layer～ 系コマンドの対象スクリーンとなります。

　レイヤーを作成します。
　class 指定によってさまざまな種類のレイヤーを作成することができます。
　追加の固有レイヤーを実装したい場合には、派生クラスで NewLayerItem 関数と OnInitLayerItem 関数をオーバーライドします。

　レイヤーを作成し、画像を読み込みます。

　動画再生用レイヤーを作成し、動画ファイルを読み込みます。

　指定レイヤーに画像を読み込みます。
　layer_style=buf_layer で作成されたレイヤーの場合、画像の切り替えをフェード表示させることができます。

　指定レイヤーを削除します。

　レイヤーが存在しているか調べ、result-expr に結果を設定します。
　レイヤーが存在しているときには -1 が、存在しない場合には 0 が設定されます。

　指定レイヤーのパラメータを変更します。

　パラメータアニメーションの準備を行います。
　パラメータアニメーションは通常のレイヤー（class=layer や class=image）のみが対応した機能で、動画レイヤー等の特殊レイヤーは対応していません。
　従って、特殊レイヤーでパラメータアニメーションを行いたい場合には、layer_set レイヤーを作成し、その子レイヤーとして動画などの特殊レイヤーを作成し、パラメータアニメーションは layer_set レイヤーに対して行う必要があります。

　アニメーションのパラメータを追加します。
　start-point-velocity, end-end-velocity には 0.0, 0.0 の組み合わせなら静止→加速→減速→静止移動に、1.0, 1.0 なら等速運動、0.0, 2.0 なら静止→加速の等加速度運動、2.0, 0.0 なら減速→静止の等加速度運動となります。

　パラメータアニメーションを開始します。

　レイヤーのパラメータアニメーションが完了するのを待機します。

　レイヤーのパラメータアニメーションを強制的に即時終了させます。
　パラメータはアニメーション完了時の値になります。

　レイヤーにフィルターを設定します。
　フィルターは複数設定することができますが、フレームバッファを所有するレイヤーでなければなりません。
　固有のフィルターを追加実装したい場合には派生クラスで CreateSpriteFilter 関数をオーバーライドします。

　透明度フィルターを設定します。
　フィルタパラメータが透明度として扱われます。

　α画像マスクフィルターを設定します。
　alpha_coef=256 の時にフィルタパラメータに 128 を設定する（@layer_parameter fp=128）と、丁度α画像でマスクした表示状態になります。
　このフィルタは、現在のバージョンでは CPU のみで動作します。

　トーンカーブフィルタを設定します。
　フィルタパラメータに 256 を設定した時（@layer_parameter fp=256）、トーンカーブ適用度が 100% になります。
　このフィルタは、現在のバージョンでは CPU のみで動作します。

　ぼかしフィルタを設定します。
　CPU／GPU どちらでも動作しますが、CPU の場合重いので GPU での動作が推奨されます。

　レイヤーのフィルターをすべて解除します。

　レイヤー固有の操作を行います。
　追加の固有操作を追加したい場合には派生クラスで OperateLayer 関数をオーバーライドします。

　動画の再生を開始します。

　動画の再生を停止します。

　動画の再生が完了するまで待機します。

　フレームバッファを所有するレイヤーの表示更新を停止します。
　@layer_freeze を実行したのと同じ回数だけ @layer_defrost を実行すると表示の更新が再開されます。

　一時停止されたレイヤーの表示更新を再開します。

　トランジッションの準備をします。
　このコマンドではスクリーン 0 をスクリーン 1 に複製し、フィルタを設定します。
　@begin_trans ～ @end_trans 間に新しい画面への変更処理を記述することによって簡易に画面切り替えを行います。

　画面を切り替えます。
　スクリーン 1 は削除されます。

　スクリーン 2 を表示優先度 99 で作成し、レイヤー ID = movie の動画レイヤーを作成して再生、終了するまで待機し、終了するとスクリーン 2 を削除します。
　座標等のパラメータは省略可能です（@layer_parameter に指定できるパラメータは一通り指定可能です）。
　スクリーン 2 を作成するスタイルとして movie_screen、movie レイヤーを作成するスタイルとして movie_layer が暗黙に指定されますので、設定ファイルで定義しておけば位置などの設定を行うことができます。

　layer に指定したレイヤーを、移動（coord-x, coord-y）、回転（rotate-z [deg]）、透明度（transparency）に指定時間（time [ms]）だけかけて変化させます。

　layer に指定したレイヤーフェードアウトさせてから削除します。
　delta-x, delta-y を指定すると座標を移動させながらフェードアウトします。

　layer に指定したレイヤーに画像を読み込みます。
　またレイヤーが既に存在する場合、指定座標（coord-x, coord-y）、透明度（transparency）、回転角（rotate-z）に移動アニメーションします。
　またレイヤータイプが buf_layer の場合、画像はクロスフェードしながら切り替わります。

　レイヤーが存在しない場合、新規にレイヤーを作成して画像を読み込み、フェードインします。
　レイヤー作成時の layer-style は、省略すると image が参照されます。

　このマクロはレイヤーが存在するかをテストするために f.@layer_exist フラグに @layer_exist コマンドの結果を受け取ります。

　レイヤー ID = bg、表示優先度 100、座標 (0,0)、デフォルトのレイヤースタイル bg でレイヤーに画像を読み込みます。
　このマクロは @image マクロを呼び出します。

　レイヤー ID = layer、表示優先度 50、座標 (coord-x,0)、デフォルトのレイヤースタイル char でレイヤーに画像を読み込みます。
　このマクロは @image マクロを呼び出します。

　y 座標は暗黙に 0 ですので、画像データの作成時、あるいはレイヤースタイルで y 座標が 0 で問題ないように設定します。