HUD Overlay

HUD Overlay：賽車儀表覆蓋層

HUD Overlay 是獨立於主 Dashboard 的透明賽車儀表視窗。它使用遊戲 Data Out 遙測，不需要注入遊戲或讀取遊戲記憶體；Full 與 Lite 都能使用 HUD。

HUD 專區導覽

這一頁是使用者總覽；若要維護或開發 HUD，請依下列分工閱讀：

• HUD 樣式參考：逐一說明 10 個內建樣式的畫面功能、渲染實作、適用情境與額外設定。
• HUD 開發指引：從建立 package、註冊 HUDCore、接線、測試到發布的開發流程。
• HUD Shared Core：UDP/WebSocket、canonical telemetry、frame pacing、BroadcastChannel、iframe message 與生命週期。
• HUD Telemetry Cards：共用 G-Force、四角輪胎/懸吊、踏板、動力/扭力與 Live Map 卡片的資料和版面契約。

啟動方式

1. 先依 Get Started 完成 Data Out 與 telemetry 連線。
2. 開啟 HUD Overlay 分頁。
3. 在 General 選擇 HUD style，確認 master switch 已開啟。
4. 調整 HUD scale、glow、custom color 與要顯示的元素。
5. 按下啟動/Launch Overlay。
6. 將透明 HUD 放到遊戲畫面適合的位置；遊戲執行期間不要關閉 backend。

目前內建樣式

目前 main 的內建 package 目錄包括：

Style ID	風格/重點
advanced	高效能弧形轉速表、換檔燈、Boost 與動態資料
drift	Drift telemetry HUD，包含甩尾相關資訊
fm4ui	Forza Motorsport 4 數位儀表風格
gt7	Gran Turismo 7 風格底部 telemetry cluster、胎溫、踏板、G-Force
mw2005	NFS Most Wanted 2005 類比轉速表與 NOS/Boost
nfs15	Need for Speed 2015 風格數位弧形儀表
s650_hmi	Mustang S650 HMI，含 Normal、Track、Heritage、Foxbody 等 cluster
shift_tacho	NFS Shift 風格高對比轉速表與換檔燈
simple	簡潔圓形儀表，中央顯示速度與檔位
vfd	Retro VFD 風格，支援音訊 visualizer 與媒體資訊

選單由 /api/hud/styles 動態掃描；因此未來增加合法 package 不應假設 HUD 數量固定，也不需要為一般自訂樣式修改 launcher 的靜態清單。

可調整的範圍

Overlay 控制頁依 category 提供設定：

• General：樣式、master switch、縮放、glow、色彩與 motion effect。
• Displays：Telemetry cards、速度/檔位、輪胎、懸吊與其他資料顯示。
• Gauges：G-Force radar、四角卡片、Pedal、Power/Torque 等圖表的尺度與位置。
• Performance：Telemetry 元素、Live Map、透明度與高更新率顯示相關選項。

實際選項會依目前 HUD 與版本而不同；若看不到某個控制項，先確認該 style 是否支援該元素。

共用 telemetry 元素

HUD 可以使用共用中央 telemetry cluster：

• G-Force radar。
• 四角懸吊行程。
• 四輪胎溫與滑移。
• 油門/煞車波形。
• 馬力/扭力圖。
• Live Map。

這些元素由共用資料通道提供，HUD 不應自行重新解釋單位、檔位或紅線語意。

系統音訊與媒體

支援的 HUD（目前包括 VFD/Advanced 的相關路徑）可以接收：

• Windows WASAPI loopback 音訊頻譜與左右 VU。
• Windows GSMTC 媒體工作階段的歌曲標題、演出者與 playing/paused/none 狀態。

音訊或媒體沒有資料時，HUD 應顯示靜音/空狀態，而不是把缺失資料當成錯誤的遙測值。

若有多個播放裝置，可在 Overlay 的 Audio controls 重新掃描並選擇 WASAPI playback device。切換裝置只影響音訊頻譜來源，不會改變遊戲 UDP telemetry 或 HUD 的車輛資料。

自訂 HUD package

Release Build 不需重新編譯即可載入自訂 HUD。把 package 放在 EXE 同級：

FH6-HorizonTuner.exe
hud_overlay/
  my-hud/
    index.html
    author.json       # 可選，但建議提供
    assets/

啟動 Release Build 後，在 HUD selector 選擇 my-hud。自訂 package 會由 /hud_user/my-hud/ 提供，內建 package 由 /hud/ 提供；相同 style ID 的 user package 可以覆蓋內建樣式。

以下名稱是保留的 helper directory，不會被列為可選 HUD package：shared、assets、telemetry、common、fonts、css、js。

自訂 HUD 的完整開發契約可先看 HUD 開發指引；需要逐行對照實作時，再看 Repository 的 hud_overlay/HUD_DEVELOPMENT_GUIDE.md。

畫面卡頓的處理

• 先確認遊戲、HUD 與 Dashboard 是否同時高負載。
• 減少不需要的共用 telemetry cards。
• 調整 Live Map、四角卡片與圖表的 scale/opacity。
• 若使用 uncapped 或高刷新率，先用穩定的遊戲幀率進行比較。
• 若是資料停止更新而不是單純畫面卡頓，請先看 排錯。

English

HUD Overlay is a transparent, injection-free racing display driven by the same telemetry backend as the Dashboard. Built-in styles include advanced, drift, fm4ui, gt7, mw2005, nfs15, s650_hmi, shift_tacho, simple, and vfd. Release users can add a hud_overlay/<name>/index.html package beside the executable without rebuilding.

日本語

HUD Overlay は Dashboard と同じテレメトリーを使う透明なレーシング表示で、ゲームへの injection は行いません。advanced、drift、fm4ui、gt7、mw2005、nfs15、s650_hmi、shift_tacho、simple、vfd などの内蔵スタイルがあります。Release 版では EXE の隣に hud_overlay/<name>/index.html を置いて再ビルドなしで追加できます。