JoyPro2 Discord GitHub
Strony GUI

HUD

Pokaż:

HUD pokazuje Twoje urządzenia na ekranie podczas gry, jak nakładka kontrolera u streamera: obraz drążka przechyla się razem z Twoim drążkiem, dźwignie i osie poruszają się jako paski, trzymane przyciski podświetlają się ze swoimi nazwami, a linia mówi, co naciśnięty przycisk robi w uruchomionej grze ("Gear Toggle"). Może być widoczny nad grą, w OBS albo w obu miejscach, każde z własnymi widżetami. Ta strona to jego projektant.

Projektant HUD z podglądem na żywoProjektant HUD z podglądem na żywo
Projektant HUD z podglądem na żywo (Obrazy pokazują aplikację po angielsku.)
flowchart LR
  D["Twoje urządzenia"] --> P["HUD"]
  O["Twoje przypisania<br/>w grze"] --> P
  P --> S["Na moim ekranie"]
  P --> B["Strona dla OBS"]
  P --> W["Okno streamu"]
HUD odczytuje Twoje urządzenia i przypisania w uruchomionej grze i pokazuje je naraz w maksymalnie trzech miejscach: na Twoim ekranie nad grą, na stronie dla OBS i w oknie streamu.
Dla początkujących

#Uruchom HUD trzema kliknięciami

  1. Otwórz HUD na dolnym pasku. Podgląd porusza się już, gdy ruszasz drążkiem.
  2. Zostaw zaznaczone Na moim ekranie (nad grą).
  3. Naciśnij Uruchom HUD (także na stronie Start). Uruchom grę: HUD jest nad nią i nigdy nie zabiera grze myszy ani klawiatury.

Zatrzymaj HUD (ten sam przycisk) go zamyka. Wszystko, co tu ustawisz, zostaje zachowane i jest znowu po ponownym uruchomieniu.

#Co jest na ekranie

  • Jeden widżet na urządzenie: drążki, przepustnice i pedały są pokazane od początku, panele i klawiatury są ukryte (zaznacz je na liście Widżety). Każdy widżet może pokazać zdjęcie urządzenia, pozycję drążka, osie jako paski, przyciski i haty.
  • Widżet maszyny: drążek i przepustnica maszyny, którą latasz, tak jak rysuje je gra, poruszające się razem z Twoimi.
  • Nagłówek gry: gra lub maszyna DCS z jej obrazem.
  • Co robi przycisk: ostatnio naciśnięte przyciski z ich akcją w uruchomionej grze.

Przeciągnij widżet w podglądzie, aby go przesunąć; kliknij go, aby zmienić go po prawej. Rozmieść automatycznie ustawia je wzdłuż dołu: przepustnica i urządzenia dla lewej ręki po lewej, pedały pośrodku, drążek dla prawej ręki po prawej.

Widżet maszyny: drążek i przepustnica samej maszynyWidżet maszyny: drążek i przepustnica samej maszyny
Widżet maszyny: drążek i przepustnica samej maszyny
W grze: Co widzisz w grze

Okno HUD jest przezroczyste i pozostaje nad grami w oknie i w trybie bez ramki. Kliknięcia przechodzą przez nie do gry. Nie ma go na pasku zadań ani w Alt+Tab. Wyłączny tryb pełnoekranowy je ukrywa (ograniczenie Windows): przełącz grę na tryb bez ramki. Linia naciśniętego przycisku podaje akcję tej gry i maszyny, na przykład "Weapon Release" w F-16C i "Fire guns" w IL-2.

Zaawansowane

#Gdzie widać HUD

Trzy wyjścia są od siebie niezależne:

Wyjście Dla Jak
Na moim ekranie (nad grą) Ciebie przezroczyste okno nad grą
Strona dla OBS (źródło Przeglądarka, przezroczysta) Twojego streamu (zalecane) JoyPro udostępnia stronę tylko na tym PC; Kopiuj umieszcza jej adres w schowku
Okno streamu (Przechwytywanie okna) streamów z Przechwytywaniem okna zwykłe okno (może być za grą) z przezroczystym tłem albo tłem do kluczowania koloru (chroma key)

Odznacz Na moim ekranie, aby grać z czystym ekranem, gdy stream nadal pokazuje HUD, albo pokazuj różne widżety w każdym miejscu: każdy widżet ma dwa pola wyboru, monitor (Twój ekran) i OBS (stream). Podgląd: Mój ekran / Stream przełącza, co pokazuje projektant. Maks. odświeżeń na sekundę (15, 30 lub 60; 30 jest płynne i lekkie).

#Konfiguracja OBS (źródło Przeglądarka)

  1. Zaznacz Strona dla OBS (źródło Przeglądarka, przezroczysta) i naciśnij Uruchom HUD.
  2. Naciśnij Kopiuj obok adresu (http://127.0.0.1:8765/hud).
  3. W OBS: Sources > + > Browser. Wklej adres jako URL, Width 1920, Height 1080. Nic więcej nie trzeba: tło jest przezroczyste, bez własnego CSS.
  4. Opcjonalnie: zaznacz Shutdown source when not visible, aby OBS zatrzymywał stronę w scenach, w których jej nie ma.

Strona rysuje widżety zaznaczone dla streamu, w tych samych miejscach i stylach co aplikacja, na scenie 1920 x 1080 przeskalowanej do źródła. Port zajęty przez inny program? Wybierz inny w Port i skopiuj adres jeszcze raz.

Strona streamu tak, jak pokazuje ją OBSStrona streamu tak, jak pokazuje ją OBS
Strona streamu tak, jak pokazuje ją OBS

Zamiast tego Przechwytywanie okna: zaznacz Okno streamu, wybierz tło (przezroczyste, zielone, magenta, niebieskie albo własny kolor). W OBS dodaj Window Capture z Capture Method: Windows 10 (1903 and up); przy kolorze dodaj filtr Chroma Key w tym kolorze. Jeśli przezroczyste tło jest w Twoim OBS czarne, użyj źródła Przeglądarka albo koloru.

Jak źródło Przeglądarka w OBS dostaje HUD: jedna strona, potem tylko zmiany.

# Kto Co się dzieje
1 OBS Źródło Przeglądarka otwiera http://127.0.0.1:8765/hud.
2 JoyPro Wysyła stronę: układ, style i obrazy.
3 OBS Otwiera /hud/events. Połączenie zostaje otwarte.
4 JoyPro Wysyła stan (osie, przyciski, co robi przycisk), najwyżej 30 razy na sekundę i tylko wtedy, gdy coś się zmieniło.
5 JoyPro Wysyła układ ponownie, gdy zmieniają się widżety, miejsca lub style.

#Widżety

Widżety wymienia każde urządzenie oraz nagłówek, pasek przypisań i widżet maszyny. Wczytaj urządzenia ponownie ponownie odczytuje podłączone urządzenia; Pokaż wszystko zaznacza każdy widżet dla Twojego ekranu; Rozmieść automatycznie i Resetuj położenia ustawiają je na miejscu.

Dla każdego widżetu (kliknij go w podglądzie lub na liście):

  • Pokaż na moim ekranie, Pokaż w streamie, Rozmiar, Styl tego widżetu (styl HUD albo dowolny inny).
  • Pokaż: nazwa, rodzaj (drążek, przepustnica), obraz, obraz przechylający się z drążkiem, podświetlanie przycisków, nazwy trzymanych przycisków, osie i dźwignie, nazwy osi, wartości osi, pozycja drążka (gimbal), haty. Widżet nagłówka: jego obraz.
  • Obraz: Zdjęcie (obraz producenta z wyciętym tłem), Układ (Twój obraz układu JoyPro ze strony Układ, z podświetlonymi wciśniętymi przyciskami w ich miejscu), Auto (zdjęcie, jeśli jest).
  • Rękojeść na tej podstawie: dla podstaw, które przyjmują kilka rękojeści (VPforce Rhino, Virpil WarBRD); rękojeść decyduje o obrazie i nazwach przycisków.
  • Osie drążka: skąd pochodzą X, Y i Twist elementu drążka. Automatycznie bierze własne osie urządzenia; rękojeść, która jest osobnym urządzeniem bez osi, bierze je z podstawy, na której siedzi.
Wybrany widżet urządzenia: co pokazuje, jego obraz i osie drążkaWybrany widżet urządzenia: co pokazuje, jego obraz i osie drążka
Wybrany widżet urządzenia: co pokazuje, jego obraz i osie drążka

Widżet maszyny: drążek, przepustnica, pasek skoku przepustnicy, pozycja drążka, podświetlanie elementów, nazwy trzymanych elementów; Maszyny (Automatycznie: maszyna, którą lecisz, albo dowolny obraz ustawiony na tym PC) i Porusza się z (drążek i przepustnica, które ją poruszają). Jej obrazy pochodzą z obrazów kokpitów samej gry (Kokpity > Utwórz obrazy z moich gier albo paczka obrazów), a w przeciwnym razie z rysunku liniowego prawdziwej rękojeści wykonanego przez JoyPro.

#40 stylów

Styl ma 40 gotowych ustawień: Szkło, Neon, Minimalny, proste (Matowe szkło, jasny, Streamer, prosty, Streamer, wyrazisty, Kompaktowy, Duży tekst, Pastelowy, Tylko kontury), wyświetlacze kokpitu (Wojskowy zielony HUD, Bursztynowy MFD, PFD samolotu pasażerskiego, Szklany kokpit, Noktowizja, Czerwone oświetlenie kokpitu, Wektorowa siatka, Terminal retro, Warbird, Hologram), gry i gatunki (Kosmiczny pomarańczowy, Holo cyjan, Cyberpunk, Synthwave, Neonowy róż, Wyścigowy, Taktyczny piaskowy, Granat i złoto, Stealth, Duch), motywy kolorów (Arktyka, Pustynia, Ocean, Zachód słońca, Królewski, Karbon) i czytelność (Wysoki kontrast, Wysoki kontrast, jasny, Monochromatyczny, Monochromatyczny jasny). › przechodzi do następnego.

Kilka z 40 stylówKilka z 40 stylów
Kilka z 40 stylów

Poniżej: kolory akcentu jednym kliknięciem, Akcent, Wciśnięte i Krycie, potem opcje wyglądu dla każdego elementu: Karty (tło, ramka, narożniki, cień), Tekst (czcionka, rozmiar, odstęp liter, kolory, Pogrubione nazwy), Wskaźnik drążka (pierścień, kwadrat, celownik, radar, kropka; rozmiar, poświata), Paski i dźwignie (kształty, wysokości, pusta część) oraz Przyciski i plakietki (kształty). Zmieniona opcja sprawia, że styl staje się „własnym projektem (zmienionym)”: Zapisz styl zachowuje go pod Twoją nazwą, Cofnij zmiany wraca do gotowego ustawienia, Eksportuj styl... / Importuj styl... udostępniają go jako plik, Usuń usuwa Twój własny styl.

#Co robi przycisk i maszyna DCS

Co robi przycisk: ile linii, jak długo zostają (sekundy), rozmiar czcionki, Pokaż urządzenie i przycisk i Tylko gdy gra działa. Przepuszczanie kliknięć przepuszcza kliknięcia myszy przez okno HUD (działa przy uruchomieniu HUD).

JoyPro znajduje uruchomioną grę po jej procesie (DCS, IL-2, Star Citizen i każda inna obsługiwana gra) i pokazuje tylko przypisania tej gry. DCS potrzebuje też maszyny: wybierz ją w Maszyna DCS albo użyj Zainstaluj hook DCS, aby DCS przy każdym starcie misji podawał JoyPro maszynę (mały plik Lua plus jedna zabezpieczona linia w Export.lua, najpierw zapisywana jest kopia zapasowa; Usuń przywraca plik bajt w bajt; najpierw zamknij DCS). Sprawdź mówi, czy hook jest zainstalowany.

HUD nad grąHUD nad grą
HUD nad grą
Szczegóły techniczne

#Co stoi za stroną

Model widoku: MainWindowViewModel.Hud.cs (urządzenia, widżety, układ), MainWindowViewModel.HudStyles.cs (gotowe style, własne style, import/eksport), MainWindowViewModel.HudStream.cs (wyjścia, strona streamu, widżet maszyny), MainWindowViewModel.HudAxes.cs (osie drążka), MainWindowViewModel.Overlay.cs (start/stop, uruchomiona gra, linie przycisków, hook DCS). Widoki: Views/HudWindow.axaml, Views/Controls/HudSurface.axaml, HudElements.cs, HudPanel.cs. Gotowe style: Models/HudStylePresets.cs.

  • Urządzenia: engine hud devices podaje dla każdego podłączonego urządzenia model, rodzaj, rękę, zdjęcie produktu, osie z ich rolą, przyciski z nazwami i identyfikatorami elementów (Controls, dla widżetu maszyny) oraz obraz układu z położeniami przycisków.
  • Przypisania uruchomionej gry: engine overlay map (--game, --plane, --unit): przypisane przyciski z modyfikatorami i tytułami. Przypisanie z modyfikatorami jest pokazywane, gdy jego modyfikatory są trzymane; wygrywa przypisanie z największą liczbą pasujących modyfikatorów.
  • Hook DCS: engine overlay dcs-hook status / install / remove (--path, --dry-run): Scripts\JoyProOverlay.lua plus jedna linia w Export.lua opakowana w pcall; DCS wysyła typ jednostki na 127.0.0.1:1992 (UDP). Hook wywołuje funkcje eksportu innych skryptów (SRS, Tacview), które zastępuje.
  • Serwer streamu: Services/HudStreamServer.cs, HudStreamHub.cs, Resources/hud-stream.html; nasłuchuje tylko na 127.0.0.1, żądania z inną nazwą hosta są odrzucane. GET /hud (strona), /hud/events (Server-Sent Events: layout, state), /hud/img/<id> (obrazy jako PNG), /hud/state (JSON). Bez podłączonej strony tylko nasłuchuje.
  • Koszt podczas gry: Services/HudInputPump.cs trzyma tylko najnowszy raport z każdego urządzenia i stosuje je z wybraną częstotliwością; elementy są przerysowywane tylko przy zmianie; na raport nic nie jest alokowane; obrazy są przycinane raz (rękojeści maszyn 480 px wysokości). Mierzone przez długotrwały test HUD względem limitów CPU, alokacji i pamięci.
  • Ustawienia: %APPDATA%\JoyPro2\hud.json (położenia, rozmiary, zaznaczenia każdego widżetu dla ekranu i streamu, styl z każdą opcją, własne style, wyjścia, port, tło, częstotliwość odświeżania). Pliki stylów: *.joypro-hudstyle.json ("format": "joypro-hud-style").

Dokumentacja: hud.

#Źródło

Dokumentacja funkcji stojąca za tą stroną, wygenerowana z repozytorium:

#Wszystkie elementy sterujące na tej stronie

Elementy sterowania odczytane z kodu źródłowego programu: 42; opisane: 42, z faktami z kodu (podpowiedź, komentarz w kodzie, wywołanie silnika): 0, jeszcze do rozbudowania: 0.

#Przełącz nakładkę

Przyciskopisane

Uruchom HUD / Zatrzymaj HUD: uruchamia HUD z wyjściami zaznaczonymi powyżej: w razie potrzeby odczytuje urządzenia, znajduje działającą grę i wczytuje jej przypisania.

Naciśnięty ponownie zamyka każde wyjście.

Więcej szczegółów (po angielsku)

#Na moim ekranie (nad grą)

Pole wyboruopisane

Podpowiedź Przezroczysty HUD nad grą. Odznacz, aby twój ekran pozostał czysty, a stream nadal pokazywał HUD.

Pokazuje HUD jako przezroczyste okno nad grą.

Odznacz to, aby Twój ekran był czysty, a stream nadal pokazywał HUD.

Więcej szczegółów (po angielsku)

#Strona dla OBS (źródło Przeglądarka, przezroczysta)

Pole wyboruopisane

Podpowiedź JoyPro udostępnia HUD jako stronę internetową tylko na tym komputerze. W OBS dodaj źródło Przeglądarka z tym adresem: tło jest przezroczyste, własny CSS nie jest potrzebny.

Gdy HUD działa, JoyPro udostępnia go jako stronę internetową tylko na tym komputerze dla Źródła przeglądarki w OBS: przezroczyste tło, bez własnego CSS.

Gdy zaznaczone, poniżej widać adres z Kopiuj i Port.

Więcej szczegółów (po angielsku)

#Kopiuj

Przyciskopisane

Kopiuje adres strony OBS do schowka.

W OBS: Źródła > + > Przeglądarka, wklej go jako URL, szerokość 1920, wysokość 1080.

Więcej szczegółów (po angielsku)

#Okno streamu (Przechwytywanie okna)

Pole wyboruopisane

Podpowiedź Osobne okno, nie na wierzchu: może leżeć za grą. W OBS: Przechwytywanie okna z metodą przechwytywania Windows 10 (1903 i nowsze); przy kolorze kluczowania dodaj filtr Chroma Key.

Gdy HUD działa, otwiera osobne okno dla Przechwytywania okna w OBS, z przezroczystym tłem albo kolorem kluczowania (chroma key) wybranym poniżej.

W OBS: metoda przechwytywania Windows 10 i filtr Chroma Key dla koloru.

Więcej szczegółów (po angielsku)

#Wczytaj urządzenia ponownie

Przyciskopisane

Ponownie odczytuje podłączone urządzenia: nowe urządzenia dostają widżet, obrazy i nazwy przycisków są odświeżane.

Użyj tego po podłączeniu urządzenia.

Więcej szczegółów (po angielsku)

#Rozmieść automatycznie

Przyciskopisane

Podpowiedź Przepustnica i lewa ręka po lewej, pedały pośrodku, drążek prawej ręki po prawej, wzdłuż dołu

Umieszcza widżety urządzeń pokazywane na Twoim ekranie wzdłuż dolnej krawędzi: przepustnicę i urządzenia dla lewej ręki po lewej, pedały na środku, drążek dla prawej ręki po prawej; to, co się nie mieści, trafia rząd wyżej.

Nowe miejsca są zachowywane.

Więcej szczegółów (po angielsku)

#Kolor akcentu

Przyciskopisane

Daje stylowi ten kolor akcentu. HUD od razu go przejmuje; styl jest pokazywany jako "własny wygląd", dopóki go nie zapiszesz.

Więcej szczegółów (po angielsku)

#Zapisz styl

Przyciskopisane

Zachowuje obecny wygląd jako Twój własny styl pod nazwą wpisaną obok i ustawia go jako styl HUD.

Nazwa gotowego stylu jest odrzucana; Twój styl o tej samej nazwie zostaje zastąpiony.

Więcej szczegółów (po angielsku)

#Importuj styl...

Przyciskopisane

Wczytuje plik stylu i ustawia go jako jeden z Twoich stylów i jako styl HUD.

Nazwa, której już używasz, dostaje numer.

Więcej szczegółów (po angielsku)

#Cofnij zmiany

Przyciskopisane

Podpowiedź Powrót do stylu wybranego powyżej

Przywraca wygląd do stylu, który miałeś przed ręcznymi zmianami: stylu ostatnio wybranego, zapisanego lub zaimportowanego.

Więcej szczegółów (po angielsku)

#Tylko gdy gra działa

Pole wyboruopisane

Pokazuje wiersze Co robi przycisk tylko wtedy, gdy działa obsługiwana gra; gdy wyłączone, pokazują się też na pulpicie.

Więcej szczegółów (po angielsku)

#Przepuszczanie kliknięć (działa po uruchomieniu)

Pole wyboruopisane

Kliknięcia myszy przechodzą przez okno HUD do gry.

Stosowane przy starcie HUD: po zmianie tego zatrzymaj go i uruchom ponownie.

Więcej szczegółów (po angielsku)

#Mój ekran

Opcjaopisane2 ×

Mój ekran / Stream: co pokazuje podgląd projektanta – widżety zaznaczone dla Twojego ekranu albo te zaznaczone dla streamu.

Zmienia się tylko podgląd; wybór jest zachowywany do następnego startu.

Więcej szczegółów (po angielsku)

#Nazwa

Pole wyboruopisane

Pokazuje nazwę urządzenia na jego widżecie.

#Obraz

Pole wyboruopisane

Widżet nagłówka gry: pokazuje obraz gry lub maszyny DCS obok jej nazwy.

#Obraz przechyla się z drążkiem

Pole wyboruopisane

Przechyla i skręca obraz urządzenia razem z drążkiem, jakby ruszał się prawdziwy drążek.

#Przyciski się podświetlają

Pole wyboruopisane2 ×

Widżet urządzenia: przytrzymane przyciski się podświetlają. Widżet maszyny: element sterujący maszyny, któremu odpowiada Twój wciśnięty przycisk, podświetla się na jej drążku lub przepustnicy.

Więcej szczegółów (po angielsku)

#Nazwy przytrzymanych przycisków

Pole wyboruopisane2 ×

Widżet urządzenia: przytrzymane przyciski są pokazywane jako etykiety z nazwami z katalogu urządzeń.

Widżet maszyny: przytrzymane elementy sterujące maszyny z nazwami pod rękojeściami.

Więcej szczegółów (po angielsku)

#Osie i dźwignie

Pole wyboruopisane2 ×

Widżet urządzenia: każda oś i dźwignia porusza się jako pasek.

Widżet maszyny: pasek obok przepustnicy z pozycją Twojej dźwigni.

Więcej szczegółów (po angielsku)

#Wartości osi

Pole wyboruopisane

Wpisuje wartość każdej osi obok jej paska.

#Haty

Pole wyboruopisane

Pokazuje haty; wciśnięty kierunek się podświetla.

#Drążek

Pole wyboruopisane

Widżet maszyny: pokazuje obraz drążka tej maszyny, który przechyla się razem z Twoim drążkiem.

#Przepustnica

Pole wyboruopisane

Widżet maszyny: pokazuje obraz przepustnicy tej maszyny, który przesuwa się razem z pierwszą dźwignią Twojej przepustnicy.