#Attiva/disattiva overlay
PulsantescrittiAvvia HUD / Ferma HUD: avvia l'HUD con le uscite selezionate sopra: legge i dispositivi se necessario, trova il gioco in esecuzione e carica le sue assegnazioni.
Premuto di nuovo, chiude tutte le uscite.
L'HUD mostra i tuoi dispositivi sullo schermo mentre giochi, come l'overlay del controller di uno streamer: l'immagine della cloche si inclina con la tua cloche, leve e assi si muovono come barre, i pulsanti tenuti premuti si illuminano con i loro nomi, e una riga dice cosa fa il pulsante premuto nel gioco in esecuzione ("Gear Toggle"). Può apparire sopra il gioco, in OBS o in entrambi, ciascuno con i suoi widget. Questa pagina è il suo editor.


flowchart LR D["I tuoi dispositivi"] --> P["L'HUD"] O["Le tue assegnazioni<br/>nel gioco"] --> P P --> S["Sul mio schermo"] P --> B["Pagina per OBS"] P --> W["Finestra di stream"]
Ferma HUD (lo stesso pulsante) lo chiude. Tutto quello che imposti qui viene conservato e c'è di nuovo dopo un riavvio.
Trascina un widget nell'anteprima per spostarlo; fai clic per modificarlo a destra. Disponi automaticamente li mette lungo il bordo inferiore: manetta e dispositivi della mano sinistra a sinistra, pedaliera al centro, la cloche della mano destra a destra.


La finestra dell'HUD è trasparente e resta sopra i giochi in finestra e senza bordi. I clic la attraversano e arrivano al gioco. Non è nella barra delle applicazioni né in Alt+Tab. Lo schermo intero esclusivo la nasconde (un limite di Windows): passa il gioco a senza bordi. La riga del pulsante premuto nomina l'azione di quel gioco e velivolo, per esempio "Weapon Release" nell'F-16C e "Fire guns" in IL-2.
Le tre uscite sono indipendenti l'una dall'altra:
| Output | Per | Come |
|---|---|---|
| Sul mio schermo (sopra il gioco) | te | una finestra trasparente sopra il gioco |
| Pagina per OBS (sorgente Browser, trasparente) | il tuo stream (consigliato) | JoyPro offre una pagina solo su questo PC; Copia mette il suo indirizzo negli appunti |
| Finestra di stream (Cattura finestra) | stream con Cattura finestra | una finestra normale (può stare dietro al gioco) con uno sfondo trasparente o chroma key |
Togli la spunta a Sul mio schermo per giocare con lo schermo pulito mentre lo stream mostra comunque l'HUD, oppure mostra widget diversi su ciascuno: ogni widget ha due spunte, un monitor (il tuo schermo) e OBS (lo stream). Anteprima: Il mio schermo / Lo stream cambia cosa mostra il designer. Aggiornamenti al secondo (max) (15, 30 o 60; 30 è fluido e leggero).
http://127.0.0.1:8765/hud).La pagina disegna i widget spuntati per lo stream, negli stessi punti e stili dell'app, su un palco di 1920 x 1080 scalato alla fonte. La porta è occupata da un altro programma? Scegline un'altra sotto Porta e copia di nuovo l'indirizzo.


Oppure Cattura finestra: spunta Finestra di stream, scegli lo sfondo (trasparente, verde, magenta, blu o un tuo colore). In OBS aggiungi Cattura finestra con Metodo di cattura: Windows 10 (1903 and up); con un colore aggiungi un filtro Chroma Key di quel colore. Se nel tuo OBS uno sfondo trasparente appare nero, usa la sorgente Browser o un colore.
Come la sorgente Browser di OBS riceve l'HUD: una pagina, poi solo le modifiche.
| # | Chi | Cosa succede |
|---|---|---|
| 1 | OBS | La sorgente Browser apre http://127.0.0.1:8765/hud. |
| 2 | JoyPro | Invia la pagina: layout, stili e immagini. |
| 3 | OBS | Apre /hud/events. Resta aperta. |
| 4 | JoyPro | Invia lo stato (assi, pulsanti, cosa fa il pulsante), al massimo 30 volte al secondo e solo quando qualcosa è cambiato. |
| 5 | JoyPro | Invia di nuovo il layout quando cambiano widget, posizioni o stili. |
Widget elenca ogni dispositivo più l'intestazione, il ticker delle assegnazioni e il widget del velivolo. Ricarica dispositivi rilegge i dispositivi collegati; Mostra tutti spunta ogni widget per il tuo schermo; Disponi automaticamente e Reimposta posizioni li mettono al loro posto.
Per ogni widget (fai clic su di esso nell'anteprima o nell'elenco):


Il widget del velivolo: cloche, manetta, barra della corsa della manetta, posizione della cloche, i comandi si illuminano, comandi tenuti premuti per nome; Velivoli (Automatica: il velivolo che piloti, o qualsiasi immagine impostata su questo PC) e Si muove con (la cloche e la manetta che lo muovono). Le sue immagini vengono dalle immagini del cockpit del gioco stesso (Cockpits > Crea immagini dai miei giochi, o un pacchetto di immagini), altrimenti dal disegno a linee di JoyPro dell'impugnatura reale.
Stile ha 40 preimpostazioni: Vetro, Neon, Minimale, stili puliti (Vetro satinato chiaro, Streamer sobrio, Streamer deciso, Compatto, Testo grande, Pastello, Solo contorni), display da cockpit (HUD militare verde, MFD ambra, PFD di linea, Glass cockpit, Visione notturna, Illuminazione cockpit rossa, Wireframe vettoriale, Terminale retrò, Warbird, Ologramma), giochi e generi (Spazio arancione, Holo ciano, Cyberpunk, Synthwave, Neon rosa, Corsa, Tattico sabbia, Blu navy e oro, Stealth, Fantasma), temi di colore (Artico, Deserto, Oceano, Tramonto, Regale, Carbonio) e leggibilità (Contrasto elevato, Contrasto elevato chiaro, Monocromatico, Monocromatico chiaro). › passa alla successiva.


Sotto: colori d'accento con un clic, Colore principale, Premuto e Opacità, poi le opzioni di design per ogni elemento: Schede (sfondo, bordo, angoli, ombra), Testo (carattere, dimensione, spaziatura delle lettere, colori, Nomi in grassetto), Indicatore della cloche (anello, quadrato, mirino, radar, punto; dimensione, bagliore), Barre e leve (forme, altezze, la parte vuota) e Pulsanti ed etichette (forme). Un'opzione cambiata rende lo stile "design personale (modificato)": Salva stile lo conserva con il tuo nome, Annulla modifiche torna alla preimpostazione, Esporta stile... / Importa stile... lo condividono come file, Elimina rimuove il tuo stile.
Cosa fa il pulsante: quante righe, quanto restano (secondi), la dimensione del carattere, Mostra dispositivo e pulsante e Solo mentre un gioco è in esecuzione. Clic passante lascia passare i clic del mouse attraverso la finestra dell'HUD (vale quando l'HUD si avvia).
JoyPro trova il gioco in esecuzione dal suo processo (DCS, IL-2, Star Citizen e ogni altro gioco che gestisce) e mostra solo le assegnazioni di quel gioco. DCS ha bisogno anche del velivolo: sceglilo sotto Velivolo DCS, oppure Installa hook DCS, così DCS comunica a JoyPro il velivolo a ogni inizio missione (un piccolo file Lua più una riga protetta in Export.lua, prima con un backup; Rimuovi rimette il file identico byte per byte; prima chiudi DCS). Verifica dice se l'hook è installato.


View model: MainWindowViewModel.Hud.cs (dispositivi, widget, disposizione), MainWindowViewModel.HudStyles.cs (preimpostazioni, stili propri, importazione/esportazione), MainWindowViewModel.HudStream.cs (uscite, pagina dello stream, widget del velivolo), MainWindowViewModel.HudAxes.cs (assi della cloche), MainWindowViewModel.Overlay.cs (avvio/arresto, gioco in esecuzione, righe dei pulsanti, hook DCS). Viste: Views/HudWindow.axaml, Views/Controls/HudSurface.axaml, HudElements.cs, HudPanel.cs. Preimpostazioni: Models/HudStylePresets.cs.
engine hud devices dà per ogni dispositivo collegato modello, tipo, mano, immagine del prodotto, assi con il loro ruolo, pulsanti con i loro nomi e id dei controlli (Controls, per il widget del velivolo) e l'immagine di layout con le posizioni dei pulsanti.engine overlay map (--game, --plane, --unit): i pulsanti assegnati con modificatori e titoli. Un'assegnazione con modificatori appare mentre i suoi modificatori sono tenuti premuti; vince l'assegnazione con più modificatori corrispondenti.engine overlay dcs-hook status / install / remove (--path, --dry-run): Scripts\JoyProOverlay.lua più una riga in Export.lua racchiusa in pcall; DCS invia il tipo di unità a 127.0.0.1:1992 (UDP). L'hook chiama le funzioni di esportazione degli altri script (SRS, Tacview) che sostituisce.Services/HudStreamServer.cs, HudStreamHub.cs, Resources/hud-stream.html; legato solo a 127.0.0.1, le richieste con un altro nome host vengono rifiutate. GET /hud (pagina), /hud/events (Server-Sent Events: layout, state), /hud/img/<id> (immagini come PNG), /hud/state (JSON). Senza una pagina collegata resta solo in ascolto.Services/HudInputPump.cs tiene solo l'ultimo report per dispositivo e li applica alla frequenza scelta; gli elementi si ridisegnano solo quando cambiano; niente viene allocato per report; le immagini vengono ritagliate una volta sola (impugnature dei velivoli alte 480 px). Misurato dal test di durata dell'HUD rispetto ai limiti di CPU, allocazioni e memoria.%APPDATA%\JoyPro2\hud.json (posizioni, dimensioni, spunte per widget per schermo e stream, lo stile con ogni opzione, stili propri, uscite, porta, sfondo, frequenza di aggiornamento). File di stile: *.joypro-hudstyle.json ("format": "joypro-hud-style").Riferimento: hud.
La documentazione delle funzioni dietro questa pagina, generata dal repository:
42 controlli, letti dal codice sorgente del programma: 42 scritti, 0 con i dati del codice sorgente (tooltip, commento nel codice, chiamata al motore), 0 ancora da ampliare.
Avvia HUD / Ferma HUD: avvia l'HUD con le uscite selezionate sopra: legge i dispositivi se necessario, trova il gioco in esecuzione e carica le sue assegnazioni.
Premuto di nuovo, chiude tutte le uscite.
Tooltip L'HUD trasparente sopra il gioco. Deselezionalo per tenere libero il tuo schermo mentre lo stream continua a mostrare l'HUD.
Mostra l'HUD come finestra trasparente sopra il gioco.
Deselezionalo per mantenere pulito il tuo schermo mentre lo stream mostra comunque l'HUD.
Tooltip JoyPro fornisce l'HUD come pagina web, solo su questo PC. In OBS aggiungi una sorgente Browser con questo indirizzo: lo sfondo è trasparente, non serve CSS personalizzato.
Mentre l'HUD è in esecuzione, JoyPro lo fornisce come pagina web solo su questo PC per una Browser Source di OBS: sfondo trasparente, nessun CSS personalizzato.
Se selezionato, sotto vengono mostrati l'indirizzo con Copia e la Porta.
Copia negli appunti l'indirizzo della pagina OBS.
In OBS: Sources > + > Browser, incollalo come URL, larghezza 1920, altezza 1080.
Tooltip Una finestra a sé, non in primo piano: può stare dietro al gioco. In OBS: Cattura finestra con il metodo di cattura Windows 10 (1903 and up); con un colore chroma key aggiungi un filtro Chroma Key.
Mentre l'HUD è in esecuzione, apre una finestra propria per la Window Capture di OBS, con sfondo trasparente o un colore chroma key scelto sotto.
In OBS: metodo di cattura Windows 10, e un filtro Chroma Key per un colore.
La spunta monitor di un widget nell'elenco: lo mostra sul tuo schermo.
La spunta OBS di un widget nell'elenco: lo mostra nello stream.
Rilegge i dispositivi collegati: i nuovi dispositivi ricevono un widget, le immagini e i nomi dei pulsanti vengono aggiornati.
Usalo dopo aver collegato un dispositivo.
Seleziona tutti i widget per il tuo schermo. Deseleziona nell'elenco quelli che non vuoi.
Tooltip Manetta e mano sinistra a sinistra, pedaliera al centro, cloche della mano destra a destra, lungo il bordo inferiore
Dispone in basso i widget dei dispositivi mostrati sul tuo schermo: manetta e dispositivi della mano sinistra a sinistra, pedaliera al centro, la cloche della mano destra a destra; ciò che non entra va una riga più su.
Le nuove posizioni vengono mantenute.
Riporta ogni widget alla sua posizione e dimensione predefinite; ciò che mostra ogni widget resta.
Tooltip Stile successivo
Passa l'HUD alla voce successiva dell'elenco Stile.
Dà allo stile questo colore d'accento. L'HUD lo adotta subito; lo stile appare come "design personale" finché non lo salvi.
Mostra i nomi dei widget in grassetto. Fa parte dello stile: lo cambia in "design personale" finché non lo salvi.
Conserva il design attuale come tuo stile con il nome scritto accanto e lo rende lo stile dell'HUD.
Il nome di un preset viene rifiutato; un tuo stile con lo stesso nome viene sostituito.
Legge un file di stile e lo rende uno dei tuoi stili e lo stile dell'HUD.
Un nome che usi già riceve un numero.
Salva il design attuale come file di stile da condividere o conservare; l'HUD non cambia.
Tooltip Torna allo stile scelto sopra
Riporta il design allo stile che avevi prima delle modifiche manuali: lo stile scelto, salvato o importato per ultimo.
Elimina il tuo stile scelto. I widget che lo usavano tornano allo stile dell'HUD; l'HUD mantiene il suo aspetto attuale.
Aggiunge il dispositivo e il pulsante sotto ogni riga di Cosa fa il pulsante.
Mostra le righe Cosa fa il pulsante solo mentre è in esecuzione un gioco supportato; se disattivato, compaiono anche sul desktop.
I clic del mouse passano attraverso la finestra dell'HUD fino al gioco.
Applicato all'avvio dell'HUD: fermalo e riavvialo dopo aver cambiato questa impostazione.
Installa l'hook DCS: Scripts\JoyProOverlay.lua e una riga protetta in Export.lua.
Chiudi prima DCS.
Rimuove di nuovo l'hook DCS: Export.lua è identico byte per byte a prima.
Chiudi prima DCS.
Verifica se l'hook DCS è installato nella cartella DCS indicata nelle Impostazioni.
Non modifica nulla.
Il mio schermo / Lo stream: cosa mostra l'anteprima del designer, i widget selezionati per il tuo schermo o quelli selezionati per lo stream.
Cambia solo l'anteprima; la scelta viene mantenuta per il prossimo avvio.
Mostra il widget selezionato sul tuo schermo.
Mostra il widget selezionato nello stream: la pagina OBS e la finestra dello stream.
Mostra il nome del dispositivo sul suo widget.
Widget dell'intestazione del gioco: mostra l'immagine del gioco o del velivolo DCS accanto al suo nome.
Mostra il tipo del dispositivo sotto il suo nome.
Mostra l'immagine del dispositivo.
Inclina e ruota l'immagine del dispositivo con la cloche, come se si muovesse la cloche reale.
Widget del dispositivo: i pulsanti premuti si illuminano. Widget del velivolo: si illumina sulla sua cloche o manetta il comando del velivolo che corrisponde al pulsante che premi.
Widget del dispositivo: i pulsanti premuti compaiono come etichette con i loro nomi dal catalogo dispositivi.
Widget del velivolo: i comandi premuti del velivolo, per nome, sotto le impugnature.
Widget del dispositivo: ogni asse e leva si muove come una barra.
Widget del velivolo: una barra accanto alla manetta con la posizione della tua leva.
Scrive il nome di ogni asse accanto alla sua barra.
Scrive il valore di ogni asse accanto alla sua barra.
Mostra l'elemento cloche: un punto in un anello alla posizione della cloche, con una tacca per la torsione.
Mostra gli hat; la direzione premuta si illumina.
Widget del velivolo: mostra l'immagine della cloche propria del velivolo, che si inclina con la tua cloche.
Widget del velivolo: mostra l'immagine della manetta propria del velivolo, che scorre con la prima leva della tua manetta.