オーバーレイ

Sparkは、Ren’Pyゲームウィンドウの上に表示される包括的なオーバーレイシステムを提供し、ゲームを離れることなくコントロールにすばやくアクセスできます。

オーバーレイシステムはいくつかのコンポーネントで構成されています：

• ゲームオーバーレイ — 設定、音量、ツールを備えたメインコントロールパネル
• クイックメニュー — 一般的なアクション用のコンパクトなフローティングメニュー
• オンスクリーンキーボードヘルパー — キーボードを呼び出すボタン
• UI非表示ボタン — オーバーレイの表示/非表示を切り替え

メインオーバーレイにはオーバーレイボタン（円形のSparkアイコン）をタップしてアクセスします。また、クイックメニューバーのメニューボタンを長押ししてオーバーレイを開くこともできます — これはプライマリオーバーレイボタンが無効または非表示の場合に便利です。

• 音量スライダー — マスターボリュームをリアルタイムで調整
• 進捗インジケーター — ダイアログの完了率を表示
• 変数エディタ — ゲーム変数の検査と変更
• ギャラリーアンロッカー — すべてのギャラリー/CGコンテンツをアンロック
• デバイスバリアント切替 — 画面レイアウトバリアントの変更
• 設定パネル — 外観、書式設定、ゲーム設定
• 言語切替 — Ren’Pyの内蔵言語を変更
• 翻訳設定 — リアルタイム翻訳の設定
• ゲームを閉じる — 現在のゲームを安全に終了

メインオーバーレイボタンはカスタマイズ可能です：

• 位置：ドラッグして再配置
• 不透明度：設定で調整（デフォルト：40%）
• 色：カスタムハイライトカラーを設定

ギャラリーアンロッカーは、ゲーム内のすべての写真、シーン、コンテンツをアンロックするためのSparkオーバーレイのツールです。有効にすると、すべてのギャラリーアイテムを閲覧済みとしてマークし、完全なCGギャラリー、シーンリプレイ、その他のアンロック可能なコンテンツにアクセスできるようになります。

アンロッカーアイコンは有効時に緑色、無効時に白色で表示されます。有効時にタップするとオフに切り替わります。有効にする前に確認プロンプトが表示されます。

オーバーレイの言語切替では、ゲームのtlフォルダからアクティブな言語を変更できます。これはRen’Pyの組み込み翻訳の公式メソッドです — 開発者（またはコミュニティの翻訳者）が翻訳されたスクリプトを言語名の下のtl/ディレクトリに配置し、ゲームはランタイムでそれらを切り替えることができます。

このツールは以下の場合に便利です：

• ゲームに複数の言語が含まれているが、ゲーム内言語メニューが提供されていない場合
• ゲームにカスタムまたは非公式のコミュニティ翻訳がバンドルされている場合
• ゲーム自体のメニューを操作せずに、利用可能な翻訳をすばやく切り替えたい場合

一般的なアクションにすばやくアクセスできるコンパクトなフローティングメニュー：

• メニュー — タップしてRen’Pyのゲーム内メインメニューを開く。長押しでSparkオーバーレイを開く
• スキップ — テキストスキップの切り替え
• オート — テキスト自動送り
• 中央ボタン — 設定可能（キーボード、オートフォワード、UI非表示、または翻訳）
• 巻き戻し — ダイアログを1ステップ戻す。Turbo Rewindが有効な場合、ボタンを押し続けて連続的に巻き戻し

キーボードオーバーレイボタンはiOSキーボードを呼び出します。以下の場合に便利です：

• Ren’Pyコンソール入力
• 名前入力画面
• キーボードベースのゲームインタラクション

キーボードはRen’Pyでよく使用される特殊キーをサポートしています：

• Esc — ゲームメニューを開く / 戻る
• Ctrl — 押し続けてテキストをスキップ
• Alt — 一部のキーの組み合わせで使用
• Fn（ファンクションキー） — Fnボタンをオンにして（青色になります）、数字キー1〜9を押すとF1〜F9を送信、0でF10

すべてのオーバーレイ要素を非表示にできます：

• UI非表示ボタンを使用
• スワイプジェスチャー（設定済みの場合）
• メインオーバーレイでの切り替え

オーバーレイを完全に無効にするには、設定でEnable Overlaysをオフにしてください。

オーバーレイボタンが画面外にドラッグされてアクセスできなくなった場合、設定で位置をリセットできます。これにより、すべてのオーバーレイボタンがデフォルト位置に復元されます。