設定ファイルの仕様 (Configuration)

FJ Flow プロ版（fjFlow.ahk）では、設定はすべて構造化されたJSONファイルに保存されます。直接エディタで編集して再起動（リロード）することでも反映可能です。

設定ファイルの配置

設定ファイルは、実行スクリプトまたは実行ファイルと同じディレクトリに配置されます。

fjFlow.json: ツールの全般的な設定、インジケーターのデザイン、フォーカス強調、ハイライト/ズームなどのパラメータを管理します。
KeyExt.json: キー拡張機能のマッピング定義（L1 / L2 / Space Shift レイヤーごとの割り当て）を管理します。

fjFlow.json の構成とパラメータ一覧

{
  "IndicatorEnabled": true,          // 通常インジケータの有効/無効
  "IndicatorTextVal": "▼",          // 表示文字
  "IndicatorColor": "FF0000",        // 文字カラー (RGB16進数)
  "MacroIndicatorEnabled": true,     // マクロインジケータの有効/無効
  "MacroIndicatorText": "M",         // 表示文字
  "MacroIndicatorColor": "FF00FF",   // 文字カラー
  "ImeIndicatorEnabled": true,       // IMEオン連動の有効/無効
  "ImeIndicatorTextOn": "▼",
  "ImeIndicatorColorOn": "FF0000",
  "ShowImeIndicatorWhenOff": true,   // IMEオフ時の表示有無
  "ImeIndicatorTextOff": "◆",
  "ImeIndicatorColorOff": "00FF00",
  "CapsLockIndicatorEnabled": true,  // CapsLockオン時の表示有無
  "CapsLockIndicatorText": "A",
  "CapsLockIndicatorColor": "FF0000",
  "ShiftLockColor": "FF0000",        // シフトロック時のカラー
  "OffsetX": -15,                    // キャレットX座標からのオフセット (px)
  "OffsetY": -30,                    // キャレットY座標からのオフセット (px)
  "BlinkSpeed": 20,                  // インジケータ点滅(フェード)速度 (1-255)
  "FontSize": 14,                    // フォントサイズ (pt)
  "FontBold": true,                  // 太字ON/OFF
  "HighlightHotkey": "F8",           // 行ハイライト起動ショートカット
  "HighlightHeight": 80,             // ハイライトの高さ (px)
  "HighlightAlpha": 120,             // 周辺暗転マスクの不透明度 (0-255)
  "HighlightColor": "FFFFFF",        // ハイライト境界線の色
  "HighlightBorderSize": 1,          // ハイライト境界線の太さ (px)
  "ZoomHotkey": "F9",                // ズーム起動ショートカット
  "ZoomScale": 2.0,                  // ズーム倍率
  "ZoomHeight": 400,                 // ズーム窓の高さ (px)
  "ZoomBorderSize": 3,               // ズーム窓の枠線の太さ (px)
  "ZoomAlpha": 200,                  // ズーム窓全体の不透明度 (0-255)
  "ZoomBorderAlpha": 80,             // ズーム窓の枠線の不透明度 (0-255)
  "ZoomBorderColor": "008080",       // ズーム窓の枠線の色
  "ZoomFadeDelay": 1000,             // 入力停止後フェードアウトするまでのミリ秒
  "HideDuringInput": true,           // キー入力中にインジケータを隠すか
  "HideDelay": 1000,                 // 入力停止後インジケータを再表示するまでのミリ秒
  "FocusHighlightEnabled": true,     // ウィンドウ強調の有効/無効
  "FocusHighlightBorderEnabled": true,// 強調枠表示のON/OFF
  "FocusHighlightFillEnabled": true, // 窓内部塗りつぶしのON/OFF
  "FocusHighlightBorderSize": 3,     // 強調枠の太さ (px)
  "FocusHighlightBorderAlpha": 150,  // 強調枠の不透明度 (0-255)
  "FocusHighlightFillAlpha": 12,     // 内側塗りつぶしの不透明度 (0-255)
  "FocusHighlightColor": "FF0000",   // アクティブ時(IMEオン)の色
  "FocusHighlightColorOff": "00FF00",// 非アクティブ時(IMEオフ)の色
  "FocusHighlightBlink": true,       // 強調表示の点滅ON/OFF
  "FocusHighlightBlinkSpeed": 12,    // 点滅速度 (0-255)
  "FocusHighlightColorMode": 1,      // カラーモード (0: ユーザー指定, 1: CPU・メモリ連動)
  "ShiftLockText": "S",              // シフトロック中表示文字
  "UseOneShotShift": true,           // ワンショットシフト有効化
  "ShiftLockEnabled": true,          // シフトロック機能有効化
  "SwapCapsLockCtrl": false,         // CapsLockとCtrlの入れ替え (US配列限定)
  "CtrlLockText": "C",               // Ctrlロック中表示文字
  "CtrlLockColor": "00C0FF",         // Ctrlロック中カラー
  "AltLockText": "A",
  "AltLockColor": "FF8000",
  "WinLockText": "W",
  "WinLockColor": "00FF00",
  "KeyExtGuideEnabled": true,        // ガイド自動表示の有効/無効
  "KeyExtGuideDelay": 1000,          // ガイド自動表示までの時間 (ms)
  "KeyExtGuideBorderEnabled": true,
  "KeyExtGuideBorderSize": 2,
  "KeyExtGuideBorderAlpha": 200,
  "KeyExtGuideBorderColor": "0066FF",// ガイド枠線の色
  "KeyExtGuideFillEnabled": true,
  "KeyExtGuideBgColor": "1F2937",    // ガイド背景色
  "KeyExtGuideFillAlpha": 220,       // ガイド背景不透明度 (0-255)
  "KeyExtGuideFontSize": 11,
  "KeyExtGuideFontName": "Consolas",
  "KeyExtGuideKeyColor": "FFFFFF",   // ガイド内の入力キー名文字色
  "KeyExtGuideValColor": "38BDF8",   // ガイド内の通常送信値文字色
  "KeyExtGuideCmdColor": "F59E0B"    // ガイド内の特殊コマンド文字色
}

KeyExt.json の構成とパラメータ一覧

{
  "Enabled": 1,                      // キー拡張機能の有効/無効
  "L1Color": "0066FF",               // L1レイヤーのカラー
  "L1Text": "1",                     // L1レイヤー表示文字
  "L2Color": "E11D48",
  "L2Text": "2",
  "SSColor": "8B5CF6",
  "SSText": "Ⓢ",
  "Mappings": {
    "L1|h": { "value": "{Home}", "showGuide": false }, // 個別にガイドを非表示にする設定例
    "L1|j": "{PgDn}",                                  // 通常の単純マッピング設定例
    "SS|s": "{ShiftLock}",
    "SS|h": "{Left}"
  }
}

マッピング定義の構造

文字列形式 (単機能マッピング): "L1|j": "{PgDn}" のように、マッピング条件（レイヤー名と入力キーを | で結合）をキーとし、出力するキー名やマクロコマンドを直接文字列で指定します。
オブジェクト形式 (詳細マッピング): "L1|h": { "value": "{Home}", "showGuide": false } のように、値の他にガイド表示の有無を示す showGuide などのパラメータを持つことができます。設定GUIで「ガイド」チェックボックスを操作した際にこの構造で保存されます。

旧バージョン設定からの自動移行

以前のバージョンで .ini などの古いフォーマットの設定ファイルが同一フォルダに存在していた場合、FJ Flow は初回起動時にそれらを自動的に読み込みます。
読み込んだ値は、新しい構造化JSON形式（fjFlow.json / KeyExt.json）へと変換して保存されるため、既存の設定環境を引き継いで使用できます。