ElementsDialog¶

実験中 ( 安定保証の対象外 )

この API はまだ形が固まっていません。予告なく変更・削除されることがあります ( 非互換変更でもメジャー番号は上がりません )。版の上げ方はバージョン運用を参照してください。

Elements ベースの UI 機構はまだ形が固まっていません。2026-09-04 にはクラス名自体を Dialog から改名しました ( 互換エイリアス無し )。

ElementsDialog クラスは、Elements ベースの汎用ダイアログを TJS から駆動するための

クラスです ( SDL3 / WINVER 両ビルド対応 )。

JSON / JSONC ( コメントと末尾カンマを許容 ) 形式のレイアウト定義を渡して、ボタン・チェックボックス・トグル・テキスト入力等を含むダイアログを表示できます。動作モードは 3 種類あります。

レイアウト定義は JSON / JSONC 文字列のほか、TJS の Dictionary / Array をそのまま渡せる Dict 系メソッド ( showDict / showModalDict ) も利用できます。

非モーダル (オーバーレイ表示) showJson / showFile で表示します。表示中もメインループは止まらず、ボタン押下や値変更があるたびに onAction が逐次発火します。明示的に close を呼ぶか、ダイアログ側で閉じるイベントが起きるまで残ります。
ブロッキングモーダル (独立ウィンドウ) showModalJson / showModalFile にタイトル ( および幅・高さ ) を渡して呼ぶと、新しいネイティブウィンドウが開き、閉じるまで TJS の実行を止めて結果を Dictionary で返します。
ブロッキングモーダル (ゲーム画面へのオーバーレイ) showModalJson / showModalFile を JSON 1 引数だけで呼ぶと、独立ウィンドウを開かずに既存のゲーム画面に重ねて表示し、閉じるまでブロッキングします。

複数画面を遷移する「フロー」の駆動にも対応しています。ブロッキング実行は showFlow / showFlowScreens、非モーダル ( 常駐 ) 実行は startFlow / startFlowScreens を使用します。画面遷移のタイミングで onScreen / onScreenLeave が発火し、widget 操作は引き続き onAction に通知されます。

非モーダルダイアログは複数同時に表示できます ( z-order 付きで重ね描画され、マウスはヒットテスト、キーボードは最前面の handler 優先でフォーカスが移ります )。grabFocus 引数を偽にすると、フォーカスを取らない常駐 HUD として表示できます。showJson(json, true, false) ( フォーカスあり非モーダル ) にするとキー / パッドでパネルを操作しつつ未処理キーをホストへ素通しでき、ホストが必ず受けたいキーは registerHotKey で確保できます。

JSON 仕様の要素タイプ ( label / button / input_box / checkbox / toggle / text_box / text_area / vtile / htile / vspacer / hspacer 等 ) や属性、レイアウト密度指定 ( "gap" / top-level "style" ブロック ) の詳細は elements_modal の README、 "input" ノードによるキーボード / ゲームパッド操作の設定詳細はキーボードナビゲーション仕様を参照してください。

矩形へ本文を流し込むなら text_area を使います。折り返し・行頭行末禁則・文字送りが Layer.drawShapedTextArea と同じロジックなので、同じ本文・同じ幅なら改行位置が一致します。 "count_var" に変数名を与えると setVar で文字送りが進み、折り返しは全文で確定済みなので送ってもリフローしません ( 字幕やセリフ窓向け。従来からある text_box は互換のためそのまま )。

KRKRZ_USE_ELEMENTS=OFF でビルドした exe では ElementsDialog クラスは利用できません。 WINVER (Windows ネイティブ / D3D11) ビルドでも ElementsDialog は利用できます (非モーダル / overlay モーダル / 独立ウィンドウモーダル / フロー / テキスト入力すべてに対応)。

メンバー一覧¶

ElementsDialog¶

コンストラクタ

解説

ElementsDialog オブジェクトの構築

ElementsDialog クラスのオブジェクトを構築します。

defaultFontFamily¶

プロパティ \ アクセス: r/w

型: string

解説

デフォルトフォントファミリ

Elements の theme に適用される label / button 等の既定フォントファミリ名 ( カンマ区切り ) を取得 / 設定します。値の getter / setter とも Elements ランタイムが初期化されたあと ( 最初のダイアログ表示後 ) に意味を持ちます。

active¶

プロパティ \ アクセス: r

型: bool

解説

この ElementsDialog インスタンスがアクティブかどうか ( 読み取り専用 )

この ElementsDialog で開いた非モーダルダイアログ / フローが現在アクティブなときに真になります。close を呼んだ直後はまだ teardown が終わっていないため真のままで、teardown 完了後に偽に切り替わります。

非モーダル UI を閉じてから次のモーダルダイアログを起動したい、といったタイミング制御に使います。

modalActive¶

プロパティ \ アクセス: r

型: bool

解説

モーダルなダイアログが表示中かどうか ( 読み取り専用 )

showModalJson 系やモーダルフローで開いたインスタンスが 1 つでもアクティブなら真になります ( どのインスタンスから読んでもプロセス全体の状態を返します )。フォーカスを取らない常駐オーバレイ ( 字幕・HUD 等 ) は含みません。

最上位ホットキー ( System.registerHotKey ) のコールバックで「モーダル表示中は何もせず素通しする」判定に使います。

関連: ElementsDialog.active

atlasCacheStats¶

プロパティ \ アクセス: r/w

型: Dictionary

解説

アトラスのデコードキャッシュの常駐量 ( 読み取り専用 )

アトラス画像は「パス + 倍率」をキーにデコード済みの絵をキャッシュして使い回します。画面を切り替えても手放しません — 長時間プレイでヒープが断片化したあと大きな連続領域が取れずデコードに失敗し、絵の無い画面が組まれてしまうのを避けるためです。どれだけ抱えているかを場面の切れ目で確認するためのプロパティです ( クラス全体に効く static 相当 )。

辞書で bytes ( RGBA 展開後の合計バイト数 ) / count ( エントリ数 ) / budget ( 現在の予算 ) を返します。

var st = global.ElementsDialog.atlasCacheStats;
Debug.message("アトラス常駐 %.1f MB (%d 件)".sprintf(st.bytes / 1048576.0, st.count));

関連: ElementsDialog.trimAtlasCache

atlasCacheBudget¶

プロパティ \ アクセス: r/w

型: Integer

解説

アトラスのデコードキャッシュの予算 ( バイト )

代入すると恒久的に変わり、下げた場合はその場で切り詰めます。 0 にするとキャッシュ無効 ( 毎回デコード ) になります。既定は 192MB で、1 画面ぶんのアトラスを載せたままにできる大きさです ( クラス全体に効く static 相当 )。

関連: ElementsDialog.trimAtlasCache

watchVars¶

プロパティ \ アクセス: r/w

型: String

解説

i18n の表示言語

画面 JSON の top-level strings ( textID → 言語別文字列 ) を引くときのキーです ( クラス全体に効く static 相当 )。"ja" / "en" / "tc" / "sc" など、 strings 側で使っているキーをそのまま指定します。

global.ElementsDialog.language = "en";     // 表示中の画面もその場で切り替わる

代入すると表示中の全ダイアログへ即時適用されます ( text_id / text_list_id / options_id を持つ widget が再解決され、画面を開き直さずに表示が変わります )。以後に開く画面の既定にもなります。picker 系は選択 index を維持したまま表示文字列だけ差し替わります。

読み出すと設定済みの言語を返します。未設定なら空文字 ( = 各画面 JSON の lang 指定に従う ) です。strings を持たない画面では何も起きません。

変数変化通知の対象

onVar で受け取る変数を絞る / 明示指定するプロパティです。

変数名の配列 ... その変数だけ通知する
"*" ... すべての変数を通知する
空配列 ... 通知しない ( 明示的に止める )
void ... 既定へ戻す

既定 ( 未設定 ) は「onVar を実装していればすべての変数」です。 "vars_on_hover" の変数やドラッグ位置は毎フレーム書き換わるため、特定の変数だけ必要なら名前を並べたほうが軽くなります。表示中に設定しても即座に反映されます。

language¶

プロパティ \ アクセス: r/w

fontLanguages¶

プロパティ \ アクセス: r/w

型: Object

解説

言語連動フォント置換表

文字体系ごとの別フォント ( Noto Sans JP / TC / SC など ) を持つ多言語 UI で、表示言語に応じてフォント解決時にファミリを差し替えるための表です ( クラス全体に効く static 相当 )。日中で共有しているコードポイントの漢字を、表示言語に合った地域字形で描画できます。

言語コードをキーに、map ( ファミリ名または registerFont の別名 → 置換先ファミリ ) と fallback ( 任意。その言語のときの theme 既定ファミリチェーンの並び ) を持つ辞書 ( または同形の JSON 文字列 ) を代入します。

global.ElementsDialog.fontLanguages = %[
"tc" => %[ "map" => %[ "Noto Sans JP" => "Noto Sans TC" ] ],
"sc" => %[ "map" => %[ "Noto Sans JP" => "Noto Sans SC" ] ] ];
global.ElementsDialog.language = "sc";   // 以後 "Noto Sans JP" 指定は SC フォントで描画

map は widget の "font" 指定と theme 既定チェーンの各ファミリトークンに適用され、"#tag=val" の可変軸サフィックスは温存されます ( JP/TC/SC が同じ軸を持つ可変フォントならウェイト指定がそのまま引き継がれます )。適用される言語は widget の明示 "locale" があればそれ、無ければ language です。表にエントリの無い言語では置換されません。

画面 JSON / app.jsonc の top-level "font_languages" と同じ表で、言語単位にマージ登録されます ( 後から設定した方が言語ごとに上書き )。読み出すと最後に代入した表を JSON 文字列で返します ( 未設定なら空文字。画面 JSON 側の宣言は含みません )。

text_area はビルド時にフォントが確定するため、表示中の言語切替には追従しません ( 画面を開き直すと反映されます )。

virtualKeyboard¶

プロパティ \ アクセス: r/w

型: String

解説

内蔵仮想キーボードの動作モード

テキスト欄 ( input_box 等 ) に focus が入ったとき、OS のソフトウェアキーボードの代わりに Elements 内蔵の英数キーボードを出すかどうかを指定します。設定できる値は次の通りです。

値	意味
`"auto"`	既定。物理キーボードが接続されていないときだけ出す
`"always"`	物理キーボードがあっても常に出す ( テスト用。デスクトップでも出る )
`"never"`	出さない ( OS 側に任せる )。表示中なら閉じる

初期値は環境変数 KRKRZ_FORCE_VIRTUAL_KEYBOARD=1 があれば "always"、無ければ "auto" です。

出るのは Elements のテキスト欄に focus が入ったときで、ゲーム側が自前で描いている入力欄では出ません。押鍵は貯めずにその場で入力先へ流し込まれるため、入力欄がリアルタイムに更新されます。現バージョンでは大文字英数字のみ対応です。

動作を確認できるコアデモは softkey_ime です。

hasPhysicalKeyboard¶

プロパティ \ アクセス: r

型: Boolean

解説

物理キーボードの有無

物理 ( ハードウェア ) キーボードが接続されているかを返します。読み出し専用。デスクトップでは常に真、コンソール機等では USB キーボードの接続状態になります。ゲーム側が独自のソフトウェアキーボードを出すかどうかの判断に使用します。

関連: ElementsDialog.virtualKeyboard

focusRing¶

プロパティ \ アクセス: r/w

型: Boolean

解説

フォーカス枠の表示

フォーカス中の要素に Elements が描く汎用の枠 ( 青い角丸 ) の表示です ( クラス全体に効く static 相当 )。既定は true。

global.ElementsDialog.focusRing = false;    // アプリ全体で消す

button / slider / dial / thumbwheel の枠がまとめて消えます。状態別の絵 ( 通常 / オーバー / 押し下げ / 無効 ) を素材として持つ画像 UI では、汎用の枠が絵に重なって邪魔になるので切ります。フォーカス自体は生きているので、キー/パッドのナビゲーションと hilite フレームへの切替は従来どおり動きます。

画面単位ではなくアプリ全体の設定です ( グローバルテーマのフラグ )。

クラス内から触るときは global.ElementsDialog.focusRing と書きます。ElementsDialog を継承したクラスのメソッド内で素の ElementsDialog と書くと親クラス参照になり、static プロパティへの代入が「メンバが見つかりません」になります。

baseSize¶

プロパティ \ アクセス: r/w

型: Array

解説

UI の author 基準面サイズ

オーバレイ表示の拡縮率 ( fit ) の分母になる基準面のサイズを [w, h] の配列で指定します。void ( または要素の無い配列 ) を設定すると既定 = ゲームの基準面 ( primaryLayer のサイズ ) に戻ります。設定していないときの getter は void です。

ゲーム画面と別解像度で UI を author しているタイトル ( ゲーム画面 640x400 / UI 1920x1080 等 ) で設定すると、部分パネルの拡縮が author 基準どおりになり、ゲーム側の primaryLayer サイズ変更 ( 低解像度機種のエミュレーション等 ) にも巻き込まれません。表示中の画面にも次のフレームから反映されます。

関連: ElementsDialog.renderScale

renderScale¶

プロパティ \ アクセス: r/w

解説

オーバーレイの描画密度モード

overlay の描画密度モードです ( クラス全体に効く static 相当 )。

0 ( 既定 ) = auto: 最終 present サイズで直接ラスタライズ。
0 = authored 論理サイズ × この倍率で描き、present 時に拡縮 ( 1.0 = 原寸レンダ→拡縮表示、 2.0 = supersampling 相当 )。

表示中の画面にも次フレームから反映されます ( 描画品質/負荷の比較用 )。

renderCache¶

プロパティ \ アクセス: r/w

解説

オーバーレイの再ラスタライズ抑止

true ( 既定 ) の間、変化の無いフレームはダイアログの再ラスタライズ ( CPU ) とテクスチャ再アップロードを省略し、前回の描画結果をそのまま提示します ( クラス全体に効く static 相当 )。アイドル中の CPU 負荷が大きく下がります。

入力イベント・フォーカス/ホバー変化・パーツ演出再生中・setVar の実変化・テキスト欄キャレットの点滅・画面遷移エフェクト中などは自動的に再描画されます。 false にすると従来どおり毎フレーム再描画します ( 負荷比較・問題切り分け用 )。

partialRedraw¶

プロパティ \ アクセス: r/w

解説

オーバーレイの部分再描画

true ( 既定 ) の間、変化した範囲が矩形で特定できる場合はその矩形だけを再ラスタライズしてテクスチャへ部分転送します ( クラス全体に効く static 相当 )。矩形が特定できるのはテキスト欄のキャレット点滅などに限られ、入力・フォーカス変化・パーツ演出・setVar などは従来どおり全面再描画になります。

ElementsDialog.renderCache が有効なときのみ機能します ( 前回の描画結果が残っていることが前提 )。false にすると変化フレームは常に全面再描画します ( 負荷比較・問題切り分け用 )。実際に部分再描画できた回数は ElementsDialog.renderStats の "partials" で確認できます。

renderCount¶

プロパティ \ アクセス: r/w

解説

ラスタライズ累計回数 ( 読み取り専用 )

実際にラスタライズ ( 再描画 ) を行った累計回数です ( クラス全体で共通 )。アイドル時に増えていなければ renderCache が効いています ( 検証・負荷比較用 )。

renderStats¶

プロパティ \ アクセス: r/w

解説

描画パイプラインの区間計測 ( 読み取り専用 )

オーバーレイ描画の負荷内訳を Dictionary で返します ( クラス全体で共通の累積値 )。時間はすべてマイクロ秒です: %[ "frames" => 提示フレーム数, "updates" => 状態更新回数, "rasters" => ラスタライズ回数, "partials" => うち部分再描画だった回数, "cachedPresents" => ラスタ省略提示回数, "presents" => 提示回数, "totalUs" => 描画処理全体, "updateUs" => 状態更新, "rasterUs" => CPU ラスタライズ, "acquireUs" => バッファ確保, "uploadUs" => テクスチャ転送, "presentUs" => 提示 ]

累積値なので 2 回読んで差分を取り、経過実時間との比で「Elements が消費した時間・割合」を計算します ( ElementsDialog.renderStatsReset で 0 クリア )。計測用のベンチ画面がコアデモ elements_bench にあります ( シナリオ切替 + renderCache A/B + 500ms ごとの内訳表示 )。

showJson¶

メソッド

引数

引数	既定値	説明
`json`	` `	JSON / JSONC 形式のレイアウト定義文字列を指定します。
`grabFocus`	`true`	キーボードフォーカスを取得するかどうか ( 既定 true )。 true のときはパネルがキーボードフォーカスを取得し、input_box 等への文字入力やウィジェットのキー / パッド操作ができます。 false のときはフォーカスを取らず、キー入力はホスト ( Window ) へ通ります。表示専用の常駐 HUD 的なパネルに指定します。この場合パネル内の input_box 等への文字入力はできません。マウス操作は grabFocus に関わらず有効です。
`modal`	`grabFocus`	モーダル ( 入力独占 ) にするかどうか。省略時は後方互換で grabFocus と同じ値になります。 `showJson(json, true, false)` = 「非モーダル + フォーカスあり」の中間状態で、キー / パッドはパネルへ届いてウィジェットを操作でき ( パッドの十字 = フォーカスナビ / A = 決定 )、パネルが処理しなかったキーだけがホスト ( Window.onKeyDown ) へ素通しされます。操作パネル用途はこの指定を推奨します。ホストが必ず受けたいキーは registerHotKey で確保してください。用途 3 態: モーダルダイアログ `showJson(json)` / 操作パネル `showJson(json, true, false)` / 表示専用 HUD `showJson(json, false)`。

戻り値

表示開始に成功したら真を返します。

解説

JSON 文字列で非モーダルダイアログを表示する

指定された JSON / JSONC 形式のレイアウト定義からダイアログを構築し、既存のゲーム画面にオーバーレイ表示します。表示中もメインループは止まらず、ユーザ操作のたびに onAction が発火します。表示を終わらせるには close を呼んでください。

showFile¶

メソッド

引数

引数	既定値	説明
`path`	` `	JSON / JSONC ファイルのパスを指定します。
`grabFocus`	`true`	キーボードフォーカスを取得するかどうか ( 既定 true )。詳細は showJson を参照。
`modal`	`grabFocus`	モーダルにするかどうか ( 省略時は grabFocus に追従 )。詳細は showJson を参照。

戻り値

表示開始に成功したら真を返します。

解説

ファイルから非モーダルダイアログを表示する

指定パスから JSON / JSONC レイアウト定義を読み込み、showJson と同じ動作で表示します。パスは Storages 経由のパス指定が使えます。

関連: ElementsDialog.showJson

showDict¶

メソッド

引数

引数	既定値	説明
`dict`	` `	レイアウト定義の Dictionary を指定します。
`grabFocus`	`true`	キーボードフォーカスを取得するかどうか ( 既定 true )。詳細は showJson を参照。
`modal`	`grabFocus`	モーダルにするかどうか ( 省略時は grabFocus に追従 )。詳細は showJson を参照。

戻り値

表示開始に成功したら真を返します。

解説

Dictionary で非モーダルダイアログを表示する

showJson のレイアウトを JSON 文字列ではなく TJS の Dictionary / Array で直接指定する版です。内部で JSON へ変換して同じ経路で表示します ( 変換仕様は dictToJson と同じ )。

showModalJson¶

メソッド

引数

引数	既定値	説明
`json`	` `	JSON / JSONC 形式のレイアウト定義文字列を指定します。
`title`	`""`	独立ウィンドウのタイトルを指定します ( 省略するとオーバーレイモードに切替わります )。
`width`	`800`	独立ウィンドウの幅をピクセル単位で指定します ( 既定値 800 )。
`height`	`600`	独立ウィンドウの高さをピクセル単位で指定します ( 既定値 600 )。

戻り値

action と values を保持する Dictionary が返ります。

解説

JSON 文字列でモーダルダイアログを表示する

指定された JSON / JSONC 定義からダイアログを構築し、閉じるまで TJS の実行を止めてブロッキング表示します。

引数を JSON 1 個だけで呼ぶと、既存のゲーム画面にオーバーレイ表示 ( in-game modal ) します。
title 以降を渡すと独立した新しいネイティブウィンドウを開いて表示します。

戻り値は次の構造の Dictionary です。

%[ action: <閉じた button の id ( Esc / × は "" )>, values: %[ : <値>, ... ] // state widget の最終値マップ ]

モーダル表示中も onAction は発火しますが、ダイアログを閉じるのは "close_on_click": true 指定の button が押されたとき ( および Esc / × による中断 ) だけです。

showModalFile¶

メソッド

引数

引数	既定値	説明
`path`	` `	JSON / JSONC ファイルのパスを指定します。
`title`	`""`	独立ウィンドウのタイトルを指定します ( 省略するとオーバーレイモードに切替わります )。
`width`	`800`	独立ウィンドウの幅をピクセル単位で指定します ( 既定値 800 )。
`height`	`600`	独立ウィンドウの高さをピクセル単位で指定します ( 既定値 600 )。

戻り値

action と values を保持する Dictionary が返ります。

解説

ファイルからモーダルダイアログを表示する

指定パスから JSON / JSONC レイアウト定義を読み込んで showModalJson と同じ動作で表示します。パスは Storages 経由のパス指定が使えます。

関連: ElementsDialog.showModalJson

showModalDict¶

メソッド

引数

引数	既定値	説明
`dict`	` `	レイアウト定義の Dictionary を指定します。
`title`	`""`	独立ウィンドウのタイトルを指定します ( 省略するとオーバーレイモードに切替わります )。
`width`	`800`	独立ウィンドウの幅をピクセル単位で指定します ( 既定値 800 )。
`height`	`600`	独立ウィンドウの高さをピクセル単位で指定します ( 既定値 600 )。

戻り値

action と values を保持する Dictionary が返ります。

解説

Dictionary でモーダルダイアログを表示する

showModalJson のレイアウトを TJS の Dictionary / Array で直接指定する版です。引数 1 個で呼ぶとオーバーレイ、title 以降を渡すと独立ウィンドウで表示する点、および戻り値の形式は showModalJson と同じです。

dictToJson¶

メソッド

引数

引数	既定値	説明
`value`	` `	変換する値 ( Dictionary / Array / 基本型 ) を指定します。

戻り値

JSON 文字列が返ります。

解説

Dictionary / Array を JSON 文字列へ変換する

showDict / showModalDict が内部で行う変換をそのまま呼び出すユーティリティです。Dictionary で組み立てたレイアウトを JSON 資材として保存する、変換結果を確認する、といった用途に使えます。インスタンスを作らず ElementsDialog.dictToJson(...) として呼べます。

対応する値の型は void / Integer / Real / String / Dictionary / Array です。それ以外 ( Octet や一般のオブジェクト、循環参照、非有限の実数 ) は例外になります。

関連: ElementsDialog.showDict

showFlow¶

メソッド

引数

引数	既定値	説明
`manifestPath`	` `	app.jsonc マニフェストの Storages パスを指定します。

戻り値

action と values を保持する Dictionary が返ります。

解説

マニフェストから複数画面フローをブロッキング表示する

app.jsonc 形式のマニフェスト ( Storages 経由のパス指定 ) を読み込んで、複数画面の遷移を含むフローを既存のゲーム画面にオーバーレイで実行します。フロー終了まで TJS の実行を止め、最後に閉じた画面の Dictionary %[ action, values ] を返します。

画面が切り替わるたびに onScreen / onScreenLeave、各 widget の操作で onAction が発火します。

画面 JSON の transitions エントリを object 形式にすると、画面切替時の遷移エフェクトを宣言できます ( effect: "fade" = クロスフェード / effect: "universal" = rule 画像によるユニバーサルトランジション。 duration = 所要 ms ( 省略時 200 )、universal では追加で rule = rule 画像パス ( 宣言した画面からの相対 / Storages パス / autopath 検索 )、 vague = 境界ぼかし幅 0〜255 ( 省略時 64 ) を指定します )。

"transitions": {
"next": { "target": "s2", "effect": "fade", "duration": 300 },
"back": { "target": "<back>", "effect": "universal",
"rule": "rule.png", "vague": 64, "duration": 500 }
}

showFlowScreens¶

メソッド

引数

引数	既定値	説明
`screensDict`	` `	画面名 ( 文字列 ) をレイアウト定義 ( JSON 文字列、または Dictionary / Array ) にマップする Dictionary。両形式の混在も可能です。
`entry`	` `	起点画面名 ( screensDict のキー ) を指定します。

戻り値

action と values を保持する Dictionary が返ります。

解説

インライン定義から複数画面フローをブロッキング表示する

ファイル I/O を介さず、Dictionary で画面名 → レイアウト定義を渡してフローを実行する showFlow のインライン版です。動作と戻り値は showFlow と同じです。

startFlow¶

メソッド

引数

引数	既定値	説明
`manifestPath`	` `	app.jsonc マニフェストの Storages パスを指定します。
`grabFocus`	`true`	真でキーボード / ゲームパッドフォーカスを取ります ( 既定値真 )。偽を指定するとフォーカスを取らない常駐 HUD として表示されます。

戻り値

開始に成功したら真を返します。

解説

非モーダル ( 常駐 ) 複数画面フローを開始する

showFlow と同じマニフェストを非モーダル ( 非ブロッキング ) で開始し、即座に戻ります。ゲーム画面に出しっぱなしで進行させられるため、メインメニューや HUD のような常駐 UI に適しています。

画面遷移は JSON 側 transitions 定義で行います。ボタン押下等を起点に TJS 側で処理する場合は、"close_on_click" を指定しない button の onAction で振り分けてください。明示的に終了させるには close を呼び、teardown が完了したかどうかは active で判別できます。

startFlowScreens¶

メソッド

引数

引数	既定値	説明
`screensDict`	` `	画面名 ( 文字列 ) を JSON 文字列にマップする Dictionary。
`entry`	` `	起点画面名 ( screensDict のキー ) を指定します。
`grabFocus`	`true`	真でキーボード / ゲームパッドフォーカスを取ります ( 既定値真 )。偽を指定するとフォーカスを取らない常駐 HUD として表示されます。

戻り値

開始に成功したら真を返します。

解説

インライン定義から非モーダル ( 常駐 ) 複数画面フローを開始する

showFlowScreens と同じ Dictionary 形式の画面定義を非モーダル ( 非ブロッキング ) で開始する startFlow のインライン版です。

close¶

メソッド

解説

ダイアログを閉じる

このインスタンスで開いた非モーダル / モーダルダイアログ ( フロー含む ) を閉じます。他のインスタンスが開いたダイアログは閉じません。

内部の teardown は次フレームで行われるため、close を呼んだ直後でもしばらく active は真のままです。次のモーダルを安全に起動したい場合は active が偽になるのを待ってください。

画面内の要素に "animate" の "on": "exit" 指定 ( 退場演出 ) がある場合、close でも退場演出を再生し、完了してから閉じます ( その間も active は真のままです )。フロー実行中の close は画面遷移 ( transitions ) を解決せず、フローごと終了します。

関連: ElementsDialog.active

registerFont¶

メソッド

引数

引数	既定値	説明
`family`	` `	登録時に使うファミリ名を指定します。
`path`	` `	フォントファイル ( .ttf / .otf ) の Storages パスを指定します。
`weight`	`40`	weight 値を指定します ( 既定値 40 = normal )。
`slant`	`0`	slant 値を指定します ( 既定値 0 = normal )。
`stretch`	`50`	stretch 値を指定します ( 既定値 50 = normal )。

戻り値

実際に登録された family 名 ( ThorVG embedded 優先 )。

解説

Elements 用フォントの登録

Elements ダイアログで使用するフォントを krkrz Storages 経由で登録します。ThorVG がファイルから読み取った embedded family 名 ( 取れなかった場合は空文字 ) を戻り値として返します。スクリプトはこの戻り値を見て theme への組込みやログ表示に利用できます。

weight / slant / stretch は font_constants の整数値です ( 詳細は StoragesResourceLoader.h を参照 )。

関連: ElementsDialog.registerFontDir

registerFontDir¶

メソッド

引数

引数	既定値	説明
`dir`	` `	登録対象ディレクトリの Storages パスを指定します。

戻り値

登録できたフォントの本数が返ります。0 = 1 本も登録できていない ( ディレクトリが無い / フォントが無い )。例外にはならず、代わりに警告ログを出します。

解説

Elements 用フォントの一括登録

指定ディレクトリ配下の .ttf / .otf を全て列挙して登録します ( ファイル名から family / weight / slant / stretch を推定 )。dir は Storages 経由のパス指定で、相対パス ( "font/" ) も System.exePath + "data/font/" のような正規化済みパスも使えます。XP3 内のディレクトリを指すときは "data.xp3>font/" のようにアーカイブを明示してください ( addAutoPath でマウントしただけではディレクトリ列挙はできません )。 OS のパス ( "D:/foo/font/" ) をそのまま渡すと 0 本になります。

関連: ElementsDialog.registerFont

registerHotKey¶

メソッド

引数

引数	既定値	説明
`key`	` `	仮想キーコード ( VK_ESCAPE 等 )。キーのほか、パッドボタン ( VK_PAD1 〜 VK_PAD12 等 ) とマウスボタン ( VK_LBUTTON / VK_RBUTTON / VK_MBUTTON / VK_XBUTTON1 / VK_XBUTTON2 ) も同じ空間で指定できます。印字キーの登録は非推奨です ( onKeyPress の文字イベントまでは抑止されません )。
`shift`	`0`	修飾キーの組合せ ( ssShift \| ssAlt \| ssCtrl、既定 0 )。キー down は完全一致で判定し、up はキーのみの一致で対にバイパスします。
`duringTextInput`	`false`	真にすると、ダイアログ内のテキスト入力ウィジェット ( input_box 等 ) にキャレットがある間も有効になります。既定の偽ではテキスト入力中は抑止され、ESC / BackSpace 等を入力欄から奪いません。

戻り値

戻り値はありません。同じ ( key, shift ) の再登録は duringTextInput の上書きになります。

解説

ホストホットキーの登録

「ダイアログにフォーカスを渡しつつ、特定のキーだけは必ずホスト側で受けたい」ためのバイパス機構です。登録したキーはダイアログへ渡らず、そのまま通常のゲーム入力経路 ( Window.onKeyDown / Window.onMouseDown 等 ) へ届きます ( 専用イベントはありません )。

入力の配送優先順位は次の一列です。

モーダルダイアログ ( 全入力を独占。ホットキーより優先 )
ホストホットキー ( ダイアログをバイパスしてホストへ )
フォーカスを持つ非モーダルパネル ( 未処理キーのみ素通し )
ゲーム / レイヤ

ESC でのシーン復帰や PageUp/Down での画面切替を、slider 等を含む操作パネル ( showJson(json, true, false) ) の表示中でも確実に効かせる用途を想定しています。

unregisterHotKey¶

メソッド

引数

引数	既定値	説明
`key`	` `	仮想キーコードを指定します。
`shift`	`0`	修飾キーの組合せ ( 既定 0 )。

解説

ホストホットキーの解除

registerHotKey で登録したホットキーを解除します ( key と shift の両方が一致するエントリを削除 )。

関連: ElementsDialog.registerHotKey

clearHotKeys¶

メソッド

解説

ホストホットキーの全解除

registerHotKey で登録したホットキーを全て解除します。

関連: ElementsDialog.registerHotKey

registerImage¶

メソッド

引数

引数	既定値	説明
`name`	` `	ストア上の名前 ( `mem://<name>` で参照 )。
`path`	` `	登録する画像の統一ストレージパス。

戻り値

読込・登録に成功したかどうか。

解説

実行時画像を登録する

統一ストレージパス path のファイルを name で実行時画像ストアへ登録します。jsonc の image ウィジェット等からは "mem://<name>" で参照します。セーブサムネイル等、実行時に変わる画像を Elements へ渡すための仕組みです。表示中の画面に mem://<name> の image ウィジェットがあれば、再登録した時点で再デコードされ即時反映されます ( 画面の開き直しは不要。パネルにも反映されます )。登録前に build したウィジェットは空表示のままなので、初回は画面を開く前に登録してください。

unregisterImage¶

メソッド

引数

引数	既定値	説明
`name`	` `	削除する画像の名前。

解説

実行時画像を削除する

registerImage で登録した name を実行時画像ストアから削除します。

clearImages¶

メソッド

解説

実行時画像をすべて消去する

実行時画像ストアを全消去します。

setSharedVar¶

メソッド

引数

引数	既定値	説明
`name`	` `	変数名。
`value`	` `	設定する値 ( 文字列 )。

解説

セッション共有変数を書き換える

画面 JSON の "shared_vars" が宣言した「画面をまたいで保つ変数」を書き換えます。変数 store は画面ごとに作り直されますが、"shared_vars" のパターン ( 完全一致、または末尾 * の前方一致 ) に一致する変数はセッション共有ストアと双方向になり、次に開く画面へ引き継がれます。画面が未構築でも書けます。

どの値を持ち回るかは画面側が決めるのでホスト実装は不要ですが、ゲームのセーブデータへ落とす / ロード後に流し込むときにこのメソッドを使います。

getSharedVars¶

メソッド

戻り値

変数名 => 値の辞書配列。

解説

セッション共有変数をすべて取得する

セッション共有変数の現在値を辞書配列 ( 変数名 => 値 ) で返します。セーブデータへ書き出す用途を想定しています。値は文字列です。

共有側へ出るのは「変化として書かれた」値だけで、ウィジェットの初期値 ( "initial" / "value" ) は出ません。「誰も触っていない項目」が最初に開いた画面の既定で固定されるのを避けるためです。

clearSharedVars¶

メソッド

解説

セッション共有変数をすべて捨てる

セッション共有ストアを空にします。タイトルへ戻るとき、セーブデータをロードする直前などに呼びます。

setAtlasImage¶

メソッド

引数

引数	既定値	説明
`name`	` `	画面 JSON で宣言したアトラス名。
`path`	` `	差し替える画像のパス ( 画面の `resource_base` 起点 )。

戻り値

差し替えられたかどうか ( 未宣言 / 読込失敗なら false。表示は変わりません )。

解説

差し替え可能アトラスの絵を差し替える

画面 JSON の "atlases" で "swappable": true と宣言したアトラスの画像を、実行時に別の 1 枚へ差し替えます。ウィジェットは作り直さないので、レイアウトもフォーカスもそのまま保たれます。CG 鑑賞のグループタブのように「同じ画面・違う絵の束」を切り替える用途向けです。

差し替え先は同じ矩形割りである必要があります。ウィジェットが持つ frames / rect は変わらないので、絵の位置がずれると別の絵が出ます。

swappableAtlases¶

メソッド

戻り値

アトラス名の配列。

解説

差し替え可能なアトラス名の一覧を取得する

いま setAtlasImage で差し替えられるアトラス名を配列で返します。検証パネルや REPL からの確認用です。

setVar¶

メソッド

引数

引数	既定値	説明
`name`	` `	変数名。
`value`	` `	設定する値 ( 文字列 )。

戻り値

書き込めたかどうか。

解説

表示中ダイアログの変数を書き換える

表示中ダイアログの変数 store へ値を書き込みます。JSON で "text_var": name を指定した label 等が次フレームで更新されます。自分のインスタンスが非アクティブなら false を返します。

getVar¶

メソッド

引数

引数	既定値	説明
`name`	` `	変数名。

戻り値

変数の値 ( 文字列 )。未知の変数なら void。

解説

表示中ダイアログの変数を読み出す

表示中ダイアログの変数 store から値を読み出します。setVar で書いた値だけでなく、画面側が書いた値 ( "vars_on_hover" / "vars_on_focus" / slider の "value_var" / "drag_at_var" / 一覧の "index_offset_var" 等 ) も同じ store から読めます。

未知の変数名、または自分のインスタンスが非アクティブなら void を返します ( 空文字列と区別できます )。変化した時点で知りたい場合は onVar を実装します。

listVars¶

メソッド

戻り値

変数記述 Dictionary の配列。非アクティブなら空配列。

解説

表示中ダイアログの変数一覧を取得する

表示中ダイアログが使っている変数を名前順の配列で返します。要素は name / value / usedBy を持つ Dictionary で、usedBy は id ( いちばん近い祖先の widget id ) と kind ( 参照している JSON のキー。"text_var" / "visible_var" / "value_var" 等 ) を持つ Dictionary の配列です。

参照だけあって一度も書かれていない変数、逆に参照は無いが setVar で作った変数も載ります。デバッグパネルや画面 JSON の検証に使います。

focus¶

メソッド

引数

引数	既定値	説明
`id`	` `	フォーカスを移す widget の id。

戻り値

依頼できたかどうか。非アクティブなら false。

解説

指定 id の widget へフォーカスを移す

表示中ダイアログの widget ( JSON の "id" で指定 ) へフォーカスを移します。input_box は編集フォーカス ( キャレット表示 + テキスト受理 ) になります。at_var の park / unpark などで画面を組み替えた後に、入力先を明示的に移す用途を想定しています。

戻り値は「インスタンスへフォーカス移動を依頼できたか」で、id の存在確認はしません。自分のインスタンスが非アクティブなら false を返します。

activate¶

メソッド

引数

引数	既定値	説明
`id`	` `	実行する widget の id。

戻り値

実行できたかどうか。id 不明 / 非アクティブなら false。

解説

指定 id の widget を実行する

表示中ダイアログの widget ( JSON の "id" で指定 ) へフォーカスを移して実行 ( Enter 相当 ) します。Agent.dialogClick のインスタンス版で、ElementsPanel.activate と同形です。

関連: ElementsDialog.focus

trimAtlasCache¶

メソッド

引数

引数	既定値	説明
`budget`	` `	切り詰める上限 ( バイト )。0 / 省略で使われていない分を全解放。

戻り値

解放できたバイト数。

解説

アトラスのデコードキャッシュを切り詰める

アトラスのデコードキャッシュを budget バイトまで切り詰めます。 0 ( 既定 ) を渡すと「使われていないものを全部」手放します。戻り値は解放できたバイト数です。

⚠ 表示中の画面が使っているアトラスは参照が残っているので捨てられません。 場面の切れ目 ( 画面を閉じた後 ) に呼んでください。

dlg.close();
var freed = global.ElementsDialog.trimAtlasCache();   // 使っていない分を全部

予算そのものは変わりません ( 一時的な切り詰め )。恒久的に下げたい場合は atlasCacheBudget へ代入します。

関連: ElementsDialog.atlasCacheStats

setPadIconBase¶

メソッド

引数

引数	既定値	説明
`dir`	` `	pad_icon 素材のベースディレクトリ ( 統一ストレージパス )。

解説

pad_icon のベースディレクトリを設定する

pad_icon ( Kenney input prompts ) のベースディレクトリを設定します。dir は統一ストレージパス ( XP3 内でも可 )。配下に xbox/ps/switch/keyboard の各ディレクトリ + vector/*.svg がある構成を想定します。未設定のままだと pad_icon は灰色プレースホルダになります。

setPadTheme¶

メソッド

引数

引数	既定値	説明
`name`	` `	テーマ名。

戻り値

名前を解釈できたかどうか。

解説

pad_icon の全体テーマを設定する

pad_icon の全体テーマ ( "xbox" / "ps" / "switch" / "keyboard" / "none" ) を設定します。"auto" を指定すると、接続しているパッドの系統 ( System.padStyle ) からテーマを自動選択します。系統が判定できないプラットフォーム ( Windows など ) では、パッドが 1 つでもつながっていれば "xbox"、1 つも無ければ "keyboard" になります ( パッドが無い状態で pad の絵を出しても、押せるキーが判らないためです )。

"auto" の判定はパッドの接続数と系統を見張っていて、変化したその場で決め直します。コントローラを抜き差ししても画面を開き直す必要はなく、表示中の画面の pad_icon も次の描画で新しいテーマの絵に差し替わります。画面 JSON の top-level "pad_theme" が指定されていればそちらが優先されます。

関連: ElementsDialog.setPadIconAlias

setPadIconAlias¶

メソッド

引数

引数	既定値	説明
`theme`	` `	対象のテーマ名 ( `"xbox"` / `"ps"` / `"switch"` / `"keyboard"` )。
`name`	` `	上書きする論理名。空文字ならそのテーマの上書きを全解除。
`basename`	` `	割り当てる素材の basename。空文字 / 省略でその名前の上書きを解除。

戻り値

テーマ名を解釈できたかどうか。

解説

pad_icon の名前解決をテーマ単位で上書きする

pad_icon の論理名 ( "a" / "b" / "dpad" など ) から実際の素材ファイル名 ( Kenney pack の basename ) への対応表を、テーマ単位で上書きします。既定表 ( "a" = Enter / "b" = Esc / "dpad" = 矢印 … ) がタイトルの実際のキー割り当てと違うときに使います。

// キャンセルが Esc ではなく BackSpace のタイトル
global.ElementsDialog.setPadIconAlias("keyboard", "b", "keyboard_backspace");

上書きは既定表より優先されます。basename に空文字を渡すとその名前の上書きだけを解除、name に空文字を渡すとそのテーマの上書きを全解除します。いずれも表示中の画面へ次の描画から反映されます。

関連: ElementsDialog.setPadTheme

renderStatsReset¶

メソッド

解説

描画計測カウンタのリセット

ElementsDialog.renderStats の累積カウンタを 0 クリアします。計測区間の開始時に呼びます。

onScreen¶

イベント

引数

引数	既定値	説明
`name`	` `	入った画面の名前 ( マニフェストの画面キー ) 。

解説

フロー画面遷移通知 ( 画面に入った )

showFlow / startFlow 系で実行しているフローの画面に入ったタイミングで発火します。TJS 側で override してください。

関連: ElementsDialog.onScreenLeave

onScreenLeave¶

イベント

引数

引数	既定値	説明
`name`	` `	出た画面の名前 ( マニフェストの画面キー ) 。
`action`	` `	画面を離れる契機となった button の id ( Esc / × は空文字列 ) 。

解説

フロー画面遷移通知 ( 画面から出た )

showFlow / startFlow 系で実行しているフローの画面から離れるタイミングで発火します。TJS 側で override してください。

関連: ElementsDialog.onScreen

onAction¶

イベント

引数

引数	既定値	説明
`id`	` `	発生元 widget の id 文字列。
`payload`	` `	widget が伴って渡す値 ( 上記参照 )。

解説

ダイアログ上の操作通知

ダイアログ上で発生したアクション ( button click や state widget の値変化 ) を受け取るイベントです。TJS 側で override してください。

非モーダル ( showJson / showFile ) では表示中ずっと発火します。モーダル ( showModalJson / showModalFile ) でも、"close_on_click": true で閉じる前に発生したアクションは順次このイベントに通知されます。

payload の内容は widget の種類によって変わります。

button click ... void
checkbox / toggle ... bool ( 変更後の値 )
input_box ... string ( 編集後のテキスト )
slider 等 ... 各 widget が渡す値

onDrag¶

イベント

引数

引数	既定値	説明
`payload`	` `	ドラッグ状態を表す Dictionary ( 上記参照 )。

解説

ドラッグ通知

画面 JSON で "drag_events": true を指定した widget の押下 → 移動 → 離すが届くイベントです。TJS 側で override してください。

payload は Dictionary で、id ( 発生元 widget の id )、phase ( "begin" / "move" / "end" )、x / y ( 現在位置 )、dx / dy ( 前回からの差分 )、startX / startY ( 押下位置 )、modifiers ( シフト状態 ) を持ちます。座標は画面 JSON に書いた座標系です。

溜まった "move" は最新の 1 件へ畳まれます ( "begin" / "end" は畳まれません )。

絵をドラッグに追従させるだけならこのイベントは不要です。widget に "drag_at_var" を書いてドラッグ位置を変数へ出し、canvas 子の "at_var" へ同じ変数を挿すとエンジン内で完結します ( "drag_bounds" で可動域も制限できます )。このイベントは「どこで離したか」のような判断を TJS 側で行う用途に使います。

onVar¶

イベント

引数

引数	既定値	説明
`name`	` `	変化した変数名。
`value`	` `	変化後の値 ( 文字列 )。

解説

変数変化通知

表示中ダイアログの変数 store の値が変わったときに届くイベントです。 TJS 側で override してください。setVar による自分の書き込みだけでなく、画面側が書いた値 ( "vars_on_hover" / "vars_on_focus" / slider の "value_var" / "drag_at_var" / 一覧の "index_offset_var" 等 ) でも発火します。

「絵はホスト側のレイヤ、当たり判定だけダイアログ」という構成で、hover や選択の変化をホスト処理へ繋ぐのに使います ( 大きすぎて atlas に積めない一枚絵を並べる一覧など )。

通知は 1 フレーム遅延し、同じ変数の連続変化 ( hover 移動やドラッグ中の座標書き込み ) は最新の 1 件へ畳まれます。「いまの値」が必要なときは通知を待たず getVar で読んでください。

このイベントを実装したダイアログだけが観測対象になります。実装していないダイアログには一切コストがかかりません。受け取る変数を絞りたい場合は watchVars を使います。

onClose¶

イベント

引数

引数	既定値	説明
`action`	` `	閉じる契機となった button の id ( `close_on_click` / Esc で閉じた場合。 close 等で明示的に閉じた場合は空文字列 )。

解説

ダイアログ teardown 完了通知

このインスタンスのダイアログが閉じ切った ( teardown 完了 ) タイミングで発火する非ブロッキング経路のイベントです。TJS 側で override してください。

引数	既定値	説明
`json`	` `	JSON / JSONC 形式のレイアウト定義文字列を指定します。
`grabFocus`	`true`	キーボードフォーカスを取得するかどうか ( 既定 true )。 true のときはパネルがキーボードフォーカスを取得し、input_box 等への文字入力やウィジェットのキー / パッド操作ができます。 false のときはフォーカスを取らず、キー入力はホスト ( Window ) へ通ります。表示専用の常駐 HUD 的なパネルに指定します。この場合パネル内の input_box 等への文字入力はできません。マウス操作は grabFocus に関わらず有効です。
`modal`	`grabFocus`	モーダル ( 入力独占 ) にするかどうか。省略時は後方互換で grabFocus と同じ値になります。 `showJson(json, true, false)` = 「非モーダル + フォーカスあり」の中間状態で、キー / パッドはパネルへ届いてウィジェットを操作でき ( パッドの十字 = フォーカスナビ / A = 決定 )、パネルが処理しなかったキーだけがホスト ( Window.onKeyDown ) へ素通しされます。操作パネル用途はこの指定を推奨します。ホストが必ず受けたいキーは registerHotKey で確保してください。用途 3 態: モーダルダイアログ `showJson(json)` / 操作パネル `showJson(json, true, false)` / 表示専用 HUD `showJson(json, false)`。

引数	既定値	説明
`path`	` `	JSON / JSONC ファイルのパスを指定します。
`grabFocus`	`true`	キーボードフォーカスを取得するかどうか ( 既定 true )。詳細は showJson を参照。
`modal`	`grabFocus`	モーダルにするかどうか ( 省略時は grabFocus に追従 )。詳細は showJson を参照。

引数	既定値	説明
`dict`	` `	レイアウト定義の Dictionary を指定します。
`grabFocus`	`true`	キーボードフォーカスを取得するかどうか ( 既定 true )。詳細は showJson を参照。
`modal`	`grabFocus`	モーダルにするかどうか ( 省略時は grabFocus に追従 )。詳細は showJson を参照。

引数	既定値	説明
`json`	` `	JSON / JSONC 形式のレイアウト定義文字列を指定します。
`title`	`""`	独立ウィンドウのタイトルを指定します ( 省略するとオーバーレイモードに切替わります )。
`width`	`800`	独立ウィンドウの幅をピクセル単位で指定します ( 既定値 800 )。
`height`	`600`	独立ウィンドウの高さをピクセル単位で指定します ( 既定値 600 )。

引数	既定値	説明
`path`	` `	JSON / JSONC ファイルのパスを指定します。
`title`	`""`	独立ウィンドウのタイトルを指定します ( 省略するとオーバーレイモードに切替わります )。
`width`	`800`	独立ウィンドウの幅をピクセル単位で指定します ( 既定値 800 )。
`height`	`600`	独立ウィンドウの高さをピクセル単位で指定します ( 既定値 600 )。

引数	既定値	説明
`dict`	` `	レイアウト定義の Dictionary を指定します。
`title`	`""`	独立ウィンドウのタイトルを指定します ( 省略するとオーバーレイモードに切替わります )。
`width`	`800`	独立ウィンドウの幅をピクセル単位で指定します ( 既定値 800 )。
`height`	`600`	独立ウィンドウの高さをピクセル単位で指定します ( 既定値 600 )。

引数	既定値	説明
`screensDict`	` `	画面名 ( 文字列 ) をレイアウト定義 ( JSON 文字列、または Dictionary / Array ) にマップする Dictionary。両形式の混在も可能です。
`entry`	` `	起点画面名 ( screensDict のキー ) を指定します。

引数	既定値	説明
`manifestPath`	` `	app.jsonc マニフェストの Storages パスを指定します。
`grabFocus`	`true`	真でキーボード / ゲームパッドフォーカスを取ります ( 既定値真 )。偽を指定するとフォーカスを取らない常駐 HUD として表示されます。

引数	既定値	説明
`screensDict`	` `	画面名 ( 文字列 ) を JSON 文字列にマップする Dictionary。
`entry`	` `	起点画面名 ( screensDict のキー ) を指定します。
`grabFocus`	`true`	真でキーボード / ゲームパッドフォーカスを取ります ( 既定値真 )。偽を指定するとフォーカスを取らない常駐 HUD として表示されます。

引数	既定値	説明
`family`	` `	登録時に使うファミリ名を指定します。
`path`	` `	フォントファイル ( .ttf / .otf ) の Storages パスを指定します。
`weight`	`40`	weight 値を指定します ( 既定値 40 = normal )。
`slant`	`0`	slant 値を指定します ( 既定値 0 = normal )。
`stretch`	`50`	stretch 値を指定します ( 既定値 50 = normal )。

引数	既定値	説明
`json`	` `	JSON / JSONC 形式のレイアウト定義文字列を指定します。
`grabFocus`	`true`	キーボードフォーカスを取得するかどうか ( 既定 true )。 true のときはパネルがキーボードフォーカスを取得し、input_box 等への文字入力やウィジェットのキー / パッド操作ができます。 false のときはフォーカスを取らず、キー入力はホスト ( Window ) へ通ります。表示専用の常駐 HUD 的なパネルに指定します。この場合パネル内の input_box 等への文字入力はできません。マウス操作は grabFocus に関わらず有効です。
`modal`	`grabFocus`	モーダル ( 入力独占 ) にするかどうか。省略時は後方互換で grabFocus と同じ値になります。 `showJson(json, true, false)` = 「非モーダル + フォーカスあり」の中間状態で、キー / パッドはパネルへ届いてウィジェットを操作でき ( パッドの十字 = フォーカスナビ / A = 決定 )、パネルが処理しなかったキーだけがホスト ( Window.onKeyDown ) へ素通しされます。操作パネル用途はこの指定を推奨します。ホストが必ず受けたいキーは registerHotKey で確保してください。用途 3 態: モーダルダイアログ `showJson(json)` / 操作パネル `showJson(json, true, false)` / 表示専用 HUD `showJson(json, false)`。

引数	既定値	説明
`path`	` `	JSON / JSONC ファイルのパスを指定します。
`grabFocus`	`true`	キーボードフォーカスを取得するかどうか ( 既定 true )。詳細は showJson を参照。
`modal`	`grabFocus`	モーダルにするかどうか ( 省略時は grabFocus に追従 )。詳細は showJson を参照。

引数	既定値	説明
`dict`	` `	レイアウト定義の Dictionary を指定します。
`grabFocus`	`true`	キーボードフォーカスを取得するかどうか ( 既定 true )。詳細は showJson を参照。
`modal`	`grabFocus`	モーダルにするかどうか ( 省略時は grabFocus に追従 )。詳細は showJson を参照。

引数	既定値	説明
`json`	` `	JSON / JSONC 形式のレイアウト定義文字列を指定します。
`title`	`""`	独立ウィンドウのタイトルを指定します ( 省略するとオーバーレイモードに切替わります )。
`width`	`800`	独立ウィンドウの幅をピクセル単位で指定します ( 既定値 800 )。
`height`	`600`	独立ウィンドウの高さをピクセル単位で指定します ( 既定値 600 )。

引数	既定値	説明
`path`	` `	JSON / JSONC ファイルのパスを指定します。
`title`	`""`	独立ウィンドウのタイトルを指定します ( 省略するとオーバーレイモードに切替わります )。
`width`	`800`	独立ウィンドウの幅をピクセル単位で指定します ( 既定値 800 )。
`height`	`600`	独立ウィンドウの高さをピクセル単位で指定します ( 既定値 600 )。

引数	既定値	説明
`dict`	` `	レイアウト定義の Dictionary を指定します。
`title`	`""`	独立ウィンドウのタイトルを指定します ( 省略するとオーバーレイモードに切替わります )。
`width`	`800`	独立ウィンドウの幅をピクセル単位で指定します ( 既定値 800 )。
`height`	`600`	独立ウィンドウの高さをピクセル単位で指定します ( 既定値 600 )。

引数	既定値	説明
`screensDict`	` `	画面名 ( 文字列 ) をレイアウト定義 ( JSON 文字列、または Dictionary / Array ) にマップする Dictionary。両形式の混在も可能です。
`entry`	` `	起点画面名 ( screensDict のキー ) を指定します。

引数	既定値	説明
`manifestPath`	` `	app.jsonc マニフェストの Storages パスを指定します。
`grabFocus`	`true`	真でキーボード / ゲームパッドフォーカスを取ります ( 既定値真 )。偽を指定するとフォーカスを取らない常駐 HUD として表示されます。

引数	既定値	説明
`screensDict`	` `	画面名 ( 文字列 ) を JSON 文字列にマップする Dictionary。
`entry`	` `	起点画面名 ( screensDict のキー ) を指定します。
`grabFocus`	`true`	真でキーボード / ゲームパッドフォーカスを取ります ( 既定値真 )。偽を指定するとフォーカスを取らない常駐 HUD として表示されます。

引数	既定値	説明
`family`	` `	登録時に使うファミリ名を指定します。
`path`	` `	フォントファイル ( .ttf / .otf ) の Storages パスを指定します。
`weight`	`40`	weight 値を指定します ( 既定値 40 = normal )。
`slant`	`0`	slant 値を指定します ( 既定値 0 = normal )。
`stretch`	`50`	stretch 値を指定します ( 既定値 50 = normal )。

ElementsDialog¶

メンバー一覧¶

コンストラクタ¶

プロパティ¶

メソッド¶

イベント¶

ElementsDialog¶

defaultFontFamily¶

active¶

modalActive¶

atlasCacheStats¶

atlasCacheBudget¶

watchVars¶

language¶

fontLanguages¶

virtualKeyboard¶

hasPhysicalKeyboard¶

focusRing¶

baseSize¶

renderScale¶

renderCache¶

partialRedraw¶

renderCount¶

renderStats¶

showJson¶

showFile¶

showDict¶

showModalJson¶

showModalFile¶

showModalDict¶

dictToJson¶

showFlow¶

showFlowScreens¶

startFlow¶

startFlowScreens¶

close¶

registerFont¶

registerFontDir¶

registerHotKey¶

unregisterHotKey¶

clearHotKeys¶

registerImage¶

unregisterImage¶

clearImages¶

setSharedVar¶

getSharedVars¶

clearSharedVars¶

setAtlasImage¶

swappableAtlases¶

setVar¶

getVar¶

listVars¶

focus¶

activate¶

trimAtlasCache¶

setPadIconBase¶

setPadTheme¶

setPadIconAlias¶

renderStatsReset¶

onScreen¶

onScreenLeave¶

onAction¶

onDrag¶

onVar¶

onClose¶

引数	既定値	説明
`json`	` `	JSON / JSONC 形式のレイアウト定義文字列を指定します。
`grabFocus`	`true`	キーボードフォーカスを取得するかどうか ( 既定 true )。 true のときはパネルがキーボードフォーカスを取得し、input_box 等への文字入力やウィジェットのキー / パッド操作ができます。 false のときはフォーカスを取らず、キー入力はホスト ( Window ) へ通ります。表示専用の常駐 HUD 的なパネルに指定します。この場合パネル内の input_box 等への文字入力はできません。マウス操作は grabFocus に関わらず有効です。
`modal`	`grabFocus`	モーダル ( 入力独占 ) にするかどうか。省略時は後方互換で grabFocus と同じ値になります。 `showJson(json, true, false)` = 「非モーダル + フォーカスあり」の中間状態で、キー / パッドはパネルへ届いてウィジェットを操作でき ( パッドの十字 = フォーカスナビ / A = 決定 )、パネルが処理しなかったキーだけがホスト ( Window.onKeyDown ) へ素通しされます。操作パネル用途はこの指定を推奨します。ホストが必ず受けたいキーは registerHotKey で確保してください。用途 3 態: モーダルダイアログ `showJson(json)` / 操作パネル `showJson(json, true, false)` / 表示専用 HUD `showJson(json, false)`。

引数	既定値	説明
`path`	` `	JSON / JSONC ファイルのパスを指定します。
`grabFocus`	`true`	キーボードフォーカスを取得するかどうか ( 既定 true )。詳細は showJson を参照。
`modal`	`grabFocus`	モーダルにするかどうか ( 省略時は grabFocus に追従 )。詳細は showJson を参照。

引数	既定値	説明
`dict`	` `	レイアウト定義の Dictionary を指定します。
`grabFocus`	`true`	キーボードフォーカスを取得するかどうか ( 既定 true )。詳細は showJson を参照。
`modal`	`grabFocus`	モーダルにするかどうか ( 省略時は grabFocus に追従 )。詳細は showJson を参照。

引数	既定値	説明
`json`	` `	JSON / JSONC 形式のレイアウト定義文字列を指定します。
`title`	`""`	独立ウィンドウのタイトルを指定します ( 省略するとオーバーレイモードに切替わります )。
`width`	`800`	独立ウィンドウの幅をピクセル単位で指定します ( 既定値 800 )。
`height`	`600`	独立ウィンドウの高さをピクセル単位で指定します ( 既定値 600 )。

引数	既定値	説明
`path`	` `	JSON / JSONC ファイルのパスを指定します。
`title`	`""`	独立ウィンドウのタイトルを指定します ( 省略するとオーバーレイモードに切替わります )。
`width`	`800`	独立ウィンドウの幅をピクセル単位で指定します ( 既定値 800 )。
`height`	`600`	独立ウィンドウの高さをピクセル単位で指定します ( 既定値 600 )。

引数	既定値	説明
`dict`	` `	レイアウト定義の Dictionary を指定します。
`title`	`""`	独立ウィンドウのタイトルを指定します ( 省略するとオーバーレイモードに切替わります )。
`width`	`800`	独立ウィンドウの幅をピクセル単位で指定します ( 既定値 800 )。
`height`	`600`	独立ウィンドウの高さをピクセル単位で指定します ( 既定値 600 )。

引数	既定値	説明
`screensDict`	` `	画面名 ( 文字列 ) をレイアウト定義 ( JSON 文字列、または Dictionary / Array ) にマップする Dictionary。両形式の混在も可能です。
`entry`	` `	起点画面名 ( screensDict のキー ) を指定します。

引数	既定値	説明
`manifestPath`	` `	app.jsonc マニフェストの Storages パスを指定します。
`grabFocus`	`true`	真でキーボード / ゲームパッドフォーカスを取ります ( 既定値真 )。偽を指定するとフォーカスを取らない常駐 HUD として表示されます。

引数	既定値	説明
`screensDict`	` `	画面名 ( 文字列 ) を JSON 文字列にマップする Dictionary。
`entry`	` `	起点画面名 ( screensDict のキー ) を指定します。
`grabFocus`	`true`	真でキーボード / ゲームパッドフォーカスを取ります ( 既定値真 )。偽を指定するとフォーカスを取らない常駐 HUD として表示されます。

引数	既定値	説明
`family`	` `	登録時に使うファミリ名を指定します。
`path`	` `	フォントファイル ( .ttf / .otf ) の Storages パスを指定します。
`weight`	`40`	weight 値を指定します ( 既定値 40 = normal )。
`slant`	`0`	slant 値を指定します ( 既定値 0 = normal )。
`stretch`	`50`	stretch 値を指定します ( 既定値 50 = normal )。