詳細ページは上級者向けのコンソールです。一般のユーザーに必要な機能には、ほかのページにそれぞれボタンがあります。ここでは、エンジンのコマンドライン の説明どおりに JoyPro のエンジンのコマンドを自分で入力し、答えは 出力 パネルに表示されます。


flowchart LR A["コマンド ボックス"] --> B["実行"] G["設定"] --> B P["--profile"] --> B B --> E["JoyPro のエンジン"] E --> O["出力パネル"] E -.-> R["リレーションと<br/>割り当てを更新"]
#このページは必要?
通常は不要です。次の 3 つの場合のためにあります:
- 誰か(Discord のヘルパーや Wiki)から、状況を確認するためにコマンド(例:
profile summary)を実行するよう頼まれたとき。 - 多くのリレーションや割り当てをテキスト エディターでまとめて変えたいとき:リレーションを編集 と 割り当てを編集。
- 開いているプロファイルの概要をすぐに見たいとき:プロファイルの概要。
#コマンドを実行する
- コマンド に、
engineという単語を付けずにコマンドを入力します。例:profile summaryやrelations list --game DCS。 - --profile を含める にはチェックを入れたままにします。これで、コマンドが開いているプロファイルに対して動きます。
- 実行 を押します。答えが下の 出力 パネルに表示されます(閉じている場合は、下部バーの 出力 を押します)。
ここで入力したコマンドは、ボタンとまったく同じようにプロファイルやゲームを変更できます。プロファイルの変更はすべて履歴(上部バー)のバージョンになるので、元に戻せます。ゲームのファイルはエクスポートの前にバックアップされます。
#各入力欄
| 入力欄 | 追加されるもの | エンジンのオプション |
|---|---|---|
| エディター コマンド | リレーションを編集 / 割り当てを編集(と手入力した relations edit / binds edit)で開くプログラムです。{file} が一時ファイルを表します。例:code --wait {file}。空欄の場合はメモ帳です。 |
--editor(グローバル) |
| 出力ファイル | 手入力したコマンドの回答を、出力パネルではなくこのファイルに書き込みます。ここで入力したコマンドだけが対象で、ほかのページのボタンは使いません。 | --out(グローバル) |
| テキスト出力 | オン(既定):読みやすいテキスト。オフ:スクリプトが読む形式の JSON。ここで入力したコマンドだけが対象です。 | --text(グローバル) |
| グローバル引数 | コマンドの前に置くそのほかのグローバルオプション。例:--status true。 |
グローバルオプション |
| コマンド | コマンドとそのオプション。スペースを含むパスは引用符で囲むと 1 つにまとまります。 | コマンド |
| --profile を含める | --profile "<open profile>" を追加します。プロファイルが不要なコマンド(db summary、games installs)ではチェックを外します。 |
--profile |
- ここで入力した
relations listとbinds listは、その回答でリレーション ページと割り当てページの一覧も更新します。 - 最後に実行したコマンドラインは、出力パネルの 1 行目にあります(
$ engine --profile ... profile summary)。これをコピーすれば、ターミナルで同じものを実行できます。 - リレーションを編集 は、すべてのリレーションを一時的な JSON ファイルに書き出してエディターで開き、エディターを閉じると読み込み直します。リレーション、割り当て、モディファイアの各ページが再読み込みされます。元に戻す 1 ステップ分です。
#ページの仕組み
ビューモデル:MainWindowViewModel.cs(RunCustomCommandAsync、RelationsEditAsync、BindsEditAsync、RunEngineSummaryAsync、RunProfileSummaryAsync)。引数は、GUI のすべてのボタンが使うのと同じメソッド RunEngineAsync で組み立てられます。入力したコマンドは TokenizeCli で分割され(引用符を考慮)、グローバル引数が先頭に来て、その後に --profile、--status、--benchmark、--history-note(GUI 自身の変更のみ)、--out、--editor、設定の読み込み補正オプション、--text が続きます。プロファイルを変更するコマンドはプロファイルのロックを取って実行され、ほかの変更と同じように履歴のバージョンを作ります。
エンジン:engine summary、engine profile summary、engine relations edit、engine binds edit、そして エンジンのコマンドライン のすべてのコマンド。リファレンス:GUI と CLI の対応(どのボタンがどのコマンドを実行するか)。
#参考資料
このページの元になった機能ドキュメント(リポジトリから生成):
#このページのすべての操作項目
プログラムのソースから読み取った 7 個のコントロール:説明済み 7、ソースの情報(ツールチップ、コード コメント、エンジン呼び出し)付き 0、今後拡充 0。
#--profile を含める
チェック ボックス説明済みオン: 入力したコマンドに --profile "<open profile>" が付くので、開いているプロファイルを読み取り・変更します。
プロファイルが不要なコマンドではチェックを外してください。
#実行
ボタン説明済み「コマンド」に入力したコマンドをエンジンで実行し、その応答を「出力」パネルに表示します。relations list と binds list は「リレーション」ページと「割り当て」ページも更新します。
プロファイルを変更するコマンドは 1 回の「元に戻す」で取り消せます。ゲームに書き込むコマンドは、ボタンと同じように、先にゲームのファイルをバックアップします。
#リレーションを編集
ボタン説明済みプロファイルのすべてのリレーションを 1 つの JSON ファイルとしてエディターで開きます。エディターを閉じると JoyPro がファイルを読み込み、「リレーション」「割り当て」「モディファイア」の各ページが再読み込みされます。
1 回の「元に戻す」で取り消せます。
#割り当てを編集
ボタン説明済みプロファイルのすべての割り当てを 1 つの JSON ファイルとしてエディターで開きます。エディターを閉じると内容が読み込まれ、ページが再読み込みされます。
1 回の「元に戻す」で取り消せます。