ダイアログの概要
作成日: 2024年10月24日
（からだが おもいよぉ）
グゥスピ・・・
（ふわふわする・・・）
昨日は 1 日中、ハカセに GB Studio の使い方を教えてもらって
さすがのビットンも心身ともに疲れ果ててしまったようです。
家まで帰ってこれたものの、入り口の扉も閉めずに
そのまま床でチカラ尽きてしまったのでした。
ずいぶん立派な巨木のようじゃが
家と呼んでよいのかわからんのう。
そしてビットンが言っていた通り
いたるところに傘がいっぱいじゃ。
この鈴みたいなものがドアベルかの。
オヤチ！（ビットンのオヤツかえせぇ！）
声は聞こえるんじゃがのう。
ん？あれ、扉が少し開いてるゾ。
今日は GB Studio をやりに
こないんかのー？
・・・って、なんじゃ！
なんで床で寝とるんじゃ！？
しかも昼過ぎまで寝とるとは。
昨日は相当疲れとったんじゃのう。
グゥスカピッピ・・・（ジービースタジオで）
ムニャピ・・・（メッセージウィンドウをだすには）
グゥ〜〜？・・・（どうしたらいいのかなぁ？）
え・・・なになに？
GB Studio でメッセージウィンドウ
を出すにはどうしたらええかって？
・・・と言っておるのか？
フム、今日は睡眠学習を
するということじゃな。
（よろしくおねがいしまぁす）
では今日はダイアログについて
教えてあげようかのう。
ダイアログとは？
表示するウィンドウのことじゃ。
ダイアログには、いくつか種類があるから
実際に使ってみながら順にみていこうかの！
プレイヤーが話しかけたアクターがメッセージを表示する
イメージで、イベントを追加するゾ。手順は次のとおりじゃ！
テキスト タブ内のテキスト入力エリアになにか好きな文字を入力するのじゃ。
メッセージダイアログ
イベントの追加 > ダイアログとメニュー > メッセージダイアログを表示する
キャラクターにセリフを喋らせたいときや、一般的なメッセージをゲームプレイヤーに向けて表示したい場合に使用します。単純に「ダイアログ」とだけ呼ばれることもあります。
テキスト
ダイアログに表示したいテキストを入力します。GB Studio はデフォルトの状態だと英語のフォントしかサポートしていません。日本語のフォントを使えるようにするためには日本語フォントの導入と環境設定が必要になります。日本語フォントの使用については、次のチュートリアル 日本語フォントを使う で説明していますので、参照してください。
テキスト > 制御コマンド
テキストには、さまざまな種類の制御コマンドが使用できますが、ここでは、最も良く使用されるであろう制御コマンドを紹介します。
制御コマンドは、テキスト入力中に半角英数で "!" や "$" と入力し、続けて入力した文字によって制御コマンドの詳細な選択肢が表示されます。例えば、"$" と入力した後に、変数名を入力すると、メッセージとして表示させたい変数の候補の一覧が表示され、選択することができます。変数については、今後のチュートリアルで説明します。
| フィールド | 説明 |
|---|---|
| !Font（または !F） | ダイアログで表示するテキストのフォントを変更することができます。 |
| !Speed（または !S） | テキストの表示速度を変更することができます。 |
| !Instant（または !I） | 文字送りを無効にして、テキストを瞬時に表示することができます。 |
| !Cursor（または !C） | 現在のテキスト描画位置を変更することができます。 使いどころは少し限定されますが、キャラの名前を ダイアログの上部に表示させたり、 テキストの位置揃えなどに活用できます。 カーソル 位置を次に設定 を選択した場合、描画位置を設定する項目P(X,Y) がダイアログテキスト内に表示されます。これをクリックして位置設定を行います。 （例） I am a KABUTORI.Ｐ(0,2) And you? （結果）  カーソル位置を次の値で移動 を選択した場合も、上記と挙動は似ていますが、 M(X,Y) がダイアログテキスト内に表示されます。これは絶対位置ではなく相対的な位置を設定します。 （つまり、X,Y の値を「移動量」で指定します） （例） Ｍ(+0,-1)KABUTORI I am a KABUTORI.Ｐ(0,2) And you? （結果）  ※ メッセージテキストの最後が一行空いてしまう場合は、後述する レイアウトスタイル の設定で 高さ（最大） の行数を調整してください。 |
その他の制御コマンドについてより詳しく知りたい場合は GB Studio 公式サイトのドキュメント を参照してください。
テキスト > アバターの追加
メッセージダイアログの左側に 16px x 16px のアバター画像を表示させることができます。
使用するアバター画像は PNG 形式でプロジェクトフォルダの assets > avatars フォルダに入れておく必要があります。なお、この画像はスプライトと同じ画像フォーマットとなりますので、パレットもスプライト用のルールが適用されます。スプライトのパレットについては、アクターとスプライトの概要 > スプライトを構成する 4 色 を参照してください。
フォルダに画像が存在すれば、アバターの追加 リンクをクリックしたときに表示されるドロップダウンから、適用したいアバターを選択することができます。
レイアウトスタイル
ダイアログの見た目を設定できる項目です。
| フィールド | 説明 |
|---|---|
| 高さ（最小） | ダイアログの高さの最小サイズ（タイル単位）。 表示するテキストの行 数が少なくても、 ダイアログの高さは必ずこの最小のサイズで表示されます。 |
| 高さ（最大） | ダイアログの高さの最大サイズ（タイル単位）。 表示するテキストの行数が、この高さを超えるとスクロールします。 |
| テキスト（X） | テキストの描画が開始する X 軸方向の位置です（タイル単位）。 たとえば、アバターとテキストの間にマージンが欲しい場合などに設定します。 |
| テキスト（Y） | テキストの描画が開始する Y 軸方向の位置です（タイル単位）。 |
| スクロール行数 | テキストをスクロールさせる行数です。 |
| 位置 | ダイアログを画面の上または下の位置に表示させるかを選択できます。 |
| 前の描画をクリア | 前に描画されているダイアログの内容を消去するかどうかを指定します。 消去しない場合は、前の描画の上から新しい描画が上書きされます。 通常はチェックを有効にしておきます。 |
| フレームの表示 | ダイアログのフレーム（枠）を表示するかどうかを指定します。 |
動作
ダイアログの動作に関する設定が行えます。
| フィールド | 説明 |
|---|---|
| 開く速度 | ダイアログが表示される間のスライドアニメーション速度。 |
| 閉じる速度 | ダイアログが非表示になるまでの間のスライドアニメーション速度。 |
| 閉じる条件 | ダイアログをどのように閉じるかの条件設定。ボタンの押下時 は、下のフィールドで設定したいずれかのボタンが押されたときにダイアログが閉じます。 テキスト描画の完了時 は、テキストがすべて表示し終わった後に閉じます。（このオプションを選択すると、ダイアログが閉じるまでの時間が設定できる 閉じるまでのウェイト フィールドが表示されます）閉じない（非モーダル） は、ダイアログの処理が完了し終わっても閉じません。ダイアログを閉じたい場合は、別途 非モーダルダイアログを閉じる イベントを使います。 |
プリセット
ここで設定したダイアログの設定をテンプレート化して、他のイベントでも同じ設定を呼び出すことができます。例えば、RPG の宿屋の受付など決まって同じセリフ（お泊まりで？）を喋るキャラクター用のプリセット作成しておけば、ゲーム中のすべての宿屋の受付キャラクターに対して毎回おなじメッセージを書かなくともプリセットを適用するだけで、同じセリフを喋らせることができます。さらに、プリセットの内容を変更した場合は、このプリセットが設定されたすべてのダイアログに変更内容が反映されるので、ひとつひとつ手直しする手間が減ります。
新たにプリセ ットを作成する場合は プリセット ドロップダウンから プリセットの作成 を選択します。すでに作成されたプリセットを設定するときは、ドロップダウンから既存のプリセットを選択します。
プリセットの作成を選択すると、次の設定項目が表示されます。プリセットの保存 をクリックするとプリセットが保存されます。
| フィールド | 説明 |
|---|---|
| 名前 | 新たに作成するプリセット名です（例：宿屋の受付）。 |
| プリセットに含める内容 | テンプレート化したい内容を選択します。 ここで選択した項目のみがプリセットとして保存されます。 |
作成されたプリセットを プリセット ドロップダウンから選択すると、次のような項目が表示されます。
テキスト、レイアウトスタイル、動作のいずれかを変更したあとに 変更の適用 ボタンで変更内容を選択しているプリセットに上書き保存できます。 なお、変更の適用 をクリックした後に、再度プリセットの作成時と同じ設定項目が表示されます。このときに プリセットの保存 を改めてクリックしないとプリセットの変更は適用 されませんので注意してください。
デフォルトとして設定 をクリックすると、現在選択されているプリセットがデフォルトの設定として適用されます。つまり、次に メッセージダイアログを表示する イベントを追加したときに、このプリセットが自動的に適用された状態になります。デフォルト設定されたプリセットを解除するには、デフォルトから削除 をクリックします。
プリセットの削除 をクリックすると、現在選択されているプリセットが削除されます。このプリセットを使用しているすべてのダイアログイベントからプリセットが解除されます。
選択肢ダイアログ
イベントの追加 > ダイアログとメニュー > 選択肢ダイアログを表示す る
主に 2 選の選択肢（はい、いいえ、など）をプレイヤーに選択させたい場合に使用します。
| フィールド | 説明 |
|---|---|
| 格納変数 | 選択肢の結果を保存する変数です。 最初の項目が選択されると、この変数の値に True （または整数値 1）が入ります。 2 番目の項目が選択されると、この変数の値に False （または整数値 0）が入ります。 |
| 選択された場合「True」に設定 | 最初の項目のテキストラベルを指定します。 |
| 選択された場合「False」に設定 | 2 番目の項目のテキストラベルを指定します。 |
メニューダイアログ
イベントの追加 > ダイアログとメニュー > メニューダイアログを表示する
2 項目以上、8 項目以下の選択肢をプレイヤーに選択させたい場合に使用します。複数選択肢のあるイベントや、アイテムの売買リストの一覧などに用いることができます。
項目数が 4 つを超えると、自動的に 2 列表示になります。
| フィールド | 説明 |
|---|---|
| 格納変数 | 選択肢の結果を保存する変数です。 いずれかの項目が選択されると、この変数の値として 選択された項目のインデックス（1, 2, …） が入ります。 |
| 項目数 | 表示させたい項目数を指定します。 |
| 選択された場合「X」に設定 | X の値が格納変数として設定された変数に入ります。 |
| 最後の項目が選択された場合「0」を代入 | このオプションが有効の場合、最後の選択項目 （スクショの例では「CANCEL」） が選択された場合、格納変数として設定された 変数に整数値 0 が入ります。 |
| 「B」ボタンが押された場合「0」を代入 | このオプションが有効の場合、「B」ボタンの押下時に 格納変数として設定された変数に整数値 0 が入ります。 |
| レイアウトスタイル | ダイアログの見た目を設定できます。ダイアログ スタイルの場合は、ダイアログの横幅が画面の幅いっぱいに表示されるスタイルです。 4 項目以降の選択項目は 2 列で表示されます。 メニュー スタイルの場合は、ダイアログの横幅が短縮され、画面の右側に表示されます。また、このスタイルはすべての 選択項目が 1 列に（最大 8 項目まで）表示されます。  メニュースタイルの例 |
ダイアログのフレーム画像の変更
ダイアログのフレームは、プロジェクトフォルダ内の assets > ui > frame.png の画像ファイルを描き変えて変更することができます。透過色は使えませんので、背景画像と同じパレットを使用します。背景画像のパレットについては、シーンの概要 > 背景画像を構成する 4 色 を参照してください。
フレーム画像は、フレームを構成する 9 つの画像パーツ（フレームの左上、真上、右上、真左、中央、真右、左下、真下、右下）からできています。これらのパーツはそれぞれ 8x8 ピクセルのサイズです。
フレーム画像を変更すると、グッとオリジナリティがあがります。
カーソル画像の変更
ダイアログのフレームと同様に、カーソルの画像もプロジェクトフォルダ内の assets > ui > cursor.png の画像ファイルを描き変えて変更することができます。ただし、こちらは 8x8 ピクセル限定です。透過色は使えませんので、背景画像と同じパレットを使用します。背景画像のパレットについては、シーンの概要 > 背景画像を構成する 4 色 を参照してください。
グググゥ・・・ムニャ〜リ
エイゴ・・・イヤイヤなの・・・
なにが言いたいのか、よくわからないゾ。
どれ、ワシのつくった「夢見マシン」で
夢の中を覗いてみよう。
使いこなしておるな。感心感心。
言いたいことはわかるぞ、ビットン。
ダイアログのテキストを日本語で
表示できないとモチベーションが
あがらんのじゃろ！
安心せい、次回は日本語フォントの
使用について解説するゾ！