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 элемента ручки. Автоматически берёт собственные оси устройства; рукоять, которая сама является устройством без осей, берёт их у основания, на котором стоит.
Выбран виджет устройства: что он показывает, его изображение и оси ручкиВыбран виджет устройства: что он показывает, его изображение и оси ручки
Выбран виджет устройства: что он показывает, его изображение и оси ручки

Виджет ЛА: ручка, РУД, полоса хода РУД, положение ручки, подсветка органов управления, зажатые органы управления по имени; ЛА (Автоматически: ЛА, на котором вы летите, или любое изображение, заданное на этом ПК) и Движется вместе с (ручка и РУД, которые его двигают). Изображения берутся из собственных изображений кабин игры (Cockpits > Создать изображения из моих игр или пакет изображений), иначе — схема реальной рукояти от JoyPro.

#40 стилей

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

Несколько из 40 стилейНесколько из 40 стилей
Несколько из 40 стилей

Ниже: акцентные цвета в один щелчок, Акцент, Нажато и Непрозрачность, затем параметры оформления для каждого элемента: Карточки (фон, рамка, углы, тень), Текст (шрифт, размер, межбуквенный интервал, цвета, Жирные названия), Элемент ручки (кольцо, квадрат, перекрестие, радар, точка; размер, свечение), Полосы и рычаги (формы, высота, пустая часть) и Кнопки и метки (формы). Изменённый параметр превращает стиль в «Свой дизайн (изменён)»: Сохранить стиль сохраняет его под вашим именем, Отменить изменения возвращает к готовому варианту, Экспорт стиля... / Импорт стиля... позволяют делиться им как файлом, Удалить удаляет ваш собственный стиль.

#Что делает кнопка и ЛА DCS

Что делает кнопка: сколько строк, как долго они видны (секунды), размер шрифта, Показывать устройство и кнопку и Только пока запущена игра. Сквозной щелчок пропускает щелчки мыши сквозь окно 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 работает, открывает отдельное окно для захвата окна в OBS (Window Capture) с прозрачным фоном или цветом хромакея, выбранным ниже.

В OBS: способ захвата Windows 10 и фильтр Chroma Key для цвета.

Подробнее (на английском)

#Показывать на вашем экране

Флажокописано

Флажок монитора у виджета в списке: показывает его на вашем экране.

Подробнее (на английском)

#Перезагрузить устройства

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

Заново читает подключённые устройства: новые устройства получают виджет, изображения и названия кнопок обновляются.

Используйте это после подключения устройства.

Подробнее (на английском)

#Показать все

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

Отмечает все виджеты для вашего экрана. Снимите флажки в списке с тех, которые вам не нужны.

Подробнее (на английском)

#Расставить автоматически

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

Подсказка РУД и левая рука слева, педали посередине, ручка правой руки справа, вдоль нижнего края

Расставляет виджеты устройств, показанные на вашем экране, вдоль нижнего края: РУД и устройства для левой руки слева, педали посередине, ручку для правой руки справа; то, что не помещается, уходит на ряд выше.

Новые места сохраняются.

Подробнее (на английском)

#Сбросить места

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

Возвращает каждый виджет на его место и размер по умолчанию; то, что показывает каждый виджет, остаётся.

Подробнее (на английском)

#Акцентный цвет

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

Задаёт стилю этот акцентный цвет. HUD сразу применяет его; стиль показывается как «Свой дизайн», пока вы его не сохраните.

Подробнее (на английском)

#Жирные названия

Флажокописано

Показывает названия виджетов жирным шрифтом. Это часть стиля: меняет его на «Свой дизайн», пока не сохранено.

Подробнее (на английском)

#Сохранить стиль

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

Сохраняет текущий дизайн как ваш собственный стиль под именем, введённым рядом, и делает его стилем HUD.

Имя готового набора не принимается; ваш стиль с тем же именем заменяется.

Подробнее (на английском)

#Импорт стиля...

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

Читает файл стиля и делает его одним из ваших стилей и стилем HUD.

Имя, которое у вас уже есть, получает номер.

Подробнее (на английском)

#Экспорт стиля...

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

Сохраняет текущий дизайн как файл стиля, чтобы поделиться им или сохранить; HUD не меняется.

Подробнее (на английском)

#Отменить изменения

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

Подсказка Вернуться к стилю, выбранному выше

Возвращает дизайн к стилю, который был до ручных изменений: к стилю, выбранному, сохранённому или импортированному последним.

Подробнее (на английском)

#Удалить

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

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

Подробнее (на английском)

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

Флажокописано

Добавляет устройство и кнопку под каждой строкой «Что делает кнопка».

Подробнее (на английском)

#Только пока запущена игра

Флажокописано

Показывает строки «Что делает кнопка», только пока работает поддерживаемая игра; если выкл., они показываются и на рабочем столе.

Подробнее (на английском)

#Сквозной щелчок (применяется при запуске)

Флажокописано

Щелчки мыши проходят сквозь окно HUD в игру.

Применяется при запуске HUD: после изменения остановите и снова запустите его.

Подробнее (на английском)

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

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

Устанавливает хук DCS: Scripts\JoyProOverlay.lua и одну защищённую строку в Export.lua.

Сначала закройте DCS.

Подробнее (на английском)

#Удалить

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

Снова удаляет хук DCS: Export.lua становится байт в байт таким же, как раньше.

Сначала закройте DCS.

Подробнее (на английском)

#Проверить

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

Проверяет, установлен ли хук DCS в папке DCS, указанной в настройках.

Ничего не меняет.

Подробнее (на английском)

#Мой экран

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

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

Меняется только предпросмотр; выбор сохраняется до следующего запуска.

Подробнее (на английском)

#Показывать в стриме

Флажокописано

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

Подробнее (на английском)

#Имя

Флажокописано

Показывает название устройства на его виджете.

#Изображение

Флажокописано

Виджет заголовка игры: показывает изображение игры или ЛА DCS рядом с его названием.

#Изображение наклоняется с ручкой

Флажокописано

Наклоняет и поворачивает изображение устройства вместе с ручкой, как будто двигается настоящая ручка.

#Кнопки подсвечиваются

Флажокописано2 ×

Виджет устройства: удерживаемые кнопки подсвечиваются. Виджет ЛА: элемент управления ЛА, которому соответствует нажатая вами кнопка, подсвечивается на его ручке или РУД.

Подробнее (на английском)

#Удерживаемые кнопки по названию

Флажокописано2 ×

Виджет устройства: удерживаемые кнопки показываются как плашки с их названиями из каталога устройств.

Виджет ЛА: удерживаемые элементы управления ЛА по названиям под рукоятями.

Подробнее (на английском)

#Оси и рычаги

Флажокописано2 ×

Виджет устройства: каждая ось и каждый рычаг двигаются как полоска.

Виджет ЛА: полоска рядом с РУД с положением вашего рычага.

Подробнее (на английском)

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

Флажокописано

Пишет значение каждой оси рядом с её полоской.

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

Флажокописано2 ×

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

Подробнее (на английском)

#Хатки

Флажокописано

Показывает хатки; нажатое направление подсвечивается.

#РУС

Флажокописано

Виджет ЛА: показывает изображение собственной ручки ЛА, которая наклоняется вместе с вашей ручкой.

#РУД

Флажокописано

Виджет ЛА: показывает изображение собственного РУД ЛА, который сдвигается вместе с первым рычагом вашего РУД.