JoyPro2 Discord GitHub
Pagine dell'interfaccia

HUD

Mostra:

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.

L'editor dell'HUD con l'anteprima in tempo realeL'editor dell'HUD con l'anteprima in tempo reale
L'editor dell'HUD con l'anteprima in tempo reale (Le immagini mostrano l'app in inglese.)
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"]
L'HUD legge i tuoi dispositivi e le tue assegnazioni nel gioco in esecuzione, e li mostra in un massimo di tre posti insieme: sul tuo schermo sopra il gioco, in una pagina per OBS e in una finestra di stream.
Per principianti

#Avviare l'HUD in tre clic

  1. Apri HUD nella barra in basso. L'anteprima si muove già quando muovi la cloche.
  2. Lascia spuntato Sul mio schermo (sopra il gioco).
  3. Premi Avvia HUD (anche nella pagina Start). Avvia il gioco: l'HUD sta sopra il gioco e non toglie mai al gioco il mouse o la tastiera.

Ferma HUD (lo stesso pulsante) lo chiude. Tutto quello che imposti qui viene conservato e c'è di nuovo dopo un riavvio.

#Cosa c'è sullo schermo

  • Un widget per dispositivo: cloche, manette e pedaliere sono mostrate all'inizio, pannelli e tastiere sono nascosti (spuntali nell'elenco Widget). Ogni widget può mostrare la foto del dispositivo, la posizione della cloche, gli assi come barre, i pulsanti e gli hat.
  • Il widget del velivolo: la cloche e la manetta del velivolo che piloti, come le disegna il gioco, che si muovono con le tue.
  • L'intestazione del gioco: il gioco o il velivolo DCS con la sua immagine.
  • Cosa fa il pulsante: gli ultimi pulsanti premuti con la loro azione nel gioco in esecuzione.

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.

Il widget del velivolo: la cloche e la manetta del velivolo stessoIl widget del velivolo: la cloche e la manetta del velivolo stesso
Il widget del velivolo: la cloche e la manetta del velivolo stesso
Nel gioco: Cosa vedi nel gioco

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.

Avanzate

#Dove appare l'HUD

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).

#Configurare OBS (sorgente Browser)

  1. Spunta Pagina per OBS (sorgente Browser, trasparente) e premi Avvia HUD.
  2. Premi Copia accanto all'indirizzo (http://127.0.0.1:8765/hud).
  3. In OBS: Fonti > + > Browser. Incolla l'indirizzo come URL, Larghezza 1920, Altezza 1080. Non serve altro: lo sfondo è trasparente, niente CSS personalizzato.
  4. Facoltativo: spunta Spegni la fonte quando non è visibile, così OBS ferma la pagina nelle scene che non la contengono.

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.

La pagina dello stream come la mostra OBSLa pagina dello stream come la mostra OBS
La pagina dello stream come la mostra OBS

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

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):

  • Mostra sul mio schermo, Mostra nello stream, Dimensione, Stile di questo widget (lo stile dell'HUD o un altro qualsiasi).
  • Mostra: nome, tipo (cloche, manetta), immagine, l'immagine si inclina con la cloche, i pulsanti si illuminano, pulsanti tenuti premuti per nome, assi e leve, nomi degli assi, valori degli assi, posizione della cloche (gimbal), hat. Il widget dell'intestazione: la sua immagine.
  • Immagine: Foto (l'immagine del produttore, con lo sfondo ritagliato), Layout (la tua immagine di layout di JoyPro dalla pagina Layout, con i pulsanti premuti illuminati al loro posto), Auto (la foto, quando c'è).
  • Impugnatura su questa base: per le basi che accettano più impugnature (VPforce Rhino, Virpil WarBRD); l'impugnatura decide l'immagine e i nomi dei pulsanti.
  • Assi della cloche: da dove vengono X, Y e Torsione dell'elemento cloche. Automatica prende gli assi del dispositivo stesso; un'impugnatura che è un dispositivo a sé senza assi li prende dalla base su cui è montata.
Un widget di dispositivo selezionato: cosa mostra, la sua immagine e gli assi della clocheUn widget di dispositivo selezionato: cosa mostra, la sua immagine e gli assi della cloche
Un widget di dispositivo selezionato: cosa mostra, la sua immagine e gli assi della cloche

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.

#I 40 stili

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.

Alcuni dei 40 stiliAlcuni dei 40 stili
Alcuni dei 40 stili

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 e il velivolo DCS

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.

L'HUD sopra un giocoL'HUD sopra un gioco
L'HUD sopra un gioco
Dettagli tecnici interni

#Dietro la pagina

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.

  • Dispositivi: 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.
  • Assegnazioni del gioco in esecuzione: 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.
  • Hook DCS: 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.
  • Server dello stream: 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.
  • Costo mentre giochi: 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.
  • Impostazioni: %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.

#Riferimento

La documentazione delle funzioni dietro questa pagina, generata dal repository:

#Tutti i controlli di questa pagina

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.

#Attiva/disattiva overlay

Pulsantescritti

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.

Più dettagli (in inglese)

#Sul mio schermo (sopra il gioco)

Casella di spuntascritti

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.

Più dettagli (in inglese)

#Pagina per OBS (sorgente Browser, trasparente)

Casella di spuntascritti

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.

Più dettagli (in inglese)

#Copia

Pulsantescritti

Copia negli appunti l'indirizzo della pagina OBS.

In OBS: Sources > + > Browser, incollalo come URL, larghezza 1920, altezza 1080.

Più dettagli (in inglese)

#Finestra di stream (Cattura finestra)

Casella di spuntascritti

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.

Più dettagli (in inglese)

#Mostra sul tuo schermo

Casella di spuntascritti

La spunta monitor di un widget nell'elenco: lo mostra sul tuo schermo.

Più dettagli (in inglese)

#Ricarica dispositivi

Pulsantescritti

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.

Più dettagli (in inglese)

#Mostra tutti

Pulsantescritti

Seleziona tutti i widget per il tuo schermo. Deseleziona nell'elenco quelli che non vuoi.

Più dettagli (in inglese)

#Disponi automaticamente

Pulsantescritti

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.

Più dettagli (in inglese)

#Reimposta posizioni

Pulsantescritti

Riporta ogni widget alla sua posizione e dimensione predefinite; ciò che mostra ogni widget resta.

Più dettagli (in inglese)

#Colore principale

Pulsantescritti

Dà allo stile questo colore d'accento. L'HUD lo adotta subito; lo stile appare come "design personale" finché non lo salvi.

Più dettagli (in inglese)

#Nomi in grassetto

Casella di spuntascritti

Mostra i nomi dei widget in grassetto. Fa parte dello stile: lo cambia in "design personale" finché non lo salvi.

Più dettagli (in inglese)

#Salva stile

Pulsantescritti

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.

Più dettagli (in inglese)

#Importa stile...

Pulsantescritti

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.

Più dettagli (in inglese)

#Esporta stile...

Pulsantescritti

Salva il design attuale come file di stile da condividere o conservare; l'HUD non cambia.

Più dettagli (in inglese)

#Annulla modifiche

Pulsantescritti

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.

Più dettagli (in inglese)

#Elimina

Pulsantescritti

Elimina il tuo stile scelto. I widget che lo usavano tornano allo stile dell'HUD; l'HUD mantiene il suo aspetto attuale.

Più dettagli (in inglese)

#Mostra dispositivo e pulsante

Casella di spuntascritti

Aggiunge il dispositivo e il pulsante sotto ogni riga di Cosa fa il pulsante.

Più dettagli (in inglese)

#Solo mentre un gioco è in esecuzione

Casella di spuntascritti

Mostra le righe Cosa fa il pulsante solo mentre è in esecuzione un gioco supportato; se disattivato, compaiono anche sul desktop.

Più dettagli (in inglese)

#Clic passante (si applica all'avvio)

Casella di spuntascritti

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.

Più dettagli (in inglese)

#Installa hook DCS

Pulsantescritti

Installa l'hook DCS: Scripts\JoyProOverlay.lua e una riga protetta in Export.lua.

Chiudi prima DCS.

Più dettagli (in inglese)

#Rimuovi

Pulsantescritti

Rimuove di nuovo l'hook DCS: Export.lua è identico byte per byte a prima.

Chiudi prima DCS.

Più dettagli (in inglese)

#Verifica

Pulsantescritti

Verifica se l'hook DCS è installato nella cartella DCS indicata nelle Impostazioni.

Non modifica nulla.

Più dettagli (in inglese)

#Il mio schermo

Opzionescritti2 ×

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.

Più dettagli (in inglese)

#Mostra nello stream

Casella di spuntascritti

Mostra il widget selezionato nello stream: la pagina OBS e la finestra dello stream.

Più dettagli (in inglese)

#Nome

Casella di spuntascritti

Mostra il nome del dispositivo sul suo widget.

#Immagine

Casella di spuntascritti

Widget dell'intestazione del gioco: mostra l'immagine del gioco o del velivolo DCS accanto al suo nome.

#L'immagine si inclina con la cloche

Casella di spuntascritti

Inclina e ruota l'immagine del dispositivo con la cloche, come se si muovesse la cloche reale.

#I pulsanti si illuminano

Casella di spuntascritti2 ×

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.

Più dettagli (in inglese)

#Nomi dei pulsanti tenuti premuti

Casella di spuntascritti2 ×

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.

Più dettagli (in inglese)

#Assi e leve

Casella di spuntascritti2 ×

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.

Più dettagli (in inglese)

#Valori degli assi

Casella di spuntascritti

Scrive il valore di ogni asse accanto alla sua barra.

#Posizione della cloche (gimbal)

Casella di spuntascritti2 ×

Mostra l'elemento cloche: un punto in un anello alla posizione della cloche, con una tacca per la torsione.

Più dettagli (in inglese)

#Hat

Casella di spuntascritti

Mostra gli hat; la direzione premuta si illumina.

#Cloche

Casella di spuntascritti

Widget del velivolo: mostra l'immagine della cloche propria del velivolo, che si inclina con la tua cloche.

#Manetta

Casella di spuntascritti

Widget del velivolo: mostra l'immagine della manetta propria del velivolo, che scorre con la prima leva della tua manetta.