ボタン表示関連コマンド（Ver10.8.0）

ボタン（button）

ボタン btn1 a.png b.png c.png 200 300 40 透明無視 カメラ付着 ゲーム終了
ボタン0 btn2 200 300 40 透明無視 カメラ付着

• Imagesフォルダ内にある画像を素材として、特定のコマンドを持つボタンを作成します。
  コマンドを持たせないこともできます。
• 設定項目「ボタンクリック時イメージ」は、Ver8.0.0以降においてはコマンド「ハイライト条件」で設定した条件を満たす場合に表示を継続させることができます（項目参照：ハイライト条件）。
• ボタン0……透明度0の状態で設定します。インや透明度コマンドで表示することができますが、透明度0でもボタンはコマンドを適用してしまうので注意が必要です。
• 設定項目「透明無視」は、素材の透明度0の領域をボタン反応範囲から除外します。
  これにおける「透明度0」は「見た目上の透明度0の領域」ではなく「素材上の透明度0の領域（アルファ値が0）」を指します。
  したがって、コマンド「ボタン0」「透明度」等で個体全体の透明度が0になっても個体全体がボタン反応範囲から除外されるわけではなく、素材上の透明度が0より大きい領域はボタン反応範囲として機能します。

※1……当該3項目はコマンド「タッチ素材設定」の宣言以降において省略することができます。
※2……「登録済みアニメ名」に関しては項目参照：アニメ登録
※3……「カメラオプション」に関しては項目参照：カメラオプションについて

ボタン文字（btnText）

ボタン文字 ita Harenosora.otf 24 "設定画面へ"
ボタン文字 ita2 Harenosora.otf 24 -10 -2 "設定画面へ"

• 指定したボタンにテキストを表示します。横書きの一行表示に限定されています。
• ボタンへの文字使用を簡略化するためのコマンドです。
• コマンド「文字」で設定した個体に対してと同様に、ボタン文字にも文字関連のコマンドを適用できます。
  Ver6.2.0からVer7.1.0までは対象名にボタンの個体名を、Ver7.6.0以降はボタン名の末尾に「_text」を付与したものを設定します。
• 初期設定ではフォントに文字陰を適用し、ボールド体を使用しません。
• Ver10.0.0から、ボタン中央に対する文字位置の設定項目が追加されました。
  設定しなければ文字はボタン中央に整列します。変更する場合は、左右方向（x方向）は右、上下方向（y方向）は下を正として移動量を指定します。

ボタングループ化（setButtonGroup）

ボタングループ化 ui_menu_

• 指定した文字列を個体名の先頭に持つボタン個体をグループ化します。
  グループ化されたボタン個体は、グループ内の個体のひとつが選択された時点で他の個体の選択を禁止します。
  分岐の選択肢において、他の選択肢を選んで意図しないジャンプ先となってしまうことを避ける等の使い方があります。

ボタン反応範囲（btnTouchArea）

ボタン反応範囲 btn1 50 50 400 400

• ボタンの反応範囲を設定するコマンドです（Ver7.1.0以前においては動作しません）。
• 反応範囲の設定は、対象となるボタンの左上座標からの相対座標です。
  たとえば、大きさが500×100のボタンが座標（100,100）に設定されている場合において、コマンド「ボタン反応範囲 (ボタン名) 50 10 400 80」を設定します。
  このとき、反応範囲として指定される領域は、左右方向が150から550まで、上下方向が110から190までとなります。
• 対象となるボタンの本来の領域よりも大きな領域を反応範囲とすることも可能です。

ハイライト条件（highlight_if）

ハイライト条件 btn1 "vn_sysTextReadMethod == 1"

• ボタンの表示画像を「UI活性時画像（UIタッチ時画像）」で固定する条件を設定します。
  条件式が満たされている場合には表示画像が固定され、満たされていない場合には表示画像が元の設定に従うようになります。
  • たとえば、上記の例において（vn_sysTextReadMethod = 1）であれば、「btn1」はカーソルの接触に関係なく「UI活性時画像（UIタッチ時画像）」が表示されます。
    また、（vn_sysTextReadMethod = 0）であれば、「btn1」は通常どおりにカーソルの接触に応じて表示画像が変更されます。
• Ver8.0.0未満においては、ボタンに特定のコマンド（「文字進行」等）を設定している場合にコマンドの適用状態に応じて自動的に表示画像を固定していましたが、Ver8.0.0において特別に設定することが必要となりました。
• 条件式はテキストとして記述するため、先頭と末尾に「"」を必要とします。式であっても「()」で囲むわけではありません。

ボタンタッチ時（onBtnTouch）

ボタンタッチ時 btn1 スクリプト system.txt showbtn

• ボタンにカーソルを合わせた時に適用するコマンドを設定します。
  ボタンの表示関連での使用が多いようです。

ボタン未タッチ時（onBtnNotTouch）

ボタン未タッチ時 btn1 スクリプト system.txt hidebtn

• ボタンからカーソルを離す時に適用するコマンドを設定します。
• ボタンにカーソルを合わせていない時に常時適用されるコマンドではありません。
  必ず「ボタンにカーソルを合わせた後で、ボタンからカーソルを離す時」のみにコマンドが適用されます。
  「ボタンタッチ時」によって適用されたコマンドを初期化する等の使い方ができます。

タッチ素材設定（touchableRes）

タッチ素材設定 a.png b.png c.png touchbtn.ogg clickbtn.ogg d.png e.png

• UI（ボタンおよびトラックバー）に使用する画像と効果音のファイルを事前に一括で設定します。
  再度の設定があるまで、このコマンド以降に設定されるUIには、このコマンドで指定した素材が用いられます。
• 画像素材はいずれも同じサイズのものを設定する必要があります。
• UIに対する効果音の設定はこのコマンド限定の機能です（Ver8.0.0現在）。
  ただしコマンド「ボタンタッチ時」でタッチ時の効果音を設定することは可能です。
• 「UI活性時画像」「UI非活性時画像」の設定はこのコマンド限定の機能です（Ver10.2.0現在）。
  「UI活性時画像」は、コマンド「ハイライト条件」で指定した条件に合致する場合における画像素材を指定します。未指定の場合には「UIクリック時画像」が用いられます。
  「UI非活性時画像」は、Ver10.2.0現在では未実装項目となっているため、指定は不要です。
• 設定項目「UIタッチ時音」「UIクリック時音」に「""」を記述することによって、タッチ時やクリック時の効果音の設定を省略できます（Ver5.7.0以前は非対応）。

※1……「登録済みアニメ名」に関しては項目参照：アニメ登録
※2……Ver10.6.3現在では機能しないため、指定は不要です。

ボタン単独活性化（btnsOnlyActive）

ボタン単独活性化 sysbtn.*

• 特定のボタンのみを機能させます。対象の複数指定には正規表現を用います（項目参照：正規表現に触れてみよう）。
  例スクリプト文においては、先頭に「sysbtn」を持つすべてのボタンが選択可能になり、それ以外のボタンは選択できなくなります。
• コンフィグ画面などの特定の機能を持つ画面において、表示するボタンの個体名の先頭に共通する文字列を決めて使っておけば、このコマンドの適用効率が上がります。
• このコマンドは一段階の画面遷移に有効ですが、二段階以上の画面遷移では意図しない動作になる可能性があります。このコマンドは簡易版と捉えて、可能ならばコマンド「ボタン活性スタック」を用いるようにしましょう。
  • このコマンドが適用されると、まずボタンの選択可能条件を初期化し（コマンド「ボタン活性スタック」における「clear」）、次にボタンの選択可能条件を新規に設定します（コマンド「ボタン活性スタック」における「push」）。
    したがって、このコマンドを適用するたびに選択可能条件は追加ではなく更新されることになり、二段階以降は前段階の選択可能条件を再使用することができなくなります。

ボタン全活性化（btnsAllActive）

ボタン全活性化

• コマンド適用時点において存在しているすべてのボタンを選択できるようにします。
  コマンド「ボタン単独活性化」の効果を初期化するという用い方もできます。
• コマンド「ボタン活性スタック」の「clear」と同様の処理が行われます。

ボタン活性スタック（btnsActiveStack）

ボタン活性スタック push c_.*
ボタン活性スタック pop

• 選択可能なボタンに関する条件の変更を行います。
  「条件を積み上げる」「条件を上書きする」「条件を削除する」「条件を初期化する」を組み合わせ、積み上がった条件のうち、最も上にあるものを適用します。
• 変更内容として設定するのは以下のとおりです。
  • 「push」
    条件を積み上げます。条件には選択可能にするボタンの個体名を指定します。対象の複数指定には正規表現を用います（項目参照：正規表現に触れてみよう）。
    コマンド設定以降は、指定された条件に合致するボタンのみが選択可能になります。
  • 「overwrite」
    最上位の条件を上書きします。条件には選択可能にするボタンの個体名を指定します。対象の複数指定には正規表現を用います（項目参照：正規表現に触れてみよう）。
    コマンド設定以降は、上書きされた条件に合致するボタンのみが選択可能になります。
  • 「pop」
    最上位の条件を削除します。
    コマンド設定以降は、削除した条件の直下に積まれていた条件が最上位となり、その条件に合致するボタンのみが選択可能となります。
  • 「clear」
    条件を初期化し、積み上がりを解消します。
    コマンド設定以降は、すべてのボタンが選択可能になります。

※1　記述に関しては上記を参照
※2　「push」「overwrite」のみ必須

ボタン処理順位（btnFilterRange）

ボタン処理順位 0

• 領域の重なるボタンの存在時において、重複領域がクリックされた際の処理を設定します。デフォルトは「1」です。
  • 「ボタン処理順位 0」……クリック座標に領域を持つすべてのボタンが選択されます。
  • 「ボタン処理順位 1」……レイヤーの値が最も大きいボタンのみ選択されます。

トラックバー（trackbar）

トラックバー c_textspeed 300 100 170 横 500 vn_sysTextSpeed 10 800 trackball.png trackball_on.png trackball_click.png カメラ付着

• 変数操作を行うことができるトラックバーを設定します。
• このコマンドでは、トラックバーは透明の領域として設定され、トラックボールのみが表示されます。
  したがって、コマンド「絵」などを用いてトラックバー自体の素材を設定しておく必要があります。
• 変数には、コマンド「変数」で設定したものの他に、特定のシステム変数を用いることができます（項目参照：変数）。
• 設定項目「調整完了後実行コマンド」は、トラックバーによる変数操作の完了後にコマンドを適用するよう指定します。
  調整完了の効果音や設定調整の実演等に用いることが想定されています。

※1……当該3項目はコマンド「タッチ素材設定」の宣言以降において省略することができます。
※2……「登録済みアニメ名」に関しては項目参照：アニメ登録
※3……「カメラオプション」に関しては項目参照：カメラオプションについて