#Переключить оверлей
Кнопкаописано«Запустить 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 | Снова отправляет макет, когда меняются виджеты, места или стили. |
Виджеты перечисляет все устройства, а также заголовок, бегущую строку привязок и виджет ЛА. Перезагрузить устройства заново читает подключённые устройства; Показать все отмечает все виджеты для вашего экрана; Расставить автоматически и Сбросить места расставляют их по местам.
Для каждого виджета (щёлкните по нему в предпросмотре или в списке):


Виджет ЛА: ручка, РУД, полоса хода РУД, положение ручки, подсветка органов управления, зажатые органы управления по имени; ЛА (Автоматически: ЛА, на котором вы летите, или любое изображение, заданное на этом ПК) и Движется вместе с (ручка и РУД, которые его двигают). Изображения берутся из собственных изображений кабин игры (Cockpits > Создать изображения из моих игр или пакет изображений), иначе — схема реальной рукояти от JoyPro.
У Стиль 40 готовых вариантов: Стекло, Неон, Минимальный, строгие (Матовое стекло, светлый, Стример, строгий, Стример, яркий, Компактный, Крупный текст, Пастель, Только контуры), дисплеи кабины (Военный HUD, зелёный, MFD, янтарный, PFD авиалайнера, Стеклянная кабина, Ночное видение, Красная подсветка кабины, Векторный каркас, Ретро-терминал, Warbird, Голограмма), игры и жанры (Космосим, оранжевый, Голо, голубой, Киберпанк, Синтвейв, Неоновый розовый, Гонки, Тактический песочный, Тёмно-синий и золото, Стелс, Призрак), цветовые темы (Арктика, Пустыня, Океан, Закат, Королевский, Карбон) и читаемость (Высокая контрастность, Высокий контраст, светлый, Монохром, Монохром, светлый). › переключает на следующий.


Ниже: акцентные цвета в один щелчок, Акцент, Нажато и Непрозрачность, затем параметры оформления для каждого элемента: Карточки (фон, рамка, углы, тень), Текст (шрифт, размер, межбуквенный интервал, цвета, Жирные названия), Элемент ручки (кольцо, квадрат, перекрестие, радар, точка; размер, свечение), Полосы и рычаги (формы, высота, пустая часть) и Кнопки и метки (формы). Изменённый параметр превращает стиль в «Свой дизайн (изменён)»: Сохранить стиль сохраняет его под вашим именем, Отменить изменения возвращает к готовому варианту, Экспорт стиля... / Импорт стиля... позволяют делиться им как файлом, Удалить удаляет ваш собственный стиль.
Что делает кнопка: сколько строк, как долго они видны (секунды), размер шрифта, Показывать устройство и кнопку и Только пока запущена игра. Сквозной щелчок пропускает щелчки мыши сквозь окно 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 работает, открывает отдельное окно для захвата окна в OBS (Window Capture) с прозрачным фоном или цветом хромакея, выбранным ниже.
В 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 рядом с его названием.
Показывает тип устройства под его названием.
Показывает изображение устройства.
Наклоняет и поворачивает изображение устройства вместе с ручкой, как будто двигается настоящая ручка.
Виджет устройства: удерживаемые кнопки подсвечиваются. Виджет ЛА: элемент управления ЛА, которому соответствует нажатая вами кнопка, подсвечивается на его ручке или РУД.
Виджет устройства: удерживаемые кнопки показываются как плашки с их названиями из каталога устройств.
Виджет ЛА: удерживаемые элементы управления ЛА по названиям под рукоятями.
Виджет устройства: каждая ось и каждый рычаг двигаются как полоска.
Виджет ЛА: полоска рядом с РУД с положением вашего рычага.
Пишет название каждой оси рядом с её полоской.
Пишет значение каждой оси рядом с её полоской.
Показывает элемент ручки: точку в кольце в положении ручки, с отметкой для поворота.
Показывает хатки; нажатое направление подсвечивается.
Виджет ЛА: показывает изображение собственной ручки ЛА, которая наклоняется вместе с вашей ручкой.
Виджет ЛА: показывает изображение собственного РУД ЛА, который сдвигается вместе с первым рычагом вашего РУД.