#Перемкнути оверлей
Кнопкаописано«Запустити HUD» / «Зупинити HUD»: запускає HUD з виходами, позначеними вище: за потреби читає пристрої, знаходить запущену гру і завантажує її прив'язки.
Повторне натискання закриває всі виходи.
HUD показує ваші пристрої на екрані під час гри, як оверлей контролера у стримера: зображення ручки керування нахиляється разом з вашою ручкою, важелі й осі рухаються як смужки, утримувані кнопки підсвічуються зі своїми назвами, а рядок каже, що робить натиснута кнопка в запущеній грі («Gear Toggle»). Він може показуватися поверх гри, в OBS або там і там, кожен зі своїми віджетами. Ця сторінка — його конструктор.


flowchart LR D["Ваші пристрої"] --> P["HUD"] O["Ваші прив'язки<br/>у грі"] --> P P --> S["На моєму екрані"] P --> B["Сторінка для OBS"] P --> W["Вікно для стриму"]
Зупинити HUD (та сама кнопка) закриває його. Усе, що ви тут налаштували, зберігається і є знову після перезапуску.
Перетягніть віджет у попередньому перегляді, щоб перемістити його; клацніть його, щоб змінити праворуч. Розташувати автоматично розміщує їх уздовж нижнього краю: важіль газу й пристрої для лівої руки ліворуч, педалі посередині, ручку керування для правої руки праворуч.


Вікно HUD прозоре й залишається поверх ігор у віконному та безрамковому режимах. Клацання проходять крізь нього до гри. Його немає на панелі завдань і в Alt+Tab. Ексклюзивний повноекранний режим його приховує (обмеження Windows): перемкніть гру в безрамковий режим. Рядок натиснутої кнопки називає дію цієї гри та літака, наприклад «Weapon Release» на F-16C і «Fire guns» в IL-2.
Три виходи не залежать один від одного:
| Вивід | Для кого | Як |
|---|---|---|
| На моєму екрані (поверх гри) | для вас | прозоре вікно поверх гри |
| Сторінка для OBS (джерело «Браузер», прозора) | ваш стрім (рекомендовано) | JoyPro надає сторінку лише на цьому ПК; Копіювати кладе її адресу в буфер обміну |
| Вікно стріму («Захоплення вікна») | стріми із «Захопленням вікна» | звичайне вікно (може бути за грою) з прозорим тлом або тлом для хромакею |
Зніміть позначку На моєму екрані, щоб грати з чистим екраном, поки стрім і далі показує HUD, або показуйте різні віджети в кожному: кожен віджет має дві позначки — монітор (ваш екран) і OBS (стрім). Перегляд: Мій екран / Стрім перемикає, що показує конструктор. Щонайбільше оновлень за секунду (15, 30 або 60; 30 — плавно й легко).
http://127.0.0.1:8765/hud).Сторінка малює віджети, позначені для стріму, на тих самих місцях і в тих самих стилях, що й у застосунку, на сцені 1920 x 1080, масштабованій до джерела. Порт зайнято іншою програмою? Виберіть інший у Порт і скопіюйте адресу ще раз.


Натомість «Захоплення вікна»: позначте Вікно стріму, виберіть тло (прозоре, зелене, пурпурове, синє або свій колір). В OBS додайте Window Capture з Capture Method: Windows 10 (1903 and up); для кольорового тла додайте фільтр Chroma Key цього кольору. Якщо прозоре тло у вашому OBS показується чорним, використовуйте джерело «Браузер» або колір.
Як джерело «Браузер» в OBS отримує HUD: одна сторінка, а потім лише зміни.
| # | Хто | Що відбувається |
|---|---|---|
| 1 | OBS | Джерело «Браузер» відкриває http://127.0.0.1:8765/hud. |
| 2 | JoyPro | Надсилає сторінку: макет, стилі та зображення. |
| 3 | OBS | Відкриває /hud/events. З'єднання залишається відкритим. |
| 4 | JoyPro | Надсилає стан (осі, кнопки, що робить кнопка) щонайбільше 30 разів на секунду і лише тоді, коли щось змінилося. |
| 5 | JoyPro | Знову надсилає макет, коли змінюються віджети, місця або стилі. |
Віджети перелічує кожен пристрій, а також заголовок, стрічку прив'язок і віджет літака. Перезавантажити пристрої знову зчитує підключені пристрої; Показати всі позначає кожен віджет для вашого екрана; Розташувати автоматично і Скинути місця ставлять їх на місця.
Для кожного віджета (клацніть його в попередньому перегляді або в списку):


Віджет літака: ручка керування, важіль газу, смуга ходу газу, положення ручки, підсвічування елементів керування, утримувані елементи за назвою; Літаки (Автоматично: літак, на якому ви летите, або будь-яке зображення, задане на цьому ПК) і Рухається разом із (ручка керування й важіль газу, які його рухають). Його зображення беруться з власних зображень кабін гри (Кабіни > Створити зображення з моїх ігор або пакет зображень), інакше — схема справжнього руків'я від JoyPro.
Стиль має 40 готових варіантів: Скло, Neon, Мінімальний, чисті (Матове скло, світлий, Стрімер, стриманий, Стрімер, яскравий, Компактний, Великий текст, Пастель, Лише контури), дисплеї кабіни (Військовий HUD, зелений, MFD, бурштиновий, PFD авіалайнера, Скляна кабіна, Нічне бачення, Червоне підсвічування кабіни, Векторний каркас, Ретротермінал, Warbird, Голограма), ігри й жанри (Космосим, помаранчевий, Голо, блакитний, Кіберпанк, Синтвейв, Неоновий рожевий, Перегони, Тактичний пісочний, Темно-синій і золото, Стелс, Привид), колірні теми (Арктика, Пустеля, Океан, Захід сонця, Королівський, Карбон) і читабельність (Висока контрастність, Висока контрастність, світлий, Монохром, Монохром, світлий). › переходить до наступного.


Нижче: кольори акценту одним клацанням, Акцент, Натиснуто і Непрозорість, далі параметри оформлення для кожного елемента: Картки (тло, рамка, кути, тінь), Текст (шрифт, розмір, міжлітерний інтервал, кольори, Жирні назви), Елемент ручки (кільце, квадрат, перехрестя, радар, точка; розмір, світіння), Смуги й важелі (форми, висоти, порожня частина) і Кнопки й мітки (форми). Змінений параметр робить стиль «власним дизайном (змінено)»: Зберегти стиль зберігає його під вашою назвою, Скасувати зміни повертає до готового варіанта, Експорт стилю... / Імпорт стилю... дають поділитися ним як файлом, Видалити видаляє ваш власний стиль.
Що робить кнопка: скільки рядків, як довго вони лишаються (секунди), розмір шрифту, Показувати пристрій і кнопку і Лише поки йде гра. Click-through пропускає клацання миші крізь вікно HUD (діє під час запуску HUD).
JoyPro знаходить запущену гру за її процесом (DCS, IL-2, Star Citizen і кожна інша гра, яку він підтримує) і показує лише прив'язки цієї гри. DCS потребує ще й літака: виберіть його в Літак DCS або натисніть Встановити хук DCS, щоб DCS повідомляв JoyPro літак на початку кожної місії (невеликий файл Lua плюс один захищений рядок у Export.lua, перед цим робиться резервна копія; Видалити повертає файл байт у байт; спершу закрийте DCS). Перевірити показує, чи встановлено хук.


Модель представлення: 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): прив'язані кнопки з модифікаторами й назвами. Прив'язка з модифікаторами показується, поки утримуються її модифікатори; перемагає прив'язка з найбільшою кількістю збіжних модифікаторів.engine overlay dcs-hook status / install / remove (--path, --dry-run): Scripts\JoyProOverlay.lua плюс один рядок у Export.lua, обгорнутий у pcall; 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 зберігає лише найновіший звіт кожного пристрою й застосовує їх із вибраною частотою; елементи перемальовуються лише при зміні; на кожен звіт нічого не виділяється в пам'яті; зображення обрізаються один раз (руків'я літаків заввишки 480 px). Вимірюється тривалим тестом HUD щодо бюджетів процесора, виділень і пам'яті.%APPDATA%\JoyPro2\hud.json (місця, розміри, позначки кожного віджета для екрана й стріму, стиль з усіма параметрами, власні стилі, виходи, порт, тло, частота оновлення). Файли стилів: *.joypro-hudstyle.json ("format": "joypro-hud-style").Довідка: hud.
Документація функцій, на якій базується ця сторінка, згенерована з репозиторію:
42 елементів керування, зчитаних з вихідного коду програми: 42 описано, 0 з фактами з коду (підказка, коментар у коді, виклик рушія), 0 ще треба розширити.
«Запустити HUD» / «Зупинити HUD»: запускає HUD з виходами, позначеними вище: за потреби читає пристрої, знаходить запущену гру і завантажує її прив'язки.
Повторне натискання закриває всі виходи.
Підказка Прозорий HUD поверх гри. Зніміть позначку, щоб ваш екран лишався чистим, а стрім і далі показував HUD.
Показує HUD як прозоре вікно поверх гри.
Зніміть позначку, щоб ваш власний екран залишався чистим, поки стрім усе одно показує HUD.
Підказка JoyPro віддає HUD як вебсторінку лише на цьому ПК. В OBS додайте джерело «Браузер» з цією адресою: тло прозоре, власний CSS не потрібен.
Поки HUD працює, JoyPro віддає його як вебсторінку лише на цьому ПК для OBS Browser Source: прозорий фон, без власного CSS.
Якщо позначено, нижче показуються адреса з «Копіювати» і «Порт».
Копіює адресу сторінки для OBS у буфер обміну.
В OBS: Sources > + > Browser, вставте її як URL, ширина 1920, висота 1080.
Підказка Окреме вікно, не поверх інших: воно може бути за грою. В OBS: «Захоплення вікна» з методом захоплення «Windows 10 (1903 і новіші)»; з кольором хромакею додайте фільтр «Хромакей».
Поки HUD працює, відкриває окреме вікно для Window Capture в OBS, з прозорим фоном або кольором хромакею, вибраним нижче.
В OBS: метод захоплення Windows 10 і фільтр Chroma Key для кольору.
Позначка монітора віджета у списку: показує його на вашому екрані.
Позначка OBS віджета у списку: показує його у стрімі.
Знову читає підключені пристрої: нові пристрої отримують віджет, зображення і назви кнопок оновлюються.
Використовуйте це після підключення пристрою.
Позначає кожен віджет для вашого екрана. Зніміть позначку в списку з тих, які вам не потрібні.
Підказка Важіль газу й ліва рука ліворуч, педалі посередині, ручка правої руки праворуч, уздовж низу
Розміщує віджети пристроїв, показані на вашому екрані, вздовж нижнього краю: важіль газу і пристрої для лівої руки - ліворуч, педалі - посередині, ручку керування для правої руки - праворуч; те, що не вміщується, йде на рядок вище.
Нові місця зберігаються.
Повертає кожен віджет на його типове місце і розмір; те, що показує кожен віджет, залишається.
Підказка Наступний стиль
Перемикає HUD на наступний пункт списку «Стиль».
Дає стилю цей акцентний колір. HUD одразу його бере; стиль показується як «Власний дизайн», доки ви його не збережете.
Показує назви віджетів жирним. Частина стилю: змінює його на «Власний дизайн», доки не збережено.
Зберігає поточний дизайн як ваш власний стиль під назвою, введеною поруч, і робить його стилем HUD.
Назва пресета не приймається; ваш стиль з такою самою назвою замінюється.
Читає файл стилю і робить його одним із ваших стилів і стилем HUD.
Назва, яку ви вже використовуєте, отримує номер.
Зберігає поточний дизайн як файл стилю, щоб поділитися ним або зберегти; HUD не змінюється.
Підказка Повернутися до стилю, вибраного вище
Повертає дизайн до стилю, який був до змін, зроблених вручну: стилю, який востаннє вибрали, зберегли або імпортували.
Видаляє вибраний ваш власний стиль. Віджети, які його використовували, повертаються до стилю HUD; HUD зберігає свій поточний вигляд.
Додає пристрій і кнопку під кожен рядок «Що робить кнопка».
Показує рядки «Що робить кнопка» лише тоді, коли працює підтримувана гра; якщо вимкнено, вони показуються і на робочому столі.
Клацання миші проходять крізь вікно HUD до гри.
Застосовується під час запуску HUD: після зміни зупиніть і знову запустіть його.
Встановлює хук DCS: Scripts\JoyProOverlay.lua і один захищений рядок в Export.lua.
Спершу закрийте DCS.
Знову видаляє хук DCS: Export.lua байт у байт такий, як раніше.
Спершу закрийте DCS.
Перевіряє, чи встановлено хук DCS у папці DCS з «Налаштувань».
Нічого не змінює.
«Мій екран» / «Стрім»: що показує попередній перегляд дизайнера - віджети, позначені для вашого екрана, чи ті, що позначені для стріму.
Змінюється лише попередній перегляд; вибір зберігається до наступного запуску.
Показує вибраний віджет на вашому екрані.
Показує вибраний віджет у стрімі: на сторінці для OBS і у вікні стріму.
Показує назву пристрою на його віджеті.
Віджет заголовка гри: показує зображення гри або літака DCS поруч з його назвою.
Показує тип пристрою під його назвою.
Показує зображення пристрою.
Нахиляє і повертає зображення пристрою разом із ручкою керування, ніби рухається справжня ручка.
Віджет пристрою: затиснуті кнопки світяться. Віджет літака: елемент керування літака, який відповідає натиснутій вами кнопці, світиться на його ручці керування або важелі газу.
Віджет пристрою: затиснуті кнопки показуються як мітки з назвами з каталогу пристроїв.
Віджет літака: затиснуті елементи керування літака за назвою під руків'ями.
Віджет пристрою: кожна вісь і важіль рухаються як смужка.
Віджет літака: смужка поруч із важелем газу з положенням вашого важеля.
Пише назву кожної осі поруч з її смужкою.
Пише значення кожної осі поруч з її смужкою.
Показує елемент ручки керування: точка в кільці в положенні ручки, з рисочкою для повороту.
Показує хети; натиснутий напрямок світиться.
Віджет літака: показує власне зображення ручки керування літака, яке нахиляється разом з вашою ручкою.
Віджет літака: показує власне зображення важеля газу літака, яке ковзає разом з першим важелем вашого газу.