JoyPro2 Discord GitHub
GUI-pagina's

HUD

Tonen:

De HUD toont je apparaten op het scherm terwijl je speelt, net als de controller-overlay van een streamer: de afbeelding van de stick kantelt mee met je stick, hendels en assen bewegen als balken, ingedrukte knoppen lichten op met hun namen, en een regel zegt wat de ingedrukte knop in de draaiende game doet ("Gear Toggle"). Hij kan over de game verschijnen, in OBS, of allebei, elk met eigen widgets. Deze pagina is de ontwerper ervan.

De HUD-ontwerper met het livevoorbeeldDe HUD-ontwerper met het livevoorbeeld
De HUD-ontwerper met het livevoorbeeld (De afbeeldingen tonen de app in het Engels.)
flowchart LR
  D["Je apparaten"] --> P["De HUD"]
  O["Je toewijzingen<br/>in de game"] --> P
  P --> S["Op mijn scherm"]
  P --> B["Pagina voor OBS"]
  P --> W["Streamvenster"]
De HUD leest je apparaten en je toewijzingen in de draaiende game, en toont ze op maximaal drie plekken tegelijk: op je scherm over de game, op een pagina voor OBS en in een streamvenster.
Voor beginners

#De HUD starten in drie klikken

  1. Open HUD in de onderste balk. Het voorbeeld beweegt al als je je stick beweegt.
  2. Laat Op mijn scherm (over de game) aangevinkt.
  3. Druk op HUD starten (ook op de pagina Start). Start je game: de HUD ligt erbovenop en neemt de muis of het toetsenbord nooit van de game af.

HUD stoppen (dezelfde knop) sluit hem. Alles wat je hier instelt blijft bewaard en is er na een herstart weer.

#Wat er op het scherm staat

  • Eén widget per apparaat: sticks, throttles en pedalen worden in het begin getoond, panelen en toetsenborden zijn verborgen (vink ze aan in de lijst Widgets). Elke widget kan de foto van het apparaat tonen, de stickpositie, de assen als balken, de knoppen en hats.
  • De toestelwidget: de stick en throttle van het toestel dat je vliegt, zoals de game ze tekent, en ze bewegen mee met de jouwe.
  • De gamekop: de game of het DCS-toestel met zijn afbeelding.
  • Wat de knop doet: de laatst ingedrukte knoppen met hun actie in de draaiende game.

Sleep een widget in het voorbeeld om hem te verplaatsen; klik erop om hem rechts te wijzigen. Automatisch schikken zet ze langs de onderkant: throttle en apparaten voor de linkerhand links, pedalen in het midden, de stick voor de rechterhand rechts.

De toestelwidget: de eigen stick en throttle van het toestelDe toestelwidget: de eigen stick en throttle van het toestel
De toestelwidget: de eigen stick en throttle van het toestel
In de game: Wat je in de game ziet

Het HUD-venster is doorzichtig en blijft boven games in een venster en randloze games. Klikken gaan erdoorheen naar de game. Het staat niet in de taakbalk of in Alt+Tab. Exclusief volledig scherm verbergt het (een beperking van Windows): zet de game op randloos. De regel van de ingedrukte knop noemt de actie van die game en dat toestel, bijvoorbeeld "Weapon Release" in de F-16C en "Fire guns" in IL-2.

Geavanceerd

#Waar de HUD verschijnt

De drie uitvoeren staan los van elkaar:

Uitvoer Voor Hoe
Op mijn scherm (over de game) jou een transparant venster boven op de game
Pagina voor OBS (Browser Source, transparant) je stream (aanbevolen) JoyPro biedt een pagina aan, alleen op deze pc; Kopiëren zet het adres ervan op het klembord
Streamvenster (Window Capture) streamt met Window Capture een normaal venster (kan achter de game zitten) met een transparante of chroma-key-achtergrond

Vink Op mijn scherm uit om met een schoon scherm te spelen terwijl de stream de HUD nog toont, of toon op elk andere widgets: elke widget heeft twee vinkjes, een monitor (je scherm) en OBS (de stream). Voorbeeld: Mijn scherm / De stream wisselt wat de ontwerper toont. Max. updates per seconde (15, 30 of 60; 30 is vloeiend en licht).

#OBS instellen (Browser Source)

  1. Vink Pagina voor OBS (Browser Source, transparant) aan en druk op HUD starten.
  2. Druk op Kopiëren naast het adres (http://127.0.0.1:8765/hud).
  3. In OBS: Sources > + > Browser. Plak het adres als URL, Width 1920, Height 1080. Meer is niet nodig: de achtergrond is transparant, geen eigen CSS.
  4. Optioneel: vink Shutdown source when not visible aan, zodat OBS de pagina stopt in scènes zonder de pagina.

De pagina tekent de widgets die voor de stream zijn aangevinkt, op dezelfde plekken en in dezelfde stijlen als de app, op een podium van 1920 x 1080 dat wordt geschaald naar de bron. Is de poort bezet door een ander programma? Kies een andere onder Poort en kopieer het adres opnieuw.

De streampagina zoals OBS hem toontDe streampagina zoals OBS hem toont
De streampagina zoals OBS hem toont

In plaats daarvan Window Capture: vink Streamvenster aan en kies de achtergrond (transparant, groen, magenta, blauw of je eigen kleur). Voeg in OBS Window Capture toe met Capture Method: Windows 10 (1903 and up); voeg bij een kleur een Chroma Key-filter in die kleur toe. Toont een transparante achtergrond zwart in je OBS, gebruik dan de Browser Source of een kleur.

Hoe de OBS Browser Source de HUD krijgt: één pagina, daarna alleen de wijzigingen.

# Wie Wat er gebeurt
1 OBS De Browser Source opent http://127.0.0.1:8765/hud.
2 JoyPro Stuurt de pagina: lay-out, stijlen en afbeeldingen.
3 OBS Opent /hud/events. Die blijft open.
4 JoyPro Stuurt de toestand (assen, knoppen, wat de knop doet), hooguit 30 keer per seconde en alleen als er iets veranderd is.
5 JoyPro Stuurt de lay-out opnieuw als widgets, plekken of stijlen veranderen.

#Widgets

Widgets toont elk apparaat plus de kop, de toewijzingsticker en de toestelwidget. Apparaten opnieuw laden leest de aangesloten apparaten opnieuw; Alles tonen vinkt elke widget aan voor je scherm; Automatisch schikken en Plekken herstellen zetten ze op hun plaats.

Per widget (klik erop in het voorbeeld of in de lijst):

  • Tonen op mijn scherm, Tonen in de stream, Grootte, Stijl van deze widget (de stijl van de HUD of een andere).
  • Tonen: naam, soort (stick, throttle), afbeelding, afbeelding kantelt met de stick, knoppen lichten op, vastgehouden knoppen op naam, assen en hendels, asnamen, aswaarden, stickpositie (gimbal), hats. De kopwidget: zijn afbeelding.
  • Afbeelding: Foto (de afbeelding van de fabrikant, achtergrond weggesneden), Lay-out (je lay-outafbeelding van JoyPro van de pagina Lay-out, met de ingedrukte knoppen verlicht op hun plek), Auto (de foto als die er is).
  • Grip op deze basis: voor bases die meerdere grips aannemen (VPforce Rhino, Virpil WarBRD); de grip bepaalt de afbeelding en de knopnamen.
  • Stickassen: waar X, Y en Twist van het stickelement vandaan komen. Automatisch neemt de eigen assen van het apparaat; een grip die een apart apparaat zonder assen is, neemt ze van de basis waarop hij zit.
Een geselecteerde apparaatwidget: wat hij toont, zijn afbeelding en stickassenEen geselecteerde apparaatwidget: wat hij toont, zijn afbeelding en stickassen
Een geselecteerde apparaatwidget: wat hij toont, zijn afbeelding en stickassen

De toestelwidget: stick, throttle, balk met throttle-uitslag, stickpositie, bedieningselementen lichten op, vastgehouden bedieningselementen op naam; Toestellen (Automatisch: het toestel waarmee je vliegt, of een afbeeldingenset op deze pc) en Beweegt mee met (de stick en throttle die hem bewegen). Zijn afbeeldingen komen uit de eigen cockpitafbeeldingen van de game (Cockpits > Afbeeldingen maken uit mijn games, of een afbeeldingenpakket), anders uit de lijntekening van JoyPro van de echte grip.

#De 40 stijlen

Stijl heeft 40 voorinstellingen: Glas, Neon, Minimaal, strakke (Matglas licht, Streamer strak, Streamer krachtig, Compact, Grote tekst, Pastel, Alleen contouren), cockpitdisplays (Militaire HUD groen, MFD amber, Verkeersvliegtuig-PFD, Glazen cockpit, Nachtzicht, Rode cockpitverlichting, Vector-draadmodel, Retroterminal, Warbird, Hologram), games en genres (Ruimte oranje, Holo cyaan, Cyberpunk, Synthwave, Neonroze, Racen, Tactisch zand, Marineblauw en goud, Stealth, Spook), kleurthema's (Arctisch, Woestijn, Oceaan, Zonsondergang, Koninklijk, Carbon) en leesbaarheid (Hoog contrast, Hoog contrast licht, Monochroom, Monochroom licht). › gaat naar de volgende.

Een paar van de 40 stijlenEen paar van de 40 stijlen
Een paar van de 40 stijlen

Daaronder: accentkleuren met één klik, Accent, Ingedrukt en Dekking, daarna de ontwerpopties per element: Kaarten (achtergrond, rand, hoeken, schaduw), Tekst (lettertype, grootte, letterafstand, kleuren, Vette namen), Stick-weergave (ring, vierkant, dradenkruis, radar, punt; grootte, gloed), Balken en hendels (vormen, hoogtes, het lege deel) en Knoppen en labels (vormen). Een gewijzigde optie maakt van de stijl "Eigen ontwerp (gewijzigd)": Stijl opslaan bewaart hem onder je eigen naam, Wijzigingen ongedaan maken gaat terug naar de voorinstelling, Stijl exporteren... / Stijl importeren... delen hem als bestand, Verwijderen verwijdert je eigen stijl.

#Wat de knop doet en het DCS-toestel

Wat de knop doet: hoeveel regels, hoe lang ze blijven staan (seconden), de lettergrootte, Apparaat en knop tonen en Alleen als er een game draait. Doorklikbaar laat muisklikken door het HUD-venster heen gaan (geldt bij het starten van de HUD).

JoyPro vindt de draaiende game aan zijn proces (DCS, IL-2, Star Citizen en elke andere game die het ondersteunt) en toont alleen de toewijzingen van die game. DCS heeft ook het toestel nodig: kies het onder DCS-toestel, of kies DCS-hook installeren zodat DCS JoyPro bij elke missiestart het toestel doorgeeft (een klein Lua-bestand plus één beveiligde regel in Export.lua, eerst geback-upt; Verwijderen zet het bestand byte voor byte terug; sluit DCS eerst). Controleren zegt of de hook is geïnstalleerd.

De HUD over een gameDe HUD over een game
De HUD over een game
Technische details

#Achter de pagina

Viewmodel: MainWindowViewModel.Hud.cs (apparaten, widgets, lay-out), MainWindowViewModel.HudStyles.cs (voorinstellingen, eigen stijlen, import/export), MainWindowViewModel.HudStream.cs (uitvoeren, streampagina, toestelwidget), MainWindowViewModel.HudAxes.cs (stickassen), MainWindowViewModel.Overlay.cs (starten/stoppen, draaiende game, knopregels, DCS-hook). Weergaven: Views/HudWindow.axaml, Views/Controls/HudSurface.axaml, HudElements.cs, HudPanel.cs. Voorinstellingen: Models/HudStylePresets.cs.

  • Apparaten: engine hud devices geeft van elk aangesloten apparaat het model, de soort, de hand, de productafbeelding, assen met hun rol, knoppen met hun namen en bedienings-id's (Controls, voor de toestelwidget) en de lay-outafbeelding met knopposities.
  • Toewijzingen van de draaiende game: engine overlay map (--game, --plane, --unit): de toegewezen knoppen met modifiers en titels. Een toewijzing met modifiers verschijnt zolang de modifiers worden vastgehouden; de toewijzing met de meeste passende modifiers wint.
  • DCS-hook: engine overlay dcs-hook status / install / remove (--path, --dry-run): Scripts\JoyProOverlay.lua plus één regel in Export.lua, omhuld met pcall; DCS stuurt het type eenheid naar 127.0.0.1:1992 (UDP). De hook roept de exportfuncties aan van andere scripts (SRS, Tacview) die hij vervangt.
  • Streamserver: Services/HudStreamServer.cs, HudStreamHub.cs, Resources/hud-stream.html; alleen gebonden aan 127.0.0.1, verzoeken met een andere hostnaam worden geweigerd. GET /hud (pagina), /hud/events (Server-Sent Events: layout, state), /hud/img/<id> (afbeeldingen als PNG), /hud/state (JSON). Zonder verbonden pagina luistert hij alleen.
  • Belasting tijdens het spelen: Services/HudInputPump.cs bewaart alleen het nieuwste bericht per apparaat en past ze toe in de gekozen frequentie; elementen worden alleen bij een wijziging opnieuw getekend; er wordt per bericht niets toegewezen in het geheugen; afbeeldingen worden één keer uitgesneden (toestelgrips 480 px hoog). Gemeten door de duurtest van de HUD tegen budgetten voor CPU, geheugentoewijzing en geheugen.
  • Instellingen: %APPDATA%\JoyPro2\hud.json (plekken, groottes, vinkjes per widget voor scherm en stream, de stijl met elke optie, eigen stijlen, uitvoeren, poort, achtergrond, updatefrequentie). Stijlbestanden: *.joypro-hudstyle.json ("format": "joypro-hud-style").

Naslag: hud.

#Naslag

De functiedocumentatie achter deze pagina, gemaakt uit de repository:

#Alle bedieningselementen op deze pagina

42 bedieningselementen, gelezen uit de broncode van het programma: 42 beschreven, 0 met de feiten uit de broncode (tooltip, codecommentaar, engine-aanroep), 0 nog uit te breiden.

#Overlay aan/uit

Knopbeschreven

HUD starten / HUD stoppen: start de HUD met de uitvoer die hierboven is aangevinkt: leest zo nodig de apparaten, zoekt de game die draait en laadt de toewijzingen ervan.

Nog een keer indrukken sluit elke uitvoer.

Meer details (in het Engels)

#Op mijn scherm (over de game)

Selectievakjebeschreven

Tooltip De transparante HUD boven op de game. Vink het uit om je eigen scherm vrij te houden terwijl de stream de HUD blijft tonen.

Toont de HUD als doorzichtig venster bovenop de game.

Vink het uit om je eigen scherm schoon te houden terwijl de stream de HUD nog wel toont.

Meer details (in het Engels)

#Pagina voor OBS (Browser Source, transparant)

Selectievakjebeschreven

Tooltip JoyPro biedt de HUD aan als webpagina, alleen op deze pc. Voeg in OBS een Browser Source toe met dit adres: de achtergrond is transparant, geen eigen CSS nodig.

Zolang de HUD draait, biedt JoyPro hem aan als webpagina, alleen op deze pc, voor een OBS Browser Source: doorzichtige achtergrond, geen eigen CSS.

Aangevinkt verschijnen hieronder het adres met Kopiëren en de Poort.

Meer details (in het Engels)

#Kopiëren

Knopbeschreven

Kopieert het adres van de OBS-pagina naar het klembord.

In OBS: Sources > + > Browser, plak het als URL, breedte 1920, hoogte 1080.

Meer details (in het Engels)

#Streamvenster (Window Capture)

Selectievakjebeschreven

Tooltip Een eigen venster, niet bovenop: het mag achter de game liggen. In OBS: Window Capture met de opnamemethode Windows 10 (1903 and up); voeg bij een chroma-key-kleur een Chroma Key-filter toe.

Zolang de HUD draait, opent het een eigen venster voor Window Capture van OBS, met een doorzichtige achtergrond of een chroma key-kleur die je hieronder kiest.

In OBS: opnamemethode Windows 10, en een Chroma Key-filter voor een kleur.

Meer details (in het Engels)

#Apparaten opnieuw laden

Knopbeschreven

Leest de aangesloten apparaten opnieuw in: nieuwe apparaten krijgen een widget, de afbeeldingen en knopnamen worden vernieuwd.

Gebruik het nadat je een apparaat hebt aangesloten.

Meer details (in het Engels)

#Automatisch schikken

Knopbeschreven

Tooltip Throttle en linkerhand links, pedalen in het midden, stick voor de rechterhand rechts, langs de onderkant

Zet de apparaatwidgets die op je scherm te zien zijn onderaan neer: throttle en apparaten voor de linkerhand links, pedalen in het midden, de stick voor de rechterhand rechts; wat niet past, gaat een rij hoger.

De nieuwe plekken worden bewaard.

Meer details (in het Engels)

#Plekken herstellen

Knopbeschreven

Zet elke widget terug op zijn standaardplek en -grootte; wat elke widget toont, blijft.

Meer details (in het Engels)

#Accentkleur

Knopbeschreven

Geeft de stijl deze accentkleur. De HUD neemt hem meteen over; de stijl staat als "eigen ontwerp" totdat je hem opslaat.

Meer details (in het Engels)

#Vette namen

Selectievakjebeschreven

Toont de namen van de widgets vetgedrukt. Hoort bij de stijl: verandert hem in "eigen ontwerp" totdat je opslaat.

Meer details (in het Engels)

#Stijl opslaan

Knopbeschreven

Bewaart het huidige ontwerp als je eigen stijl onder de naam die ernaast is getypt, en maakt het de stijl van de HUD.

De naam van een voorinstelling wordt geweigerd; je eigen stijl met dezelfde naam wordt vervangen.

Meer details (in het Engels)

#Stijl importeren...

Knopbeschreven

Leest een stijlbestand en maakt het een van je stijlen en de stijl van de HUD.

Een naam die je al gebruikt, krijgt een nummer.

Meer details (in het Engels)

#Stijl exporteren...

Knopbeschreven

Slaat het huidige ontwerp op als stijlbestand om te delen of te bewaren; de HUD verandert niet.

Meer details (in het Engels)

#Wijzigingen ongedaan maken

Knopbeschreven

Tooltip Terug naar de hierboven gekozen stijl

Zet het ontwerp terug naar de stijl die je had vóór de wijzigingen met de hand: de stijl die je het laatst hebt gekozen, opgeslagen of geïmporteerd.

Meer details (in het Engels)

#Verwijderen

Knopbeschreven

Verwijdert de gekozen eigen stijl. Widgets die hem gebruikten, gaan terug naar de stijl van de HUD; de HUD houdt zijn huidige uiterlijk.

Meer details (in het Engels)

#Alleen als er een game draait

Selectievakjebeschreven

Toont de regels van Wat de knop doet alleen terwijl een ondersteunde game draait; uit, dan staan ze ook op het bureaublad.

Meer details (in het Engels)

#Doorklikbaar (geldt bij starten)

Selectievakjebeschreven

Muisklikken gaan door het HUD-venster heen naar de game.

Wordt toegepast als de HUD start: stop en start hem nadat je dit hebt veranderd.

Meer details (in het Engels)

#DCS-hook installeren

Knopbeschreven

Installeert de DCS-hook: Scripts\JoyProOverlay.lua en één beveiligde regel in Export.lua.

Sluit eerst DCS.

Meer details (in het Engels)

#Mijn scherm

Optiebeschreven2 ×

Mijn scherm / De stream: wat het voorbeeld van de ontwerper toont, de widgets die voor je scherm zijn aangevinkt of die voor de stream.

Alleen het voorbeeld verandert; de keuze wordt bewaard voor de volgende start.

Meer details (in het Engels)

#Tonen in de stream

Selectievakjebeschreven

Toont de geselecteerde widget in de stream: de OBS-pagina en het streamvenster.

Meer details (in het Engels)

#Naam

Selectievakjebeschreven

Toont de naam van het apparaat op zijn widget.

#Afbeelding

Selectievakjebeschreven

Gamekopwidget: toont de afbeelding van de game of het DCS-toestel naast de naam ervan.

#Afbeelding kantelt mee met de stick

Selectievakjebeschreven

Kantelt en draait de afbeelding van het apparaat mee met de stick, alsof de echte stick bewoog.

#Knoppen lichten op

Selectievakjebeschreven2 ×

Apparaatwidget: ingedrukte knoppen lichten op. Toestelwidget: het bedieningselement van het toestel waar je ingedrukte knop voor staat, licht op op zijn stick of throttle.

Meer details (in het Engels)

#Ingedrukte knoppen met naam

Selectievakjebeschreven2 ×

Apparaatwidget: ingedrukte knoppen verschijnen als labeltjes met hun namen uit de apparaatcatalogus.

Toestelwidget: de ingedrukte bedieningselementen van het toestel met naam onder de grips.

Meer details (in het Engels)

#Assen en hendels

Selectievakjebeschreven2 ×

Apparaatwidget: elke as en hendel beweegt als balk.

Toestelwidget: een balk naast de throttle met de stand van je hendel.

Meer details (in het Engels)

#Aswaarden

Selectievakjebeschreven

Schrijft de waarde van elke as naast zijn balk.

#Stickpositie (gimbal)

Selectievakjebeschreven2 ×

Toont het stickelement: een stip in een ring op de stand van de stick, met een streepje voor het draaien.

Meer details (in het Engels)

#Hats

Selectievakjebeschreven

Toont de hats; de ingedrukte richting licht op.

#Stick

Selectievakjebeschreven

Toestelwidget: toont de eigen stickafbeelding van het toestel, die meekantelt met je stick.

#Throttle

Selectievakjebeschreven

Toestelwidget: toont de eigen throttle-afbeelding van het toestel, die meeschuift met de eerste hendel van je throttle.