JoyPro2 Discord GitHub
Pages de l'interface

HUD

Afficher :

Le HUD montre vos périphériques à l'écran pendant que vous jouez, comme l'overlay de manette d'un streamer : l'image du manche s'incline avec votre manche, les leviers et les axes bougent sous forme de barres, les boutons maintenus s'allument avec leur nom, et une ligne dit ce que fait le bouton pressé dans le jeu en cours (« Gear Toggle »). Il peut s'afficher par-dessus le jeu, dans OBS, ou les deux, chacun avec ses propres widgets. Cette page est son éditeur.

L'éditeur du HUD avec l'aperçu en directL'éditeur du HUD avec l'aperçu en direct
L'éditeur du HUD avec l'aperçu en direct (Les images montrent l'application en anglais.)
flowchart LR
  D["Vos périphériques"] --> P["Le HUD"]
  O["Vos assignations<br/>dans le jeu"] --> P
  P --> S["Sur mon écran"]
  P --> B["Page pour OBS"]
  P --> W["Fenêtre de stream"]
Le HUD lit vos périphériques et vos assignations dans le jeu en cours, et les montre jusqu'à trois endroits à la fois : sur votre écran par-dessus le jeu, sur une page pour OBS et dans une fenêtre de stream.
Pour les débutants

#Démarrer le HUD en trois clics

  1. Ouvrez HUD dans la barre du bas. L'aperçu bouge déjà quand vous bougez votre manche.
  2. Laissez Sur mon écran (par-dessus le jeu) coché.
  3. Appuyez sur Démarrer le HUD (aussi sur la page Accueil). Lancez votre jeu : le HUD se place par-dessus et ne prend jamais la souris ni le clavier au jeu.

Arrêter le HUD (le même bouton) le ferme. Tout ce que vous réglez ici est gardé et est de nouveau là après un redémarrage.

#Ce qu'il y a à l'écran

  • Un widget par périphérique : les manches, les manettes des gaz et les palonniers sont affichés au départ, les panneaux et les claviers sont masqués (cochez-les dans la liste Widgets). Chaque widget peut montrer la photo du périphérique, la position du manche, les axes en barres, les boutons et les chapeaux.
  • Le widget de l'appareil : le manche et la manette des gaz de l'appareil que vous pilotez, tels que le jeu les dessine, qui bougent avec les vôtres.
  • L'en-tête du jeu : le jeu ou l'appareil DCS avec son image.
  • Ce que fait le bouton : les derniers boutons pressés avec leur action dans le jeu en cours.

Faites glisser un widget dans l'aperçu pour le déplacer ; cliquez dessus pour le modifier à droite. Disposer automatiquement les place le long du bas : la manette des gaz et les périphériques de la main gauche à gauche, le palonnier au milieu, le manche de la main droite à droite.

Le widget de l'appareil : le manche et la manette des gaz de l'appareil lui-mêmeLe widget de l'appareil : le manche et la manette des gaz de l'appareil lui-même
Le widget de l'appareil : le manche et la manette des gaz de l'appareil lui-même
Dans le jeu: Ce que vous voyez dans le jeu

La fenêtre du HUD est transparente et reste par-dessus les jeux en mode fenêtré et sans bordure. Les clics la traversent jusqu'au jeu. Elle n'est ni dans la barre des tâches ni dans Alt+Tab. Le plein écran exclusif la masque (une limite de Windows) : passez le jeu en mode sans bordure. La ligne du bouton pressé nomme l'action de ce jeu et de cet appareil, par exemple « Weapon Release » dans le F-16C et « Fire guns » dans IL-2.

Avancé

#Où le HUD s'affiche

Les trois sorties sont indépendantes les unes des autres :

Sortie Pour Comment
Sur mon écran (par-dessus le jeu) vous une fenêtre transparente par-dessus le jeu
Page pour OBS (source Navigateur, transparente) votre stream (recommandé) JoyPro sert une page sur ce PC uniquement ; Copier met son adresse dans le presse-papiers
Fenêtre de stream (Capture de fenêtre) les streams par Capture de fenêtre une fenêtre normale (peut se trouver derrière le jeu) avec un fond transparent ou chroma key

Décochez Sur mon écran pour jouer avec un écran propre pendant que le stream montre toujours le HUD, ou montrez des widgets différents sur chacun : chaque widget a deux coches, un écran (votre écran) et OBS (le stream). Aperçu : Mon écran / Le stream change ce que montre le concepteur. Mises à jour par seconde (max.) (15, 30 ou 60 ; 30 est fluide et léger).

#Configurer OBS (source Navigateur)

  1. Cochez Page pour OBS (source Navigateur, transparente) et appuyez sur Démarrer le HUD.
  2. Appuyez sur Copier à côté de l'adresse (http://127.0.0.1:8765/hud).
  3. Dans OBS : Sources > + > Browser. Collez l'adresse comme URL, Width 1920, Height 1080. Rien d'autre n'est nécessaire : le fond est transparent, pas de CSS personnalisé.
  4. Optionnel : cochez Shutdown source when not visible pour qu'OBS arrête la page dans les scènes où elle n'est pas.

La page dessine les widgets cochés pour le stream, aux mêmes endroits et dans les mêmes styles que dans l'application, sur une scène de 1920 x 1080 mise à l'échelle de la source. Port pris par un autre programme ? Choisissez-en un autre sous Port et copiez à nouveau l'adresse.

La page de stream telle qu'OBS l'afficheLa page de stream telle qu'OBS l'affiche
La page de stream telle qu'OBS l'affiche

Capture de fenêtre à la place : cochez Fenêtre de stream, choisissez le fond (transparent, vert, magenta, bleu ou votre couleur). Dans OBS, ajoutez Window Capture avec Capture Method: Windows 10 (1903 and up) ; avec une couleur, ajoutez un filtre Chroma Key de cette couleur. Si un fond transparent s'affiche en noir dans votre OBS, utilisez la source Navigateur ou une couleur.

Comment la source Navigateur d'OBS reçoit le HUD : une page, puis seulement les changements.

# Qui Ce qui se passe
1 OBS La source Navigateur ouvre http://127.0.0.1:8765/hud.
2 JoyPro Envoie la page : disposition, styles et images.
3 OBS Ouvre /hud/events. Elle reste ouverte.
4 JoyPro Envoie l'état (axes, boutons, ce que fait le bouton), au plus 30 fois par seconde et seulement quand quelque chose a changé.
5 JoyPro Renvoie la disposition quand les widgets, les emplacements ou les styles changent.

#Widgets

Widgets liste chaque périphérique plus l'en-tête, le défilant des assignations et le widget d'appareil. Recharger les périphériques relit les périphériques branchés ; Tout afficher coche chaque widget pour votre écran ; Disposer automatiquement et Réinitialiser les emplacements les mettent en place.

Par widget (cliquez dessus dans l'aperçu ou la liste) :

  • Afficher sur mon écran, Afficher dans le stream, Taille, Style de ce widget (le style du HUD ou n'importe quel autre).
  • Afficher : nom, type (manche, manette des gaz), image, image qui s'incline avec le manche, boutons qui s'allument, boutons maintenus par leur nom, axes et leviers, noms des axes, valeurs des axes, position du manche (cardan), chapeaux. Le widget d'en-tête : son image.
  • Image : Photo (l'image du fabricant, fond découpé), Disposition (votre image de disposition JoyPro de la page Disposition, avec les boutons pressés allumés à leur place), Auto (la photo quand il y en a une).
  • Poignée sur cette base : pour les bases qui acceptent plusieurs poignées (VPforce Rhino, Virpil WarBRD) ; la poignée décide de l'image et des noms des boutons.
  • Axes du manche : d'où viennent X, Y et Twist de l'élément manche. Automatique prend les axes propres au périphérique ; une poignée qui est un périphérique à part sans axes les prend de la base sur laquelle elle est montée.
Un widget de périphérique sélectionné : ce qu'il montre, son image et les axes du mancheUn widget de périphérique sélectionné : ce qu'il montre, son image et les axes du manche
Un widget de périphérique sélectionné : ce qu'il montre, son image et les axes du manche

Le widget d'appareil : manche, manette des gaz, barre de course des gaz, position du manche, commandes qui s'allument, commandes maintenues par leur nom ; Appareils (Automatique : l'appareil que vous pilotez, ou n'importe quelle image définie sur ce PC) et Bouge avec (le manche et la manette des gaz qui le font bouger). Ses images viennent des images de cockpit propres au jeu (Cockpits > Créer les images à partir de mes jeux, ou un pack d'images), sinon du dessin au trait de JoyPro de la vraie poignée.

#Les 40 styles

Style a 40 préréglages : Verre, Néon, Minimal, des styles sobres (Verre dépoli clair, Streamer sobre, Streamer marqué, Compact, Grand texte, Pastel, Contours seuls), des affichages de cockpit (HUD militaire vert, MFD ambre, PFD de ligne, Cockpit tout écran, Vision nocturne, Éclairage cockpit rouge, Fil de fer vectoriel, Terminal rétro, Warbird, Hologramme), des jeux et des genres (Espace orange, Holo cyan, Cyberpunk, Synthwave, Néon rose, Course, Tactique sable, Marine et or, Furtif, Fantôme), des thèmes de couleur (Arctique, Désert, Océan, Coucher de soleil, Royal, Carbone) et la lisibilité (Contraste élevé, Contraste élevé clair, Monochrome, Monochrome clair). › passe au suivant.

Quelques-uns des 40 stylesQuelques-uns des 40 styles
Quelques-uns des 40 styles

En dessous : des couleurs d'accent en un clic, Accentuation, Appuyé et Opacité, puis les options de design par élément : Cartes (fond, bordure, coins, ombre), Texte (police, taille, espacement des lettres, couleurs, Noms en gras), Indicateur du manche (anneau, carré, réticule, radar, point ; taille, halo), Barres et leviers (formes, hauteurs, la partie vide) et Boutons et pastilles (formes). Une option changée fait passer le style en « design personnel (modifié) » : Enregistrer le style le garde sous votre nom, Annuler les modifications revient au préréglage, Exporter le style... / Importer un style... le partagent sous forme de fichier, Supprimer retire votre propre style.

#Ce que fait le bouton et l'appareil DCS

Ce que fait le bouton : combien de lignes, combien de temps elles restent (secondes), la taille de police, Afficher le périphérique et le bouton et Seulement pendant qu'un jeu tourne. Clic traversant laisse passer les clics de souris à travers la fenêtre du HUD (s'applique au démarrage du HUD).

JoyPro trouve le jeu en cours par son processus (DCS, IL-2, Star Citizen et tous les autres jeux qu'il gère) et ne montre que les assignations de ce jeu. DCS a aussi besoin de l'appareil : choisissez-le sous Appareil DCS, ou Installer le hook DCS pour que DCS donne l'appareil à JoyPro à chaque début de mission (un petit fichier Lua plus une ligne protégée dans Export.lua, sauvegardé d'abord ; Supprimer remet le fichier octet pour octet ; fermez DCS d'abord). Vérifier dit si le hook est installé.

Le HUD par-dessus un jeuLe HUD par-dessus un jeu
Le HUD par-dessus un jeu
Détails techniques

#Derrière la page

Modèle de vue : MainWindowViewModel.Hud.cs (périphériques, widgets, disposition), MainWindowViewModel.HudStyles.cs (préréglages, styles personnels, importation/exportation), MainWindowViewModel.HudStream.cs (sorties, page de stream, widget d'appareil), MainWindowViewModel.HudAxes.cs (axes du manche), MainWindowViewModel.Overlay.cs (démarrer/arrêter, jeu en cours, lignes des boutons, hook DCS). Vues : Views/HudWindow.axaml, Views/Controls/HudSurface.axaml, HudElements.cs, HudPanel.cs. Préréglages : Models/HudStylePresets.cs.

  • Périphériques : engine hud devices donne pour chaque périphérique branché son modèle, son type, sa main, l'image du produit, les axes avec leur rôle, les boutons avec leurs noms et leurs ids de commande (Controls, pour le widget d'appareil) et l'image de disposition avec les positions des boutons.
  • Assignations du jeu en cours : engine overlay map (--game, --plane, --unit) : les boutons assignés avec modificateurs et titres. Une assignation avec modificateurs s'affiche tant que ses modificateurs sont maintenus ; l'assignation qui a le plus de modificateurs correspondants l'emporte.
  • Hook DCS : engine overlay dcs-hook status / install / remove (--path, --dry-run) : Scripts\JoyProOverlay.lua plus une ligne entourée de pcall dans Export.lua ; DCS envoie le type d'unité à 127.0.0.1:1992 (UDP). Le hook appelle les fonctions d'exportation des autres scripts (SRS, Tacview) qu'il remplace.
  • Serveur de stream : Services/HudStreamServer.cs, HudStreamHub.cs, Resources/hud-stream.html ; lié uniquement à 127.0.0.1, les requêtes avec un autre nom d'hôte sont refusées. GET /hud (page), /hud/events (Server-Sent Events : layout, state), /hud/img/<id> (images en PNG), /hud/state (JSON). Sans page connectée, il ne fait qu'écouter.
  • Coût pendant que vous jouez : Services/HudInputPump.cs ne garde que le rapport le plus récent par périphérique et les applique à la fréquence choisie ; les éléments ne se redessinent que lors d'un changement ; rien n'est alloué par rapport ; les images sont découpées une seule fois (poignées d'appareil de 480 px de haut). Mesuré par le test d'endurance du HUD par rapport à des budgets de CPU, d'allocation et de mémoire.
  • Paramètres : %APPDATA%\JoyPro2\hud.json (emplacements, tailles, coches par widget pour l'écran et le stream, le style avec chaque option, styles personnels, sorties, port, fond, fréquence de mise à jour). Fichiers de style : *.joypro-hudstyle.json ("format": "joypro-hud-style").

Référence : hud.

#Référence

La documentation des fonctions derrière cette page, générée à partir du dépôt :

#Toutes les commandes de cette page

42 contrôles, lus dans le code source du programme : 42 rédigés, 0 avec les faits tirés du code source (info-bulle, commentaire de code, appel au moteur), 0 encore à développer.

#Activer/désactiver l'overlay

Boutonrédigé

Démarrer le HUD / Arrêter le HUD : démarre le HUD avec les sorties cochées ci-dessus : lit les périphériques si nécessaire, trouve le jeu en cours et charge ses assignations.

Appuyé de nouveau, il ferme toutes les sorties.

Plus de détails (en anglais)

#Sur mon écran (par-dessus le jeu)

Case à cocherrédigé

Info-bulle Le HUD transparent par-dessus le jeu. Décochez-le pour garder votre écran dégagé pendant que le stream affiche toujours le HUD.

Affiche le HUD comme fenêtre transparente au-dessus du jeu.

Décochez-le pour garder votre propre écran dégagé pendant que le stream affiche toujours le HUD.

Plus de détails (en anglais)

#Page pour OBS (source Navigateur, transparente)

Case à cocherrédigé

Info-bulle JoyPro fournit le HUD sous forme de page web, uniquement sur ce PC. Dans OBS, ajoutez une source Navigateur avec cette adresse : le fond est transparent, aucun CSS personnalisé n'est nécessaire.

Pendant que le HUD tourne, JoyPro le fournit comme page web, sur ce PC uniquement, pour une source Browser d'OBS : fond transparent, pas de CSS personnalisé.

Coché, l'adresse avec Copier et le Port s'affichent en dessous.

Plus de détails (en anglais)

#Copier

Boutonrédigé

Copie l'adresse de la page OBS dans le presse-papiers.

Dans OBS : Sources > + > Browser, collez-la comme URL, largeur 1920, hauteur 1080.

Plus de détails (en anglais)

#Fenêtre de stream (Capture de fenêtre)

Case à cocherrédigé

Info-bulle Une fenêtre à part, pas au premier plan : elle peut rester derrière le jeu. Dans OBS : Capture de fenêtre avec la méthode de capture Windows 10 (1903 and up) ; avec une couleur d'incrustation, ajoutez un filtre Chroma Key.

Pendant que le HUD tourne, ouvre une fenêtre à part pour la capture de fenêtre d'OBS, avec un fond transparent ou une couleur d'incrustation (chroma key) choisie ci-dessous.

Dans OBS : méthode de capture Windows 10, et un filtre Chroma Key pour une couleur.

Plus de détails (en anglais)

#Recharger les périphériques

Boutonrédigé

Relit les périphériques branchés : les nouveaux périphériques reçoivent un widget, les images et les noms des boutons sont actualisés.

Utilisez-le après avoir branché un périphérique.

Plus de détails (en anglais)

#Disposer automatiquement

Boutonrédigé

Info-bulle Manette des gaz et main gauche à gauche, palonnier au milieu, manche de la main droite à droite, le long du bas

Place les widgets de périphériques affichés sur votre écran le long du bas : manette des gaz et périphériques de main gauche à gauche, palonnier au milieu, manche de main droite à droite ; ce qui ne tient pas monte d'une rangée.

Les nouvelles places sont conservées.

Plus de détails (en anglais)

#Réinitialiser les emplacements

Boutonrédigé

Remet chaque widget à sa place et à sa taille par défaut ; ce que chaque widget affiche reste.

Plus de détails (en anglais)

#Couleur d'accentuation

Boutonrédigé

Donne au style cette couleur d'accent. Le HUD la prend aussitôt ; le style s'affiche comme « design personnel » jusqu'à ce que vous l'enregistriez.

Plus de détails (en anglais)

#Noms en gras

Case à cocherrédigé

Affiche les noms des widgets en gras. Fait partie du style : le passe en « design personnel » jusqu'à l'enregistrement.

Plus de détails (en anglais)

#Enregistrer le style

Boutonrédigé

Garde le design actuel comme votre propre style sous le nom saisi à côté, et en fait le style du HUD.

Le nom d'un préréglage est refusé ; votre style du même nom est remplacé.

Plus de détails (en anglais)

#Importer un style...

Boutonrédigé

Lit un fichier de style et en fait l'un de vos styles et le style du HUD.

Un nom que vous utilisez déjà reçoit un numéro.

Plus de détails (en anglais)

#Exporter le style...

Boutonrédigé

Enregistre le design actuel comme fichier de style à partager ou à garder ; le HUD ne change pas.

Plus de détails (en anglais)

#Annuler les modifications

Boutonrédigé

Info-bulle Revenir au style choisi ci-dessus

Remet le design au style que vous aviez avant les modifications faites à la main : le style choisi, enregistré ou importé en dernier.

Plus de détails (en anglais)

#Supprimer

Boutonrédigé

Supprime le style personnel choisi. Les widgets qui l'utilisaient reviennent au style du HUD ; le HUD garde son apparence actuelle.

Plus de détails (en anglais)

#Afficher le périphérique et le bouton

Case à cocherrédigé

Ajoute le périphérique et le bouton sous chaque ligne de Ce que fait le bouton.

Plus de détails (en anglais)

#Seulement pendant qu'un jeu tourne

Case à cocherrédigé

Affiche les lignes Ce que fait le bouton seulement pendant qu'un jeu pris en charge tourne ; désactivé, elles s'affichent aussi sur le bureau.

Plus de détails (en anglais)

#Clic traversant (appliqué au démarrage)

Case à cocherrédigé

Les clics de souris traversent la fenêtre du HUD jusqu'au jeu.

Appliqué au démarrage du HUD : arrêtez-le et redémarrez-le après avoir changé ceci.

Plus de détails (en anglais)

#Installer le hook DCS

Boutonrédigé

Installe le hook DCS : Scripts\JoyProOverlay.lua et une ligne protégée dans Export.lua.

Fermez d'abord DCS.

Plus de détails (en anglais)

#Supprimer

Boutonrédigé

Retire de nouveau le hook DCS : Export.lua est identique octet pour octet à avant.

Fermez d'abord DCS.

Plus de détails (en anglais)

#Mon écran

Optionrédigé2 ×

Mon écran / Le stream : ce que montre l'aperçu du concepteur, les widgets cochés pour votre écran ou ceux cochés pour le stream.

Seul l'aperçu change ; le choix est conservé pour le prochain démarrage.

Plus de détails (en anglais)

#Afficher dans le stream

Case à cocherrédigé

Affiche le widget sélectionné dans le stream : la page OBS et la fenêtre du stream.

Plus de détails (en anglais)

#Nom

Case à cocherrédigé

Affiche le nom du périphérique sur son widget.

#Image

Case à cocherrédigé

Widget d'en-tête du jeu : affiche l'image du jeu ou de l'appareil DCS à côté de son nom.

#L'image s'incline avec le manche

Case à cocherrédigé

Incline et tourne l'image du périphérique avec le manche, comme si le vrai manche bougeait.

#Les boutons s'allument

Case à cocherrédigé2 ×

Widget de périphérique : les boutons maintenus s'allument. Widget d'appareil : la commande de l'appareil que représente votre bouton appuyé s'allume sur son manche ou sa manette des gaz.

Plus de détails (en anglais)

#Noms des boutons maintenus

Case à cocherrédigé2 ×

Widget de périphérique : les boutons maintenus s'affichent comme des pastilles avec leurs noms tirés du catalogue de périphériques.

Widget d'appareil : les commandes maintenues de l'appareil, par leur nom, sous les poignées.

Plus de détails (en anglais)

#Axes et leviers

Case à cocherrédigé2 ×

Widget de périphérique : chaque axe et chaque levier bouge sous forme de barre.

Widget d'appareil : une barre à côté de la manette des gaz avec la position de votre levier.

Plus de détails (en anglais)

#Valeurs des axes

Case à cocherrédigé

Écrit la valeur de chaque axe à côté de sa barre.

#Position du manche (cardan)

Case à cocherrédigé2 ×

Affiche l'élément manche : un point dans un anneau à la position du manche, avec un trait pour la torsion.

Plus de détails (en anglais)

#Chapeaux

Case à cocherrédigé

Affiche les chapeaux ; la direction appuyée s'allume.

#Manche

Case à cocherrédigé

Widget d'appareil : affiche l'image du manche propre à l'appareil, qui s'incline avec votre manche.

#Manette des gaz

Case à cocherrédigé

Widget d'appareil : affiche l'image de la manette des gaz propre à l'appareil, qui glisse avec le premier levier de votre manette des gaz.