JoyPro2 Discord GitHub
GUI のページ

HUD

表示:

HUD は、配信者のコントローラー オーバーレイのように、プレイ中にデバイスを画面に表示します。スティックの画像はスティックに合わせて傾き、レバーや軸はバーとして動き、押しているボタンは名前付きで光り、実行中のゲームで押したボタンが何をするかを 1 行で表示します("Gear Toggle")。ゲームの上、OBS、またはその両方に、それぞれ独自のウィジェットで表示できます。このページはそのデザイナーです。

ライブ プレビュー付きの HUD デザイナーライブ プレビュー付きの HUD デザイナー
ライブ プレビュー付きの HUD デザイナー (画像は英語版のアプリを表示しています。)
flowchart LR
  D["デバイス"] --> P["HUD"]
  O["ゲーム内での<br/>割り当て"] --> P
  P --> S["自分の画面"]
  P --> B["OBS 用ページ"]
  P --> W["配信用ウィンドウ"]
HUD は実行中のゲームでのデバイスと割り当てを読み取り、最大 3 か所に同時に表示します:ゲームの上の自分の画面、OBS 用ページ、配信用ウィンドウ。
初心者向け

#3 クリックで HUD を開始

  1. 下部バーで HUD を開きます。スティックを動かすと、プレビューがすでに動きます。
  2. 自分の画面(ゲームの上) にチェックを入れたままにします。
  3. HUD 開始 を押します(スタート ページにもあります)。ゲームを起動すると、HUD がゲームの上に表示されます。マウスやキーボードをゲームから奪うことはありません。

HUD 停止(同じボタン)で閉じます。ここでの設定はすべて保存され、再起動の後も残ります。

#画面に表示されるもの

  • デバイスごとに 1 つの ウィジェット:最初はスティック、スロットル、ペダルが表示され、パネルとキーボードは非表示です(ウィジェット の一覧でチェックを入れます)。各ウィジェットには、デバイスの写真、スティックの位置、バーで表した軸、ボタン、ハットを表示できます。
  • 機体ウィジェット:乗っている機体のスティックとスロットルを、ゲームが描くとおりに表示し、自分のデバイスに合わせて動かします。
  • ゲーム ヘッダー:ゲームまたは DCS の機体と、その画像。
  • ボタンの機能:最後に押したボタンと、実行中のゲームでのそのアクション。

プレビューでウィジェットをドラッグすると移動できます。クリックすると、右側で変更できます。自動で配置 を押すと、下に沿って並べます:スロットルと左手のデバイスは左、ペダルは中央、右手のスティックは右。

機体ウィジェット:機体自身のスティックとスロットル機体ウィジェット:機体自身のスティックとスロットル
機体ウィジェット:機体自身のスティックとスロットル
ゲーム内: ゲーム内での見え方

HUD ウィンドウは透明で、ウィンドウ モードとボーダーレスのゲームの上に表示され続けます。クリックはウィンドウを素通りしてゲームに届きます。タスク バーや Alt+Tab には表示されません。排他的フルスクリーンでは隠れてしまいます(Windows の制限)。ゲームをボーダーレスに切り替えてください。押したボタンの行には、そのゲームと機体のアクション名が表示されます。例:F-16C では "Weapon Release"、IL-2 では "Fire guns"。

詳細

#HUD の表示先

3 つの出力は互いに独立しています:

出力 対象 方法
自分の画面(ゲームの上) 自分 ゲームの上に重なる透明なウィンドウ
OBS 用ページ(ブラウザソース、透明) 配信(推奨) JoyPro がこの PC 専用のページを提供します。コピー でそのアドレスをクリップボードに入れます
配信用ウィンドウ(ウィンドウ キャプチャ) ウィンドウキャプチャで配信する場合 透明またはクロマキーの背景を持つ通常のウィンドウ(ゲームの後ろにあっても可)

自分の画面 のチェックを外すと、配信には HUD を表示したまま、すっきりした画面でプレイできます。それぞれに別のウィジェットを表示することもできます。どのウィジェットにも、モニター(自分の画面)と OBS(配信)の 2 つのチェックがあります。プレビュー: 自分の画面 / 配信 で、デザイナーに表示する内容を切り替えます。1 秒あたりの最大更新回数(15、30、60。30 で滑らかかつ軽量です)。

#OBS の設定(ブラウザソース)

  1. OBS 用ページ(ブラウザソース、透明) にチェックを入れて HUD 開始 を押します。
  2. アドレス(http://127.0.0.1:8765/hud)の横の コピー を押します。
  3. OBS で:Sources > + > Browser。アドレスを URL に貼り付け、Width を 1920、Height を 1080 にします。ほかには何も要りません。背景は透明で、カスタム CSS も不要です。
  4. 任意:Shutdown source when not visible にチェックを入れると、そのソースがないシーンでは OBS がページを止めます。

このページは、配信用にチェックしたウィジェットを、アプリと同じ位置とスタイルで、ソースに合わせて拡大縮小される 1920 x 1080 のステージに描きます。ポートがほかのプログラムに使われている場合は、ポート で別のポートを選び、アドレスをもう一度コピーします。

OBS で表示した配信用ページOBS で表示した配信用ページ
OBS で表示した配信用ページ

ウィンドウキャプチャを使う場合:配信用ウィンドウ にチェックを入れ、背景(透明、緑、マゼンタ、青、または好きな色)を選びます。OBS で Window Capture を Capture Method: Windows 10 (1903 and up) で追加します。色を使う場合は、その色の Chroma Key フィルターを追加します。OBS で透明な背景が黒く表示される場合は、ブラウザソースか色付きの背景を使ってください。

OBS のブラウザソースが HUD を受け取る仕組み:最初に 1 ページ、その後は変更だけ。

# 誰が どうなるか
1 OBS ブラウザソースが http://127.0.0.1:8765/hud を開きます。
2 JoyPro ページを送ります:レイアウト、スタイル、画像。
3 OBS /hud/events を開きます。開いたままになります。
4 JoyPro 状態(軸、ボタン、ボタンの機能)を送ります。最大で 1 秒に 30 回、何かが変わったときだけです。
5 JoyPro ウィジェット、配置、スタイルが変わると、レイアウトをもう一度送ります。

#ウィジェット

ウィジェット には、すべてのデバイスとヘッダー、割り当てティッカー、機体ウィジェットが並びます。デバイスを再読み込み は接続中のデバイスを読み直し、すべて表示 は自分の画面用にすべてのウィジェットにチェックを入れ、自動で配置 と 位置をリセット はウィジェットを配置します。

ウィジェットごと(プレビューか一覧でクリック):

  • 自分の画面に表示、配信に表示、サイズ、このウィジェットのスタイル(HUD のスタイル、またはほかの任意のスタイル)。
  • 表示:名前、種類(スティック、スロットル)、画像、スティックに合わせて傾く画像、点灯するボタン、押しているボタンの名前、軸とレバー、軸の名前、軸の値、スティックの位置(ジンバル)、ハット。ヘッダーウィジェット:その画像。
  • 画像:写真(メーカーの画像、背景を切り抜いたもの)、レイアウト(レイアウト ページの JoyPro のレイアウト画像。押したボタンがその位置で点灯)、自動(写真があれば写真)。
  • このベースのグリップ:複数のグリップを付けられるベース(VPforce Rhino、Virpil WarBRD)用です。グリップによって画像とボタン名が決まります。
  • スティックの軸:スティック要素の X、Y、ツイストをどこから取るか。自動 はデバイス自身の軸を使います。軸を持たない独立したデバイスであるグリップは、取り付けたベースから軸を取ります。
選択したデバイスウィジェット:表示する内容、画像、スティックの軸選択したデバイスウィジェット:表示する内容、画像、スティックの軸
選択したデバイスウィジェット:表示する内容、画像、スティックの軸

機体ウィジェット:スティック、スロットル、スロットルの可動バー、スティックの位置、点灯する操作部、操作中の操作部の名前。機体(自動:飛行中の機体、またはこの PC で設定した任意の画像)と 連動先(動かすスティックとスロットル)。画像はゲーム自身のコックピット画像(コックピット > ゲームから画像を作成、または画像パック)から取り、なければ実物のグリップを描いた JoyPro の線画を使います。

#40 のスタイル

スタイル には 40 のプリセットがあります:ガラス、ネオン、ミニマル、すっきり系(すりガラス (ライト)、ストリーマー シンプル、ストリーマー ボールド、コンパクト、大きな文字、パステル、輪郭のみ)、コックピットの表示器(ミリタリー グリーン HUD、アンバー MFD、旅客機 PFD、グラス コックピット、暗視、赤色コックピット照明、ベクター ワイヤーフレーム、レトロ ターミナル、ウォーバード、ホログラム)、ゲームとジャンル(宇宙シム オレンジ、ホロ シアン、サイバーパンク、シンセウェイブ、ネオン ピンク、レーシング、タクティカル タン、ネイビー & ゴールド、ステルス、ゴースト)、カラーテーマ(北極、砂漠、海洋、夕焼け、ロイヤル、カーボン)、読みやすさ(ハイコントラスト、ハイコントラスト (ライト)、モノクロ、モノクロ (ライト))。› で次のスタイルに進みます。

40 のスタイルのうちいくつか40 のスタイルのうちいくつか
40 のスタイルのうちいくつか

その下には、ワンクリックで選べるアクセントカラー、アクセント、押下時、不透明度、そして要素ごとのデザインオプションがあります:カード(背景、枠線、角、影)、テキスト(フォント、サイズ、字間、色、名前を太字)、スティック表示(リング、四角、十字線、レーダー、点。サイズ、光彩)、バーとレバー(形、高さ、空の部分)、ボタンとチップ(形)。オプションを変えると、スタイルは「独自デザイン(変更あり)」になります。スタイルを保存 で自分の名前を付けて保存し、変更を元に戻す でプリセットに戻り、スタイルをエクスポート... / スタイルをインポート... でファイルとして共有し、削除 で自分のスタイルを削除します。

#ボタンの機能と DCS の機体

ボタンの機能:表示する行数、表示しておく時間(秒)、フォントサイズ、デバイスとボタンを表示、ゲームの実行中のみ。クリック透過 は、マウスのクリックを HUD のウィンドウの下に通します(HUD の開始時に適用)。

JoyPro は実行中のゲームをプロセスから見つけ(DCS、IL-2、Star Citizen など、扱うすべてのゲーム)、そのゲームの割り当てだけを表示します。DCS では機体も必要です。DCS 機体 で選ぶか、DCS フックをインストール して、ミッション開始のたびに DCS から JoyPro に機体を知らせるようにします(小さな Lua ファイルと、Export.lua 内の保護された 1 行。先にバックアップを取ります。削除 でファイルを 1 バイトも違わず元に戻します。先に DCS を閉じてください)。確認 で、フックがインストールされているかどうかがわかります。

ゲームの上に表示された HUDゲームの上に表示された HUD
ゲームの上に表示された HUD
技術的な内部情報

#ページの仕組み

ビューモデル:MainWindowViewModel.Hud.cs(デバイス、ウィジェット、配置)、MainWindowViewModel.HudStyles.cs(プリセット、独自のスタイル、インポート/エクスポート)、MainWindowViewModel.HudStream.cs(出力、配信用ページ、機体ウィジェット)、MainWindowViewModel.HudAxes.cs(スティックの軸)、MainWindowViewModel.Overlay.cs(開始/停止、実行中のゲーム、ボタンの行、DCS フック)。ビュー:Views/HudWindow.axaml、Views/Controls/HudSurface.axaml、HudElements.cs、HudPanel.cs。プリセット:Models/HudStylePresets.cs。

  • デバイス:engine hud devices は、接続中の各デバイスについて、モデル、種類、使う手、製品画像、役割付きの軸、名前と操作 ID 付きのボタン(Controls、機体ウィジェット用)、ボタン位置付きのレイアウト画像を返します。
  • 実行中のゲームの割り当て:engine overlay map(--game、--plane、--unit):モディファイアと名称付きの割り当て済みボタン。モディファイア付きの割り当ては、そのモディファイアを押している間に表示されます。一致するモディファイアが最も多い割り当てが優先されます。
  • DCS フック:engine overlay dcs-hook status / install / remove(--path、--dry-run):Scripts\JoyProOverlay.lua と、Export.lua 内の pcall で囲んだ 1 行。DCS はユニットの種類を 127.0.0.1:1992(UDP)に送ります。フックは、置き換えたほかのスクリプト(SRS、Tacview)のエクスポート関数も呼び出します。
  • 配信サーバー:Services/HudStreamServer.cs、HudStreamHub.cs、Resources/hud-stream.html。127.0.0.1 だけにバインドされ、別のホスト名でのリクエストは拒否されます。GET /hud(ページ)、/hud/events(Server-Sent Events:layout、state)、/hud/img/<id>(PNG の画像)、/hud/state(JSON)。接続しているページがなければ待ち受けるだけです。
  • プレイ中の負荷:Services/HudInputPump.cs はデバイスごとに最新のレポートだけを残し、選んだレートで適用します。要素は変化があったときだけ再描画され、レポートごとのメモリ確保はなく、画像の切り抜きは 1 回だけです(機体のグリップは高さ 480 px)。HUD の長時間テストで、CPU、メモリ確保、メモリの上限に対して測定しています。
  • 設定:%APPDATA%\JoyPro2\hud.json(位置、サイズ、ウィジェットごとの画面用・配信用のチェック、すべてのオプションを含むスタイル、独自のスタイル、出力、ポート、背景、更新レート)。スタイルファイル:*.joypro-hudstyle.json("format": "joypro-hud-style")。

リファレンス:hud。

#参考資料

このページの元になった機能ドキュメント(リポジトリから生成):

#このページのすべての操作項目

プログラムのソースから読み取った 42 個のコントロール:説明済み 42、ソースの情報(ツールチップ、コード コメント、エンジン呼び出し)付き 0、今後拡充 0。

#オーバーレイを切り替え

ボタン説明済み

「HUD 開始」/「HUD 停止」: 上でチェックした出力で HUD を開始します。必要ならデバイスを読み込み、実行中のゲームを見つけ、その割り当てを読み込みます。

もう一度押すと、すべての出力を閉じます。

詳細(英語)

#自分の画面(ゲームの上)

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

ツールチップ ゲームの上に表示される透明な HUD です。チェックを外すと、配信には HUD を表示したまま自分の画面をすっきり保てます。

HUD をゲームの上に透明なウィンドウとして表示します。

配信には HUD を表示したまま、自分の画面をすっきりさせたい場合はチェックを外してください。

詳細(英語)

#OBS 用ページ(ブラウザソース、透明)

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

ツールチップ JoyPro は HUD を Web ページとしてこの PC 内だけで提供します。OBS でこのアドレスのブラウザソースを追加してください。背景は透明なので、カスタム CSS は不要です。

HUD の実行中、JoyPro は OBS のブラウザ ソース用に、この PC 上だけで HUD を Web ページとして提供します。背景は透明で、カスタム CSS はありません。

チェックすると、アドレスと「コピー」、「ポート」が下に表示されます。

詳細(英語)

#コピー

ボタン説明済み

OBS ページのアドレスをクリップボードにコピーします。

OBS で: ソース > + > ブラウザ を選び、URL として貼り付け、幅 1920、高さ 1080 にします。

詳細(英語)

#配信用ウィンドウ(ウィンドウ キャプチャ)

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

ツールチップ 独立したウィンドウで、最前面には表示されません。ゲームの後ろにあってもかまいません。OBS で: キャプチャ方法 Windows 10 (1903 以降) のウィンドウ キャプチャを使用します。クロマキー色を使う場合はクロマキー フィルタを追加してください。

HUD の実行中、OBS のウィンドウ キャプチャ用に専用のウィンドウを開きます。背景は透明か、下で選んだクロマキーの色です。

OBS で: キャプチャ方法を Windows 10 にし、色を使う場合はクロマキー フィルターを追加します。

詳細(英語)

#画面に表示

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

リスト内のウィジェットのモニター チェック: 自分の画面に表示します。

詳細(英語)

#配信に表示

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

リスト内のウィジェットの OBS チェック: 配信に表示します。

詳細(英語)

#デバイスを再読み込み

ボタン説明済み

接続されているデバイスを読み込み直します。新しいデバイスにはウィジェットが作られ、画像とボタン名が更新されます。

デバイスを接続した後に使ってください。

詳細(英語)

#すべて表示

ボタン説明済み

画面用のすべてのウィジェットにチェックを入れます。不要なものはリストでチェックを外してください。

詳細(英語)

#自動で配置

ボタン説明済み

ツールチップ 下部に沿って、スロットルと左手用を左、ペダルを中央、右手用スティックを右に配置します

画面に表示されるデバイス ウィジェットを下部に並べます。スロットルと左手のデバイスは左、ペダルは中央、右手のスティックは右です。収まらないものは 1 段上に置かれます。

新しい配置は保持されます。

詳細(英語)

#位置をリセット

ボタン説明済み

すべてのウィジェットを既定の位置とサイズに戻します。各ウィジェットに表示される内容はそのままです。

詳細(英語)

#›

ボタン説明済み

ツールチップ 次のスタイル

HUD を「スタイル」リストの次の項目に切り替えます。

詳細(英語)

#アクセント カラー

ボタン説明済み

スタイルにこのアクセント カラーを設定します。HUD はすぐに反映し、保存するまでスタイルは「独自デザイン」と表示されます。

詳細(英語)

#名前を太字

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

ウィジェットの名前を太字で表示します。スタイルの一部なので、保存するまで「独自デザイン」に変わります。

詳細(英語)

#スタイルを保存

ボタン説明済み

現在のデザインを、横に入力した名前で自作スタイルとして保存し、HUD のスタイルにします。

プリセットの名前は使えません。同じ名前の自作スタイルは置き換えられます。

詳細(英語)

#スタイルをインポート...

ボタン説明済み

スタイル ファイルを読み込み、自作スタイルの 1 つにして HUD のスタイルにします。

すでに使っている名前には番号が付きます。

詳細(英語)

#スタイルをエクスポート...

ボタン説明済み

現在のデザインを、共有や保管用のスタイル ファイルとして保存します。HUD は変わりません。

詳細(英語)

#変更を元に戻す

ボタン説明済み

ツールチップ 上で選んだスタイルに戻す

デザインを、手動で変更する前のスタイル(最後に選んだ、保存した、またはインポートしたスタイル)に戻します。

詳細(英語)

#削除

ボタン説明済み

選んだ自作スタイルを削除します。それを使っていたウィジェットは HUD のスタイルに戻ります。HUD は現在の見た目を保ちます。

詳細(英語)

#デバイスとボタンを表示

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

「ボタンの機能」の各行の下に、デバイスとボタンを追加します。

詳細(英語)

#ゲームの実行中のみ

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

「ボタンの機能」の行を、対応ゲームの実行中だけ表示します。オフの場合はデスクトップでも表示されます。

詳細(英語)

#クリック透過(開始時に適用)

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

マウスのクリックは HUD ウィンドウを通り抜けてゲームに届きます。

HUD の開始時に適用されます。変更した後は HUD を停止して再び開始してください。

詳細(英語)

#DCS フックをインストール

ボタン説明済み

DCS フックをインストールします: Scripts\JoyProOverlay.lua と、Export.lua 内の保護された 1 行です。

先にDCSを閉じてください。

詳細(英語)

#削除

ボタン説明済み

DCS フックを再び削除します。Export.lua はバイト単位で元どおりになります。

先にDCSを閉じてください。

詳細(英語)

#確認

ボタン説明済み

設定の DCS フォルダーに DCS フックがインストールされているかを確認します。

何も変更しません。

詳細(英語)

#自分の画面

オプション説明済み2 ×

「自分の画面」/「配信」: デザイナーのプレビューに表示する内容です。画面用にチェックしたウィジェット、または配信用にチェックしたウィジェットです。

変わるのはプレビューだけです。選択は次回の起動時にも保持されます。

詳細(英語)

#自分の画面に表示

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

選択中のウィジェットを自分の画面に表示します。

詳細(英語)

#配信に表示

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

選択中のウィジェットを配信(OBS ページと配信用ウィンドウ)に表示します。

詳細(英語)

#名前

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

デバイスの名前をウィジェットに表示します。

#画像

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

ゲーム ヘッダー ウィジェット: ゲームまたは DCS 機体の画像をその名前の横に表示します。

#種類(スティック、スロットル)

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

デバイスの種類を名前の下に表示します。

詳細(英語)

#画像

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

デバイスの画像を表示します。

詳細(英語)

#スティックに合わせて画像を傾ける

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

実物のスティックが動いているように、デバイスの画像をスティックに合わせて傾けたりひねったりします。

#ボタンを点灯

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

デバイス ウィジェット: 押しているボタンが点灯します。機体ウィジェット: 押したボタンに対応する機体の操作部が、そのスティックまたはスロットル上で点灯します。

詳細(英語)

#押しているボタンを名前で表示

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

デバイス ウィジェット: 押しているボタンが、デバイス カタログの名前付きのチップとして表示されます。

機体ウィジェット: 機体の押されている操作部を、グリップの下に名前で表示します。

詳細(英語)

#軸とレバー

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

デバイス ウィジェット: すべての軸とレバーがバーとして動きます。

機体ウィジェット: スロットルの横に、レバーの位置を示すバーを表示します。

詳細(英語)

#軸の名前

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

各軸の名前をバーの横に表示します。

詳細(英語)

#軸の値

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

各軸の値をバーの横に表示します。

#スティック位置(ジンバル)

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

スティックの要素を表示します。スティックの位置を示すリング内の点と、ひねりを示す目盛りです。

詳細(英語)

#ハット

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

ハットを表示します。押した方向が点灯します。

#スティック

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

機体ウィジェット: 機体自身のスティックの画像を表示し、あなたのスティックに合わせて傾けます。

#スロットル

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

機体ウィジェット: 機体自身のスロットルの画像を表示し、あなたのスロットルの 1 本目のレバーに合わせてスライドさせます。