JoyPro2 Discord GitHub
GUI のページ

詳細

表示:

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

詳細コンソール詳細コンソール
詳細コンソール (画像は英語版のアプリを表示しています。)
flowchart LR
  A["コマンド ボックス"] --> B["実行"]
  G["設定"] --> B
  P["--profile"] --> B
  B --> E["JoyPro のエンジン"]
  E --> O["出力パネル"]
  E -.-> R["リレーションと<br/>割り当てを更新"]
実行がコマンド ボックス、設定(グローバル引数、エディター コマンド、出力ファイル、テキスト出力)、--profile を含める(開いているプロファイル)をどう使うか。エンジンはどのボタンの裏にあるものと同じです。出力パネルにはコマンドとその答えが表示されます。点線:リレーションや割り当てを一覧表示するコマンドの場合だけ。
初心者向け

#このページは必要?

通常は不要です。次の 3 つの場合のためにあります:

  • 誰か(Discord のヘルパーや Wiki)から、状況を確認するためにコマンド(例:profile summary)を実行するよう頼まれたとき。
  • 多くのリレーションや割り当てをテキスト エディターでまとめて変えたいとき:リレーションを編集 と 割り当てを編集。
  • 開いているプロファイルの概要をすぐに見たいとき:プロファイルの概要。

#コマンドを実行する

  1. コマンド に、engine という単語を付けずにコマンドを入力します。例:profile summary や relations list --game DCS。
  2. --profile を含める にはチェックを入れたままにします。これで、コマンドが開いているプロファイルに対して動きます。
  3. 実行 を押します。答えが下の 出力 パネルに表示されます(閉じている場合は、下部バーの 出力 を押します)。
注意

ここで入力したコマンドは、ボタンとまったく同じようにプロファイルやゲームを変更できます。プロファイルの変更はすべて履歴(上部バー)のバージョンになるので、元に戻せます。ゲームのファイルはエクスポートの前にバックアップされます。

詳細

#各入力欄

入力欄 追加されるもの エンジンのオプション
エディター コマンド リレーションを編集 / 割り当てを編集(と手入力した 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。

#テキスト出力

チェック ボックス説明済み

オン: ここで入力したコマンドは読みやすいテキストで応答します。

オフ: GUI やスクリプトが読み取る形式と同じ JSON で応答します。

詳細(英語)

#--profile を含める

チェック ボックス説明済み

オン: 入力したコマンドに --profile "<open profile>" が付くので、開いているプロファイルを読み取り・変更します。

プロファイルが不要なコマンドではチェックを外してください。

詳細(英語)

#実行

ボタン説明済み

「コマンド」に入力したコマンドをエンジンで実行し、その応答を「出力」パネルに表示します。relations list と binds list は「リレーション」ページと「割り当て」ページも更新します。

プロファイルを変更するコマンドは 1 回の「元に戻す」で取り消せます。ゲームに書き込むコマンドは、ボタンと同じように、先にゲームのファイルをバックアップします。

詳細(英語)

#リレーションを編集

ボタン説明済み

プロファイルのすべてのリレーションを 1 つの JSON ファイルとしてエディターで開きます。エディターを閉じると JoyPro がファイルを読み込み、「リレーション」「割り当て」「モディファイア」の各ページが再読み込みされます。

1 回の「元に戻す」で取り消せます。

詳細(英語)

#割り当てを編集

ボタン説明済み

プロファイルのすべての割り当てを 1 つの JSON ファイルとしてエディターで開きます。エディターを閉じると内容が読み込まれ、ページが再読み込みされます。

1 回の「元に戻す」で取り消せます。

詳細(英語)

#エンジンの概要

ボタン説明済み

エンジンが読み込んだプロファイルの relations=...、binds=...、modifiers=... を 1 行の件数として「出力」パネルに表示します。

何も変更しません。

詳細(英語)

#プロファイルの概要

ボタン説明済み

開いているプロファイルの件数と状態を「出力」パネルに表示します。

何も変更しません。

詳細(英語)