JoyPro2 Discord GitHub
Páginas de la interfaz

HUD

Mostrar:

El HUD muestra sus dispositivos en pantalla mientras juega, como la superposición de mando de un streamer: la imagen de la palanca se inclina con su palanca, las palancas y los ejes se mueven como barras, los botones pulsados se iluminan con sus nombres, y una línea dice lo que hace el botón pulsado en el juego en marcha ("Gear Toggle"). Puede mostrarse sobre el juego, en OBS o en ambos, cada uno con sus propios widgets. Esta página es su diseñador.

El diseñador del HUD con la vista previa en directoEl diseñador del HUD con la vista previa en directo
El diseñador del HUD con la vista previa en directo (Las imágenes muestran la aplicación en inglés.)
flowchart LR
  D["Sus dispositivos"] --> P["El HUD"]
  O["Sus asignaciones<br/>en el juego"] --> P
  P --> S["En mi pantalla"]
  P --> B["Página para OBS"]
  P --> W["Ventana para streaming"]
El HUD lee sus dispositivos y sus asignaciones en el juego en marcha, y los muestra en hasta tres lugares a la vez: en su pantalla sobre el juego, en una página para OBS y en una ventana para streaming.
Para principiantes

#Iniciar el HUD en tres clics

  1. Abra HUD en la barra inferior. La vista previa ya se mueve cuando mueve su palanca.
  2. Deje marcada En mi pantalla (sobre el juego).
  3. Pulse Iniciar HUD (también en la página Inicio). Inicie su juego: el HUD se queda encima y nunca le quita al juego el ratón ni el teclado.

Detener HUD (el mismo botón) lo cierra. Todo lo que ajuste aquí se conserva y vuelve a estar después de reiniciar.

#Qué hay en la pantalla

  • Un widget por dispositivo: las palancas, los aceleradores y los pedales se muestran al principio; los paneles y teclados están ocultos (márquelos en la lista Widgets). Cada widget puede mostrar la foto del dispositivo, la posición de la palanca, los ejes como barras, los botones y los hats.
  • El widget de aeronave: la palanca y el acelerador de la aeronave que vuela, tal como los dibuja el juego, moviéndose con los suyos.
  • La cabecera del juego: el juego o la aeronave de DCS con su imagen.
  • Qué hace el botón: los últimos botones pulsados con su acción en el juego en marcha.

Arrastre un widget en la vista previa para moverlo; haga clic en él para cambiarlo a la derecha. Organizar automáticamente los coloca a lo largo de la parte inferior: el acelerador y los dispositivos de la mano izquierda a la izquierda, los pedales en el centro, la palanca de la mano derecha a la derecha.

El widget de aeronave: la palanca y el acelerador propios de la aeronaveEl widget de aeronave: la palanca y el acelerador propios de la aeronave
El widget de aeronave: la palanca y el acelerador propios de la aeronave
En el juego: Lo que ve en el juego

La ventana del HUD es transparente y se queda encima de los juegos en ventana y sin bordes. Los clics pasan a través de ella hasta el juego. No aparece en la barra de tareas ni en Alt+Tab. La pantalla completa exclusiva la oculta (un límite de Windows): cambie el juego a sin bordes. La línea del botón pulsado nombra la acción de ese juego y esa aeronave, por ejemplo "Weapon Release" en el F-16C y "Fire guns" en IL-2.

Avanzado

#Dónde se muestra el HUD

Las tres salidas son independientes entre sí:

Salida Para Cómo
En mi pantalla (sobre el juego) usted una ventana transparente encima del juego
Página para OBS (fuente Navegador, transparente) su transmisión (recomendado) JoyPro sirve una página solo en este PC; Copiar pone su dirección en el portapapeles
Ventana para streaming (Captura de ventana) transmisiones con Window Capture una ventana normal (puede quedar detrás del juego) con un fondo transparente o de croma

Desmarque En mi pantalla para jugar con la pantalla limpia mientras la transmisión sigue mostrando el HUD, o muestre widgets distintos en cada una: cada widget tiene dos marcas, un monitor (su pantalla) y OBS (la transmisión). Vista previa: Mi pantalla / La transmisión cambia lo que muestra el diseñador. Actualizaciones por segundo (máx.) (15, 30 o 60; 30 es fluido y ligero).

#Configurar OBS (Browser Source)

  1. Marque Página para OBS (fuente Navegador, transparente) y pulse Iniciar HUD.
  2. Pulse Copiar junto a la dirección (http://127.0.0.1:8765/hud).
  3. En OBS: Sources > + > Browser. Pegue la dirección como URL, Width 1920, Height 1080. No hace falta nada más: el fondo es transparente, sin CSS personalizado.
  4. Opcional: marque Shutdown source when not visible para que OBS detenga la página en las escenas que no la tienen.

La página dibuja los widgets marcados para la transmisión, en los mismos lugares y estilos que la aplicación, en un escenario de 1920 x 1080 escalado a la fuente. ¿El puerto lo usa otro programa? Elija otro en Puerto y vuelva a copiar la dirección.

La página de streaming tal como la muestra OBSLa página de streaming tal como la muestra OBS
La página de streaming tal como la muestra OBS

Window Capture en su lugar: marque Ventana para streaming, elija el fondo (transparente, verde, magenta, azul o su color). En OBS añada Window Capture con Capture Method: Windows 10 (1903 and up); con un color, añada un filtro Chroma Key de ese color. Si un fondo transparente se ve negro en su OBS, use la Browser Source o un color.

Cómo recibe el HUD la Browser Source de OBS: una página y después solo los cambios.

# Quién Qué pasa
1 OBS La Browser Source abre http://127.0.0.1:8765/hud.
2 JoyPro Envía la página: diseño, estilos e imágenes.
3 OBS Abre /hud/events. Queda abierta.
4 JoyPro Envía el estado (ejes, botones, lo que hace el botón), como mucho 30 veces por segundo y solo cuando algo cambió.
5 JoyPro Vuelve a enviar el diseño cuando cambian los widgets, los lugares o los estilos.

#Widgets

Widgets lista cada dispositivo más la cabecera, el ticker de asignaciones y el widget de la aeronave. Recargar dispositivos vuelve a leer los dispositivos conectados; Mostrar todo marca todos los widgets para su pantalla; Organizar automáticamente y Restablecer posiciones los colocan en su sitio.

Por widget (haga clic en él en la vista previa o en la lista):

  • Mostrar en mi pantalla, Mostrar en la transmisión, Tamaño, Estilo de este widget (el estilo del HUD o cualquier otro).
  • Mostrar: nombre, tipo (palanca, acelerador), imagen, la imagen se inclina con la palanca, los botones se iluminan, botones mantenidos por nombre, ejes y palancas, nombres de los ejes, valores de los ejes, posición de la palanca (gimbal), hats. El widget de cabecera: su imagen.
  • Imagen: Foto (la imagen del fabricante, con el fondo recortado), Esquema (su imagen de esquema de JoyPro de la página Esquema, con los botones pulsados iluminados en su lugar), Auto (la foto cuando hay una).
  • Empuñadura en esta base: para bases que admiten varias empuñaduras (VPforce Rhino, Virpil WarBRD); la empuñadura decide la imagen y los nombres de los botones.
  • Ejes de la palanca: de dónde vienen X, Y y Twist del elemento palanca. Automático toma los ejes propios del dispositivo; una empuñadura que es un dispositivo propio sin ejes los toma de la base sobre la que está.
Un widget de dispositivo seleccionado: qué muestra, su imagen y los ejes de la palancaUn widget de dispositivo seleccionado: qué muestra, su imagen y los ejes de la palanca
Un widget de dispositivo seleccionado: qué muestra, su imagen y los ejes de la palanca

El widget de la aeronave: palanca, acelerador, barra de recorrido del acelerador, posición de la palanca, los controles se iluminan, controles mantenidos por nombre; Aeronaves (Automático: la aeronave que vuela, o cualquier imagen definida en este PC) y Se mueve con (la palanca y el acelerador que lo mueven). Sus imágenes vienen de las propias imágenes de cabina del juego (Cabinas > Crear imágenes a partir de mis juegos, o un paquete de imágenes); si no, del dibujo de líneas de JoyPro de la empuñadura real.

#Los 40 estilos

Estilo tiene 40 preajustes: Cristal, Neón, Mínimo, limpios (Vidrio esmerilado claro, Streamer sobrio, Streamer intenso, Compacto, Texto grande, Pastel, Solo contornos), pantallas de cabina (HUD militar verde, MFD ámbar, PFD de avión comercial, Cabina de cristal, Visión nocturna, Iluminación de cabina roja, Malla vectorial, Terminal retro, Warbird, Holograma), juegos y géneros (Espacio naranja, Holo cian, Cyberpunk, Synthwave, Neón rosa, Carreras, Táctico arena, Azul marino y oro, Furtivo, Fantasma), temas de color (Ártico, Desierto, Océano, Atardecer, Real, Carbono) y legibilidad (Alto contraste, Alto contraste claro, Monocromo, Monocromo claro). › pasa al siguiente.

Algunos de los 40 estilosAlgunos de los 40 estilos
Algunos de los 40 estilos

Debajo: colores de énfasis con un clic, Énfasis, Pulsado y Opacidad, luego las opciones de diseño por elemento: Tarjetas (fondo, borde, esquinas, sombra), Texto (fuente, tamaño, espaciado entre letras, colores, Nombres en negrita), Indicador de la palanca (anillo, cuadrado, retícula, radar, punto; tamaño, brillo), Barras y palancas (formas, alturas, la parte vacía) y Botones y etiquetas (formas). Una opción cambiada convierte el estilo en "Diseño propio (modificado)": Guardar estilo lo guarda con su nombre, Deshacer cambios vuelve al preajuste, Exportar estilo... / Importar estilo... lo comparten como archivo, Eliminar borra su propio estilo.

#Qué hace el botón y la aeronave de DCS

Qué hace el botón: cuántas líneas, cuánto tiempo se quedan (segundos), el tamaño de letra, Mostrar dispositivo y botón y Solo mientras se ejecuta un juego. Atravesable por clics deja pasar los clics del ratón a través de la ventana del HUD (se aplica al iniciar el HUD).

JoyPro encuentra el juego en marcha por su proceso (DCS, IL-2, Star Citizen y cualquier otro juego que gestiona) y muestra solo las asignaciones de ese juego. DCS necesita además la aeronave: elíjala en Aeronave de DCS, o Instalar hook de DCS para que DCS le diga a JoyPro la aeronave al inicio de cada misión (un pequeño archivo Lua más una línea protegida en Export.lua, con copia de seguridad previa; Quitar devuelve el archivo byte a byte; cierre DCS antes). Comprobar dice si el hook está instalado.

El HUD sobre un juegoEl HUD sobre un juego
El HUD sobre un juego
Detalles técnicos internos

#Detrás de la página

Modelo de vista: MainWindowViewModel.Hud.cs (dispositivos, widgets, disposición), MainWindowViewModel.HudStyles.cs (preajustes, estilos propios, importar/exportar), MainWindowViewModel.HudStream.cs (salidas, página de streaming, widget de la aeronave), MainWindowViewModel.HudAxes.cs (ejes de la palanca), MainWindowViewModel.Overlay.cs (iniciar/detener, juego en marcha, líneas de botones, hook de DCS). Vistas: Views/HudWindow.axaml, Views/Controls/HudSurface.axaml, HudElements.cs, HudPanel.cs. Preajustes: Models/HudStylePresets.cs.

  • Dispositivos: engine hud devices da de cada dispositivo conectado el modelo, el tipo, la mano, la imagen del producto, los ejes con su función, los botones con sus nombres e ids de control (Controls, para el widget de la aeronave) y la imagen de esquema con las posiciones de los botones.
  • Asignaciones del juego en marcha: engine overlay map (--game, --plane, --unit): los botones asignados con modificadores y títulos. Una asignación con modificadores se muestra mientras se mantienen sus modificadores; gana la asignación con más modificadores coincidentes.
  • Hook de DCS: engine overlay dcs-hook status / install / remove (--path, --dry-run): Scripts\JoyProOverlay.lua más una línea envuelta en pcall en Export.lua; DCS envía el tipo de unidad a 127.0.0.1:1992 (UDP). El hook llama a las funciones de exportación de otros scripts (SRS, Tacview) a los que sustituye.
  • Servidor de streaming: Services/HudStreamServer.cs, HudStreamHub.cs, Resources/hud-stream.html; vinculado solo a 127.0.0.1, las peticiones con otro nombre de host se rechazan. GET /hud (página), /hud/events (Server-Sent Events: layout, state), /hud/img/<id> (imágenes como PNG), /hud/state (JSON). Sin una página conectada solo escucha.
  • Coste mientras juega: Services/HudInputPump.cs guarda solo el informe más reciente por dispositivo y los aplica a la frecuencia elegida; los elementos solo se redibujan cuando cambian; no se reserva memoria por informe; las imágenes se recortan una vez (empuñaduras de aeronaves de 480 px de alto). Medido por la prueba de resistencia del HUD frente a presupuestos de CPU, reservas de memoria y memoria.
  • Configuración: %APPDATA%\JoyPro2\hud.json (posiciones, tamaños, marcas por widget para pantalla y transmisión, el estilo con todas sus opciones, estilos propios, salidas, puerto, fondo, frecuencia de actualización). Archivos de estilo: *.joypro-hudstyle.json ("format": "joypro-hud-style").

Referencia: hud.

#Referencia

La documentación de funciones detrás de esta página, generada a partir del repositorio:

#Todos los controles de esta página

42 controles, leídos del código fuente del programa: 42 redactados, 0 con los datos del código fuente (información emergente, comentario del código, llamada al motor), 0 aún por ampliar.

#Activar o desactivar la superposición

Botónredactado

Iniciar HUD / Detener HUD: inicia el HUD con las salidas marcadas arriba: lee los dispositivos si hace falta, encuentra el juego en ejecución y carga sus asignaciones.

Si se pulsa de nuevo, cierra todas las salidas.

Más detalles (en inglés)

#En mi pantalla (sobre el juego)

Casilla de verificaciónredactado

Información emergente El HUD transparente sobre el juego. Desmárquelo para mantener su pantalla despejada mientras la transmisión sigue mostrando el HUD.

Muestra el HUD como una ventana transparente encima del juego.

Desmárquelo para mantener limpia su propia pantalla mientras la transmisión sigue mostrando el HUD.

Más detalles (en inglés)

#Página para OBS (fuente Navegador, transparente)

Casilla de verificaciónredactado

Información emergente JoyPro ofrece el HUD como página web, solo en este PC. En OBS, añada una fuente Navegador con esta dirección: el fondo es transparente, no hace falta CSS personalizado.

Mientras el HUD funciona, JoyPro lo sirve como página web solo en este PC para una Browser Source de OBS: fondo transparente, sin CSS personalizado.

Marcado, debajo se muestran la dirección con Copiar y el Puerto.

Más detalles (en inglés)

#Copiar

Botónredactado

Copia al portapapeles la dirección de la página para OBS.

En OBS: Sources > + > Browser, péguela como URL, ancho 1920, alto 1080.

Más detalles (en inglés)

#Ventana para streaming (Captura de ventana)

Casilla de verificaciónredactado

Información emergente Una ventana propia, no en primer plano: puede quedar detrás del juego. En OBS: Captura de ventana con el método de captura Windows 10 (1903 and up); con un color de croma, añada un filtro Chroma Key.

Mientras el HUD funciona, abre una ventana propia para la Window Capture de OBS, con fondo transparente o un color de croma elegido abajo.

En OBS: método de captura Windows 10, y un filtro Chroma Key para un color.

Más detalles (en inglés)

#Mostrar en su pantalla

Casilla de verificaciónredactado

La marca de monitor de un widget en la lista: lo muestra en su pantalla.

Más detalles (en inglés)

#Mostrar en la transmisión

Casilla de verificaciónredactado

La marca de OBS de un widget en la lista: lo muestra en la transmisión.

Más detalles (en inglés)

#Recargar dispositivos

Botónredactado

Vuelve a leer los dispositivos conectados: los dispositivos nuevos reciben un widget, y las imágenes y nombres de botones se actualizan.

Úselo después de conectar un dispositivo.

Más detalles (en inglés)

#Mostrar todo

Botónredactado

Marca todos los widgets para su pantalla. Desmarque en la lista los que no quiera.

Más detalles (en inglés)

#Organizar automáticamente

Botónredactado

Información emergente Acelerador y mano izquierda a la izquierda, pedales en el centro, palanca de la mano derecha a la derecha, a lo largo de la parte inferior

Coloca a lo largo del borde inferior los widgets de dispositivos que se muestran en su pantalla: acelerador y dispositivos de la mano izquierda a la izquierda, pedales en el centro, la palanca de la mano derecha a la derecha; lo que no cabe sube una fila.

Las nuevas posiciones se conservan.

Más detalles (en inglés)

#Restablecer posiciones

Botónredactado

Devuelve cada widget a su posición y tamaño predeterminados; lo que muestra cada widget se mantiene.

Más detalles (en inglés)

#›

Botónredactado

Información emergente Estilo siguiente

Cambia el HUD a la siguiente entrada de la lista Estilo.

Más detalles (en inglés)

#Color de énfasis

Botónredactado

Da a este estilo este color de acento. El HUD lo toma de inmediato; el estilo aparece como "diseño propio" hasta que lo guarde.

Más detalles (en inglés)

#Nombres en negrita

Casilla de verificaciónredactado

Muestra los nombres de los widgets en negrita. Forma parte del estilo: lo cambia a "diseño propio" hasta que se guarde.

Más detalles (en inglés)

#Guardar estilo

Botónredactado

Guarda el diseño actual como estilo propio con el nombre escrito al lado y lo convierte en el estilo del HUD.

Se rechaza el nombre de un preajuste; su estilo con el mismo nombre se reemplaza.

Más detalles (en inglés)

#Importar estilo...

Botónredactado

Lee un archivo de estilo y lo convierte en uno de sus estilos y en el estilo del HUD.

Un nombre que ya usa recibe un número.

Más detalles (en inglés)

#Exportar estilo...

Botónredactado

Guarda el diseño actual como archivo de estilo para compartirlo o conservarlo; el HUD no cambia.

Más detalles (en inglés)

#Deshacer cambios

Botónredactado

Información emergente Volver al estilo elegido arriba

Devuelve el diseño al estilo que tenía antes de los cambios hechos a mano: el último estilo elegido, guardado o importado.

Más detalles (en inglés)

#Eliminar

Botónredactado

Elimina el estilo propio elegido. Los widgets que lo usaban vuelven al estilo del HUD; el HUD mantiene su aspecto actual.

Más detalles (en inglés)

#Mostrar dispositivo y botón

Casilla de verificaciónredactado

Añade el dispositivo y el botón debajo de cada línea de Qué hace el botón.

Más detalles (en inglés)

#Solo mientras se ejecuta un juego

Casilla de verificaciónredactado

Muestra las líneas de Qué hace el botón solo mientras se ejecuta un juego compatible; desactivado, también se muestran en el escritorio.

Más detalles (en inglés)

#Atravesable por clics (se aplica al iniciar)

Casilla de verificaciónredactado

Los clics del ratón atraviesan la ventana del HUD y llegan al juego.

Se aplica al iniciar el HUD: deténgalo e inícielo de nuevo después de cambiar esto.

Más detalles (en inglés)

#Instalar hook de DCS

Botónredactado

Instala el hook de DCS: Scripts\JoyProOverlay.lua y una línea protegida en Export.lua.

Cierre DCS primero.

Más detalles (en inglés)

#Quitar

Botónredactado

Vuelve a quitar el hook de DCS: Export.lua queda byte a byte como antes.

Cierre DCS primero.

Más detalles (en inglés)

#Comprobar

Botónredactado

Comprueba si el hook de DCS está instalado en la carpeta de DCS de Configuración.

No cambia nada.

Más detalles (en inglés)

#Mi pantalla

Opciónredactado2 ×

Mi pantalla / La transmisión: lo que muestra la vista previa del diseñador, los widgets marcados para su pantalla o los marcados para la transmisión.

Solo cambia la vista previa; la elección se conserva para el próximo inicio.

Más detalles (en inglés)

#Mostrar en la transmisión

Casilla de verificaciónredactado

Muestra el widget seleccionado en la transmisión: la página para OBS y la ventana de transmisión.

Más detalles (en inglés)

#Nombre

Casilla de verificaciónredactado

Muestra el nombre del dispositivo en su widget.

#Imagen

Casilla de verificaciónredactado

Widget de cabecera del juego: muestra la imagen del juego o de la aeronave de DCS junto a su nombre.

#Tipo (palanca, acelerador)

Casilla de verificaciónredactado

Muestra el tipo del dispositivo debajo de su nombre.

Más detalles (en inglés)

#La imagen se inclina con la palanca

Casilla de verificaciónredactado

Inclina y gira la imagen del dispositivo con la palanca, como si se moviera la palanca real.

#Los botones se iluminan

Casilla de verificaciónredactado2 ×

Widget de dispositivo: los botones pulsados se iluminan. Widget de aeronave: se ilumina en su palanca o acelerador el control de la aeronave al que corresponde el botón que pulsa.

Más detalles (en inglés)

#Nombres de los botones mantenidos

Casilla de verificaciónredactado2 ×

Widget de dispositivo: los botones pulsados se muestran como fichas con sus nombres del catálogo de dispositivos.

Widget de aeronave: los controles pulsados de la aeronave, por nombre, debajo de las empuñaduras.

Más detalles (en inglés)

#Ejes y palancas

Casilla de verificaciónredactado2 ×

Widget de dispositivo: cada eje y palanca se mueve como una barra.

Widget de aeronave: una barra junto al acelerador con la posición de su palanca.

Más detalles (en inglés)

#Valores de ejes

Casilla de verificaciónredactado

Escribe el valor de cada eje junto a su barra.

#Posición de la palanca (gimbal)

Casilla de verificaciónredactado2 ×

Muestra el elemento de la palanca: un punto en un anillo en la posición de la palanca, con una marca para el giro.

Más detalles (en inglés)

#Hats

Casilla de verificaciónredactado

Muestra los hats; la dirección pulsada se ilumina.

#Palanca

Casilla de verificaciónredactado

Widget de aeronave: muestra la imagen de la palanca propia de la aeronave, que se inclina con su palanca.

#Acelerador

Casilla de verificaciónredactado

Widget de aeronave: muestra la imagen del acelerador propio de la aeronave, que se desliza con la primera palanca de su acelerador.