基本
基本
プログラムは起動時に開始スクリプトstart.txtから実行を開始します。名前を変更したり削除したりしないでください。
以降のチュートリアルでは、WebGALスクリプトの使い方を説明します。
コメント
WebGALスクリプトは、各行のセミコロンより前の内容のみを解析します。したがって、セミコロンより後の内容はコメントとみなされます。
WebGAL:こんにちは!; セミコロンより後の内容はコメントとみなされます
; セミコロンを直接入力して、1行コメントを書くこともできます
複数行のステートメント
引数が多くなったステートメントは、読みやすさのために複数行に分けて書けます。
継続行は空白文字で始まり、空白を除いた最初の文字が - または | である必要があります。 この条件を満たす行は直前のステートメントの末尾に連結され、全体で 1 つのステートメントとして扱われます。
changeFigure:stand.webp
-left
-id=fig1
-next;
上の記述は次と同じ意味です:
changeFigure:stand.webp -left -id=fig1 -next;
intro の複数のテキストも同様に | で継続できます:
intro:1 段落目
|2 段落目
|3 段落目 -hold;
グラフィカルエディタは、ステートメントが長くなった場合に自動でこの形式で出力します。短いステートメントは 1 行のままです。
注意すべきルール
- セミコロンと行内コメントは最後の行にしか書けません。 セミコロン以降はコメントとして扱われるため、1 行目に書くと継続行まで飲み込まれてしまいます。
- 空行は複数行ステートメントを終了させます。 1 つのステートメントの途中に空行を入れないでください。
-concatを含むステートメントは自動継続されません。-concatは「この対話を前の対話に連結する」という意味であり、両者の意味が衝突するためです。- 行末にバックスラッシュ
\を書くと継続を強制できます。 上記の制限を回避したい場合に使います:
intro:1 段落目\
|2 段落目\
|3 段落目 -concat;
- 互換性についての注意: 「空白 +
-」で始まる対話行は継続行と誤認されます。対話をダッシュで始めたい場合は、行頭の空白を削除するか、前に別の文字を置いてください。
特殊記号のエスケープ
WebGAL スクリプトでは、英語のコロン : でコマンドと内容を区切り、英語のセミコロン ; でステートメントを終了して行内コメントを開始します。また、一部のコマンドでは |、,、. などの記号も内容構文の一部として使用します。これらの記号を通常のテキストとして表示したい場合は、記号の前にバックスラッシュ \ を付けてください。
エスケープが必要になりやすい記号:
| 元の記号 | 書き方 |
|---|---|
: | \: |
, | \, |
. | \. |
; | \; |
| ` | ` |
intro:表示されます\: \:\,\.\; 見てください -hold;
WebGAL:表示されます\: \:\,\.\; 見てください;
choose:表示されます\: \:\,\.\; 見てください:nextLabel;
テキスト拡張構文で CSS を書く場合も、セミコロンは \; と書く必要があります。そうしないと、WebGAL ステートメントのコメント開始として扱われます。
noneキーワード
立ち絵、BGM、背景などのリソースを設定するとき、noneに設定することでそのオブジェクトを非表示にすることができます。
-nextパラメータ
任意の文の後に-nextパラメータを追加することができます。そうすることで、その文を実行した直後に次の文にジャンプすることができます。これは、複数の操作を同時に実行する必要がある場合に非常に便利です。
例:
changeBg:testBG03.jpg -next; // 次の文をすぐに実行します
-notendと-concatパラメータ
場合によっては、会話のある段階で演出効果、例えば表情の切り替えなどを追加したいと思うかもしれません。
その場合、-notend -concatパラメータを使用して、会話中に任意の文を挿入することができます。
-concatは、この会話が前の会話の後に続くことを意味します。
-notendは、この会話が終了していないことを意味し、その後に演出や会話が続く可能性があります。
例を以下に示します。これは、会話中に立ち絵を切り替えるデモです。
WebGAL:テスト文挿入演出!今すぐ立ち絵を切り替えます...... -notend;
changeFigure:k1.png -next;
立ち絵を切り替えます!今すぐ表情を切り替えます...... -notend -concat;
changeFigure:k2.png -next;
表情を切り替えます! -concat;
-concat パラメータのみを使用して、次の文を前の文の会話に接続することもできます。-notend パラメータは、会話のフェードアウト後に次の文に移動するためです。
これは最初の文です......;
ユーザーがマウスをクリックすると、2 番目の文に移ります -concat;