JoyPro2 Discord GitHub
Сторінки GUI

HUD

Показати:

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

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

#Запустіть HUD трьома клацаннями

  1. Відкрийте HUD на нижній панелі. Попередній перегляд уже рухається, коли ви рухаєте ручку керування.
  2. Залиште позначеним На моєму екрані (поверх гри).
  3. Натисніть Запустити HUD (є також на сторінці Початок). Запустіть гру: HUD розташовується поверх неї і ніколи не забирає в гри мишу чи клавіатуру.

Зупинити HUD (та сама кнопка) закриває його. Усе, що ви тут налаштували, зберігається і є знову після перезапуску.

#Що на екрані

  • По одному віджету на пристрій: ручки керування, важелі газу й педалі показуються одразу, панелі й клавіатури приховані (позначте їх у списку Віджети). Кожен віджет може показувати фото пристрою, положення ручки керування, осі у вигляді смужок, кнопки й хети.
  • Віджет літака: ручка керування й важіль газу літака, на якому ви літаєте, такі, як їх малює гра, що рухаються разом з вашими.
  • Заголовок гри: гра або літак DCS з його зображенням.
  • Що робить кнопка: останні натиснуті кнопки з їхньою дією в запущеній грі.

Перетягніть віджет у попередньому перегляді, щоб перемістити його; клацніть його, щоб змінити праворуч. Розташувати автоматично розміщує їх уздовж нижнього краю: важіль газу й пристрої для лівої руки ліворуч, педалі посередині, ручку керування для правої руки праворуч.

Віджет літака: власні ручка керування й важіль газу літакаВіджет літака: власні ручка керування й важіль газу літака
Віджет літака: власні ручка керування й важіль газу літака
У грі: Що ви бачите в грі

Вікно HUD прозоре й залишається поверх ігор у віконному та безрамковому режимах. Клацання проходять крізь нього до гри. Його немає на панелі завдань і в Alt+Tab. Ексклюзивний повноекранний режим його приховує (обмеження Windows): перемкніть гру в безрамковий режим. Рядок натиснутої кнопки називає дію цієї гри та літака, наприклад «Weapon Release» на F-16C і «Fire guns» в IL-2.

Розширені

#Де показується HUD

Три виходи не залежать один від одного:

Вивід Для кого Як
На моєму екрані (поверх гри) для вас прозоре вікно поверх гри
Сторінка для OBS (джерело «Браузер», прозора) ваш стрім (рекомендовано) JoyPro надає сторінку лише на цьому ПК; Копіювати кладе її адресу в буфер обміну
Вікно стріму («Захоплення вікна») стріми із «Захопленням вікна» звичайне вікно (може бути за грою) з прозорим тлом або тлом для хромакею

Зніміть позначку На моєму екрані, щоб грати з чистим екраном, поки стрім і далі показує HUD, або показуйте різні віджети в кожному: кожен віджет має дві позначки — монітор (ваш екран) і OBS (стрім). Перегляд: Мій екран / Стрім перемикає, що показує конструктор. Щонайбільше оновлень за секунду (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 OBS Джерело «Браузер» відкриває http://127.0.0.1:8765/hud.
2 JoyPro Надсилає сторінку: макет, стилі та зображення.
3 OBS Відкриває /hud/events. З'єднання залишається відкритим.
4 JoyPro Надсилає стан (осі, кнопки, що робить кнопка) щонайбільше 30 разів на секунду і лише тоді, коли щось змінилося.
5 JoyPro Знову надсилає макет, коли змінюються віджети, місця або стилі.

#Віджети

Віджети перелічує кожен пристрій, а також заголовок, стрічку прив'язок і віджет літака. Перезавантажити пристрої знову зчитує підключені пристрої; Показати всі позначає кожен віджет для вашого екрана; Розташувати автоматично і Скинути місця ставлять їх на місця.

Для кожного віджета (клацніть його в попередньому перегляді або в списку):

  • Показувати на моєму екрані, Показувати в стрімі, Розмір, Стиль цього віджета (стиль HUD або будь-який інший).
  • Показати: назва, тип (ручка керування, важіль газу), зображення, нахил зображення разом із ручкою, підсвічування кнопок, утримувані кнопки за назвою, осі й важелі, назви осей, значення осей, положення ручки (карданний підвіс), хети. Віджет заголовка: його зображення.
  • Зображення: Фото (зображення виробника з вирізаним тлом), Розкладка (ваше зображення розкладки JoyPro зі сторінки Розкладка, натиснуті кнопки підсвічуються на своїх місцях), Авто (фото, якщо воно є).
  • Руків'я на цій основі: для основ, які приймають кілька руків'їв (VPforce Rhino, Virpil WarBRD); руків'я визначає зображення й назви кнопок.
  • Осі ручки: звідки беруться X, Y і Twist елемента ручки. Автоматично бере власні осі пристрою; руків'я, яке є окремим пристроєм без осей, бере їх з основи, на якій воно стоїть.
Вибрано віджет пристрою: що він показує, його зображення та осі ручкиВибрано віджет пристрою: що він показує, його зображення та осі ручки
Вибрано віджет пристрою: що він показує, його зображення та осі ручки

Віджет літака: ручка керування, важіль газу, смуга ходу газу, положення ручки, підсвічування елементів керування, утримувані елементи за назвою; Літаки (Автоматично: літак, на якому ви летите, або будь-яке зображення, задане на цьому ПК) і Рухається разом із (ручка керування й важіль газу, які його рухають). Його зображення беруться з власних зображень кабін гри (Кабіни > Створити зображення з моїх ігор або пакет зображень), інакше — схема справжнього руків'я від JoyPro.

#40 стилів

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

Кілька з 40 стилівКілька з 40 стилів
Кілька з 40 стилів

Нижче: кольори акценту одним клацанням, Акцент, Натиснуто і Непрозорість, далі параметри оформлення для кожного елемента: Картки (тло, рамка, кути, тінь), Текст (шрифт, розмір, міжлітерний інтервал, кольори, Жирні назви), Елемент ручки (кільце, квадрат, перехрестя, радар, точка; розмір, світіння), Смуги й важелі (форми, висоти, порожня частина) і Кнопки й мітки (форми). Змінений параметр робить стиль «власним дизайном (змінено)»: Зберегти стиль зберігає його під вашою назвою, Скасувати зміни повертає до готового варіанта, Експорт стилю... / Імпорт стилю... дають поділитися ним як файлом, Видалити видаляє ваш власний стиль.

#Що робить кнопка і літак DCS

Що робить кнопка: скільки рядків, як довго вони лишаються (секунди), розмір шрифту, Показувати пристрій і кнопку і Лише поки йде гра. Click-through пропускає клацання миші крізь вікно HUD (діє під час запуску HUD).

JoyPro знаходить запущену гру за її процесом (DCS, IL-2, Star Citizen і кожна інша гра, яку він підтримує) і показує лише прив'язки цієї гри. DCS потребує ще й літака: виберіть його в Літак DCS або натисніть Встановити хук DCS, щоб DCS повідомляв JoyPro літак на початку кожної місії (невеликий файл Lua плюс один захищений рядок у Export.lua, перед цим робиться резервна копія; Видалити повертає файл байт у байт; спершу закрийте 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; 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.

Докладніше (англійською)

#Сторінка для OBS (джерело «Браузер», прозора)

Прапорецьописано

Підказка 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 для кольору.

Докладніше (англійською)

#Показувати на вашому екрані

Прапорецьописано

Позначка монітора віджета у списку: показує його на вашому екрані.

Докладніше (англійською)

#Перезавантажити пристрої

Кнопкаописано

Знову читає підключені пристрої: нові пристрої отримують віджет, зображення і назви кнопок оновлюються.

Використовуйте це після підключення пристрою.

Докладніше (англійською)

#Показати всі

Кнопкаописано

Позначає кожен віджет для вашого екрана. Зніміть позначку в списку з тих, які вам не потрібні.

Докладніше (англійською)

#Розташувати автоматично

Кнопкаописано

Підказка Важіль газу й ліва рука ліворуч, педалі посередині, ручка правої руки праворуч, уздовж низу

Розміщує віджети пристроїв, показані на вашому екрані, вздовж нижнього краю: важіль газу і пристрої для лівої руки - ліворуч, педалі - посередині, ручку керування для правої руки - праворуч; те, що не вміщується, йде на рядок вище.

Нові місця зберігаються.

Докладніше (англійською)

#Скинути місця

Кнопкаописано

Повертає кожен віджет на його типове місце і розмір; те, що показує кожен віджет, залишається.

Докладніше (англійською)

#Акцентний колір

Кнопкаописано

Дає стилю цей акцентний колір. HUD одразу його бере; стиль показується як «Власний дизайн», доки ви його не збережете.

Докладніше (англійською)

#Жирні назви

Прапорецьописано

Показує назви віджетів жирним. Частина стилю: змінює його на «Власний дизайн», доки не збережено.

Докладніше (англійською)

#Зберегти стиль

Кнопкаописано

Зберігає поточний дизайн як ваш власний стиль під назвою, введеною поруч, і робить його стилем HUD.

Назва пресета не приймається; ваш стиль з такою самою назвою замінюється.

Докладніше (англійською)

#Імпорт стилю...

Кнопкаописано

Читає файл стилю і робить його одним із ваших стилів і стилем HUD.

Назва, яку ви вже використовуєте, отримує номер.

Докладніше (англійською)

#Експорт стилю...

Кнопкаописано

Зберігає поточний дизайн як файл стилю, щоб поділитися ним або зберегти; HUD не змінюється.

Докладніше (англійською)

#Скасувати зміни

Кнопкаописано

Підказка Повернутися до стилю, вибраного вище

Повертає дизайн до стилю, який був до змін, зроблених вручну: стилю, який востаннє вибрали, зберегли або імпортували.

Докладніше (англійською)

#Видалити

Кнопкаописано

Видаляє вибраний ваш власний стиль. Віджети, які його використовували, повертаються до стилю HUD; HUD зберігає свій поточний вигляд.

Докладніше (англійською)

#Показувати пристрій і кнопку

Прапорецьописано

Додає пристрій і кнопку під кожен рядок «Що робить кнопка».

Докладніше (англійською)

#Лише поки йде гра

Прапорецьописано

Показує рядки «Що робить кнопка» лише тоді, коли працює підтримувана гра; якщо вимкнено, вони показуються і на робочому столі.

Докладніше (англійською)

#Наскрізне клацання (діє після запуску)

Прапорецьописано

Клацання миші проходять крізь вікно HUD до гри.

Застосовується під час запуску HUD: після зміни зупиніть і знову запустіть його.

Докладніше (англійською)

#Встановити хук DCS

Кнопкаописано

Встановлює хук DCS: Scripts\JoyProOverlay.lua і один захищений рядок в Export.lua.

Спершу закрийте DCS.

Докладніше (англійською)

#Перевірити

Кнопкаописано

Перевіряє, чи встановлено хук DCS у папці DCS з «Налаштувань».

Нічого не змінює.

Докладніше (англійською)

#Мій екран

Параметрописано2 ×

«Мій екран» / «Стрім»: що показує попередній перегляд дизайнера - віджети, позначені для вашого екрана, чи ті, що позначені для стріму.

Змінюється лише попередній перегляд; вибір зберігається до наступного запуску.

Докладніше (англійською)

#Показувати в стрімі

Прапорецьописано

Показує вибраний віджет у стрімі: на сторінці для OBS і у вікні стріму.

Докладніше (англійською)

#Назва

Прапорецьописано

Показує назву пристрою на його віджеті.

#Зображення

Прапорецьописано

Віджет заголовка гри: показує зображення гри або літака DCS поруч з його назвою.

#Зображення нахиляється разом із ручкою

Прапорецьописано

Нахиляє і повертає зображення пристрою разом із ручкою керування, ніби рухається справжня ручка.

#Кнопки світяться

Прапорецьописано2 ×

Віджет пристрою: затиснуті кнопки світяться. Віджет літака: елемент керування літака, який відповідає натиснутій вами кнопці, світиться на його ручці керування або важелі газу.

Докладніше (англійською)

#Утримувані кнопки за назвою

Прапорецьописано2 ×

Віджет пристрою: затиснуті кнопки показуються як мітки з назвами з каталогу пристроїв.

Віджет літака: затиснуті елементи керування літака за назвою під руків'ями.

Докладніше (англійською)

#Осі та важелі

Прапорецьописано2 ×

Віджет пристрою: кожна вісь і важіль рухаються як смужка.

Віджет літака: смужка поруч із важелем газу з положенням вашого важеля.

Докладніше (англійською)

#Значення осей

Прапорецьописано

Пише значення кожної осі поруч з її смужкою.

#Положення ручки (карданів підвіс)

Прапорецьописано2 ×

Показує елемент ручки керування: точка в кільці в положенні ручки, з рисочкою для повороту.

Докладніше (англійською)

#Хети

Прапорецьописано

Показує хети; натиснутий напрямок світиться.

#Ручка

Прапорецьописано

Віджет літака: показує власне зображення ручки керування літака, яке нахиляється разом з вашою ручкою.

#Важіль газу

Прапорецьописано

Віджет літака: показує власне зображення важеля газу літака, яке ковзає разом з першим важелем вашого газу.