JoyPro2 Discord GitHub
Páginas da interface

HUD

Mostrar:

O HUD mostra os seus dispositivos no ecrã enquanto joga, como o overlay de comando de um streamer: a imagem do manche inclina-se com o seu manche, as alavancas e os eixos movem-se como barras, os botões premidos acendem-se com os seus nomes, e uma linha diz o que o botão premido faz no jogo em curso ("Gear Toggle"). Pode aparecer sobre o jogo, no OBS, ou nos dois, cada um com os seus próprios widgets. Esta página é o seu editor.

O editor do HUD com a pré-visualização em diretoO editor do HUD com a pré-visualização em direto
O editor do HUD com a pré-visualização em direto (As imagens mostram a aplicação em inglês.)
flowchart LR
  D["Os seus dispositivos"] --> P["O HUD"]
  O["As suas atribuições<br/>no jogo"] --> P
  P --> S["No meu ecrã"]
  P --> B["Página para o OBS"]
  P --> W["Janela de stream"]
O HUD lê os seus dispositivos e as suas atribuições no jogo em curso e mostra-os em até três sítios ao mesmo tempo: no seu ecrã sobre o jogo, numa página para o OBS e numa janela de stream.
Para iniciantes

#Iniciar o HUD em três cliques

  1. Abra HUD na barra inferior. A pré-visualização já se mexe quando mexe o seu manche.
  2. Deixe No meu ecrã (sobre o jogo) marcado.
  3. Prima Iniciar HUD (também na página Início). Inicie o seu jogo: o HUD fica por cima dele e nunca tira o rato ou o teclado ao jogo.

Parar HUD (o mesmo botão) fecha-o. Tudo o que definir aqui fica guardado e volta a estar lá depois de reiniciar.

#O que está no ecrã

  • Um widget por dispositivo: manches, aceleradores e pedais aparecem desde o início, painéis e teclados ficam ocultos (marque-os na lista Widgets). Cada widget pode mostrar a foto do dispositivo, a posição do manche, os eixos como barras, os botões e os hats.
  • O widget de aeronave: o manche e o acelerador da aeronave que voa, como o jogo os desenha, a mexer-se com os seus.
  • O cabeçalho do jogo: o jogo ou a aeronave do DCS com a sua imagem.
  • O que o botão faz: os últimos botões premidos com a sua ação no jogo em curso.

Arraste um widget na pré-visualização para o mover; clique nele para o mudar à direita. Organizar automaticamente põe-nos ao longo da parte de baixo: acelerador e dispositivos da mão esquerda à esquerda, pedais no meio, o manche da mão direita à direita.

O widget de aeronave: o próprio manche e acelerador da aeronaveO widget de aeronave: o próprio manche e acelerador da aeronave
O widget de aeronave: o próprio manche e acelerador da aeronave
No jogo: O que vê no jogo

A janela do HUD é transparente e fica por cima de jogos em janela e sem moldura. Os cliques passam por ela para o jogo. Não aparece na barra de tarefas nem no Alt+Tab. O ecrã inteiro exclusivo oculta-a (um limite do Windows): mude o jogo para sem moldura. A linha do botão premido diz o nome da ação desse jogo e dessa aeronave, por exemplo "Weapon Release" no F-16C e "Fire guns" no IL-2.

Avançado

#Onde o HUD aparece

As três saídas são independentes umas das outras:

Saída Para Como
No meu ecrã (sobre o jogo) si uma janela transparente por cima do jogo
Página para o OBS (fonte Navegador, transparente) o seu stream (recomendado) o JoyPro serve uma página só neste PC; Copiar coloca o endereço na área de transferência
Janela de stream (Captura de janela) streams com Window Capture uma janela normal (pode ficar atrás do jogo) com fundo transparente ou chroma key

Desmarque No meu ecrã para jogar com o ecrã limpo enquanto o stream continua a mostrar o HUD, ou mostre widgets diferentes em cada um: cada widget tem duas marcas, um monitor (o seu ecrã) e OBS (o stream). Pré-visualização: O meu ecrã / O stream muda o que o editor mostra. Atualizações por segundo (máx.) (15, 30 ou 60; 30 é fluido e leve).

#Configurar o OBS (Browser Source)

  1. Marque Página para o OBS (fonte Navegador, transparente) e prima Iniciar HUD.
  2. Prima Copiar ao lado do endereço (http://127.0.0.1:8765/hud).
  3. No OBS: Sources > + > Browser. Cole o endereço como URL, Width 1920, Height 1080. Não é preciso mais nada: o fundo é transparente, sem CSS personalizado.
  4. Opcional: marque Shutdown source when not visible para que o OBS pare a página nas cenas sem ela.

A página desenha os widgets marcados para o stream, nos mesmos sítios e estilos que a aplicação, num palco de 1920 x 1080 escalado para a fonte. A porta está ocupada por outro programa? Escolha outra em Porta e copie o endereço de novo.

A página de stream tal como o OBS a mostraA página de stream tal como o OBS a mostra
A página de stream tal como o OBS a mostra

Window Capture em alternativa: marque Janela de stream, escolha o fundo (transparente, verde, magenta, azul ou a sua cor). No OBS adicione Window Capture com Capture Method: Windows 10 (1903 and up); com uma cor, adicione um filtro Chroma Key nessa cor. Se um fundo transparente aparecer preto no seu OBS, use a Browser Source ou uma cor.

Como a Browser Source do OBS recebe o HUD: uma página, depois só as alterações.

# Quem O que acontece
1 OBS A Browser Source abre http://127.0.0.1:8765/hud.
2 JoyPro Envia a página: layout, estilos e imagens.
3 OBS Abre /hud/events. Fica aberta.
4 JoyPro Envia o estado (eixos, botões, o que o botão faz), no máximo 30 vezes por segundo e só quando algo mudou.
5 JoyPro Envia de novo o layout quando os widgets, os lugares ou os estilos mudam.

#Widgets

Widgets lista todos os dispositivos mais o cabeçalho, o ticker de atribuições e o widget de aeronave. Recarregar dispositivos volta a ler os dispositivos ligados; Mostrar todos marca todos os widgets para o seu ecrã; Organizar automaticamente e Repor posições colocam-nos no lugar.

Por widget (clique nele na pré-visualização ou na lista):

  • Mostrar no meu ecrã, Mostrar no stream, Tamanho, Estilo deste widget (o estilo do HUD ou qualquer outro).
  • Mostrar: nome, tipo (manche, acelerador), imagem, imagem que se inclina com o manche, botões que acendem, botões premidos pelo nome, eixos e alavancas, nomes dos eixos, valores dos eixos, posição do manche (gimbal), hats. O widget de cabeçalho: a sua imagem.
  • Imagem: Foto (a imagem do fabricante, sem fundo), Layout (a sua imagem de layout do JoyPro da página Layout, com os botões premidos acesos no seu lugar), Auto (a foto, quando existe).
  • Punho nesta base: para bases que aceitam vários punhos (VPforce Rhino, Virpil WarBRD); o punho decide a imagem e os nomes dos botões.
  • Eixos do manche: de onde vêm o X, o Y e o Twist do elemento manche. Automático usa os eixos do próprio dispositivo; um punho que é um dispositivo próprio sem eixos vai buscá-los à base onde está montado.
Um widget de dispositivo selecionado: o que mostra, a sua imagem e os eixos do mancheUm widget de dispositivo selecionado: o que mostra, a sua imagem e os eixos do manche
Um widget de dispositivo selecionado: o que mostra, a sua imagem e os eixos do manche

O widget de aeronave: manche, acelerador, barra de curso do acelerador, posição do manche, controlos que acendem, controlos premidos pelo nome; Aeronaves (Automático: a aeronave que pilota, ou qualquer imagem definida neste PC) e Move-se com (o manche e o acelerador que a movem). As imagens vêm das próprias imagens de cockpit do jogo (Cockpits > Criar imagens a partir dos meus jogos, ou um pacote de imagens); se não houver, do desenho de linhas do punho real feito pelo JoyPro.

#Os 40 estilos

Estilo tem 40 predefinições: Vidro, Néon, Minimalista, estilos limpos (Vidro fosco claro, Streamer sóbrio, Streamer forte, Compacto, Texto grande, Pastel, Só contornos), ecrãs de cockpit (HUD militar verde, MFD âmbar, PFD de avião comercial, Cockpit digital, Visão noturna, Iluminação de cockpit vermelha, Wireframe vetorial, Terminal retro, Warbird, Holograma), jogos e géneros (Espaço laranja, Holo ciano, Cyberpunk, Synthwave, Néon rosa, Corrida, Tático areia, Azul-marinho e dourado, Furtivo, Fantasma), temas de cor (Ártico, Deserto, Oceano, Pôr do sol, Real, Carbono) e legibilidade (Alto contraste, Alto contraste claro, Monocromático, Monocromático claro). › passa ao seguinte.

Alguns dos 40 estilosAlguns dos 40 estilos
Alguns dos 40 estilos

Por baixo: cores de destaque num clique, Destaque, Premido e Opacidade, depois as opções de design por elemento: Cartões (fundo, contorno, cantos, sombra), Texto (tipo de letra, tamanho, espaçamento entre letras, cores, Nomes a negrito), Indicador do manche (anel, quadrado, mira, radar, ponto; tamanho, brilho), Barras e alavancas (formas, alturas, a parte vazia) e Botões e etiquetas (formas). Uma opção alterada torna o estilo "Design próprio (alterado)": Guardar estilo guarda-o com o seu nome, Desfazer alterações volta à predefinição, Exportar estilo... / Importar estilo... partilham-no como ficheiro, Eliminar remove o seu próprio estilo.

#O que o botão faz e a aeronave do DCS

O que o botão faz: quantas linhas, quanto tempo ficam (segundos), o tamanho da letra, Mostrar dispositivo e botão e Só enquanto um jogo estiver em execução. Clicar através deixa os cliques do rato passar através da janela do HUD (aplica-se quando o HUD inicia).

O JoyPro encontra o jogo em execução pelo seu processo (DCS, IL-2, Star Citizen e todos os outros jogos que suporta) e mostra só as atribuições desse jogo. O DCS também precisa da aeronave: escolha-a em Aeronave DCS, ou Instalar hook do DCS para que o DCS diga ao JoyPro a aeronave em cada início de missão (um pequeno ficheiro Lua mais uma linha protegida em Export.lua, com backup feito antes; Remover repõe o ficheiro byte a byte; feche primeiro o DCS). Verificar diz se o hook está instalado.

O HUD sobre um jogoO HUD sobre um jogo
O HUD sobre um jogo
Detalhes técnicos internos

#Por trás da página

View model: MainWindowViewModel.Hud.cs (dispositivos, widgets, layout), MainWindowViewModel.HudStyles.cs (predefinições, estilos próprios, importar/exportar), MainWindowViewModel.HudStream.cs (saídas, página de stream, widget de aeronave), MainWindowViewModel.HudAxes.cs (eixos do manche), MainWindowViewModel.Overlay.cs (iniciar/parar, jogo em execução, linhas dos botões, hook do DCS). Vistas: Views/HudWindow.axaml, Views/Controls/HudSurface.axaml, HudElements.cs, HudPanel.cs. Predefinições: Models/HudStylePresets.cs.

  • Dispositivos: engine hud devices dá, para cada dispositivo ligado, o modelo, o tipo, a mão, a imagem do produto, os eixos com a sua função, os botões com os seus nomes e ids de controlo (Controls, para o widget de aeronave) e a imagem de layout com as posições dos botões.
  • Atribuições do jogo em execução: engine overlay map (--game, --plane, --unit): os botões atribuídos com modificadores e títulos. Uma atribuição com modificadores aparece enquanto os seus modificadores estão premidos; ganha a atribuição com mais modificadores correspondentes.
  • Hook do DCS: engine overlay dcs-hook status / install / remove (--path, --dry-run): Scripts\JoyProOverlay.lua mais uma linha envolvida em pcall em Export.lua; o DCS envia o tipo de unidade para 127.0.0.1:1992 (UDP). O hook chama as funções de exportação de outros scripts (SRS, Tacview) que substitui.
  • Servidor de stream: Services/HudStreamServer.cs, HudStreamHub.cs, Resources/hud-stream.html; ligado só a 127.0.0.1, os pedidos com outro nome de anfitrião são recusados. GET /hud (página), /hud/events (Server-Sent Events: layout, state), /hud/img/<id> (imagens em PNG), /hud/state (JSON). Sem uma página ligada, só fica à escuta.
  • Custo enquanto joga: Services/HudInputPump.cs guarda só o relatório mais recente por dispositivo e aplica-os à taxa escolhida; os elementos só se redesenham quando há alterações; nada é alocado por relatório; as imagens são recortadas uma vez (punhos de aeronave com 480 px de altura). Medido pelo teste de resistência do HUD face a limites de CPU, alocação e memória.
  • Configurações: %APPDATA%\JoyPro2\hud.json (posições, tamanhos, marcas por widget para ecrã e stream, o estilo com todas as opções, estilos próprios, saídas, porta, fundo, taxa de atualização). Ficheiros de estilo: *.joypro-hudstyle.json ("format": "joypro-hud-style").

Referência: hud.

#Referência

A documentação das funções por trás desta página, gerada a partir do repositório:

#Todos os controlos desta página

42 controlos, lidos do código-fonte do programa: 42 escritos, 0 com os factos do código-fonte (dica, comentário no código, chamada ao motor), 0 ainda por desenvolver.

#Alternar overlay

Botãoescritos

Iniciar HUD / Parar HUD: inicia o HUD com as saídas marcadas acima: lê os dispositivos se for preciso, encontra o jogo em execução e carrega as suas atribuições.

Premido de novo, fecha todas as saídas.

Mais detalhes (em inglês)

#No meu ecrã (sobre o jogo)

Caixa de verificaçãoescritos

Dica O HUD transparente sobre o jogo. Desmarque para manter o seu ecrã limpo enquanto o stream continua a mostrar o HUD.

Mostra o HUD como uma janela transparente por cima do jogo.

Desmarque-o para manter o seu próprio ecrã limpo enquanto o stream continua a mostrar o HUD.

Mais detalhes (em inglês)

#Página para o OBS (fonte Navegador, transparente)

Caixa de verificaçãoescritos

Dica O JoyPro disponibiliza o HUD como página web, apenas neste PC. No OBS, adicione uma fonte Navegador com este endereço: o fundo é transparente, não é preciso CSS personalizado.

Enquanto o HUD está a correr, o JoyPro serve-o como página web só neste PC para uma Browser Source do OBS: fundo transparente, sem CSS personalizado.

Marcado, o endereço com Copiar e a Porta aparecem abaixo.

Mais detalhes (em inglês)

#Copiar

Botãoescritos

Copia o endereço da página OBS para a área de transferência.

No OBS: Sources > + > Browser, cole-o como URL, largura 1920, altura 1080.

Mais detalhes (em inglês)

#Janela de stream (Captura de janela)

Caixa de verificaçãoescritos

Dica Uma janela própria, não em primeiro plano: pode ficar atrás do jogo. No OBS: Captura de janela com o método de captura Windows 10 (1903 and up); com uma cor de chroma key, adicione um filtro Chroma Key.

Enquanto o HUD está a correr, abre uma janela própria para a Window Capture do OBS, com fundo transparente ou uma cor de chroma key escolhida abaixo.

No OBS: método de captura Windows 10, e um filtro Chroma Key para uma cor.

Mais detalhes (em inglês)

#Mostrar no seu ecrã

Caixa de verificaçãoescritos

A marca de monitor de um widget na lista: mostra-o no seu ecrã.

Mais detalhes (em inglês)

#Recarregar dispositivos

Botãoescritos

Lê de novo os dispositivos ligados: os dispositivos novos recebem um widget, as imagens e os nomes dos botões são atualizados.

Use-o depois de ligar um dispositivo.

Mais detalhes (em inglês)

#Organizar automaticamente

Botãoescritos

Dica Acelerador e mão esquerda à esquerda, pedais ao meio, manche da mão direita à direita, ao longo da parte inferior

Coloca ao longo da parte de baixo os widgets de dispositivo mostrados no seu ecrã: acelerador e dispositivos da mão esquerda à esquerda, pedais ao meio, o manche da mão direita à direita; o que não couber vai uma linha acima.

As novas posições ficam guardadas.

Mais detalhes (em inglês)

#Repor posições

Botãoescritos

Repõe cada widget na sua posição e tamanho predefinidos; o que cada widget mostra mantém-se.

Mais detalhes (em inglês)

#Cor de destaque

Botãoescritos

Dá ao estilo esta cor de destaque. O HUD aplica-a de imediato; o estilo aparece como "Design próprio" até o guardar.

Mais detalhes (em inglês)

#Nomes a negrito

Caixa de verificaçãoescritos

Mostra os nomes dos widgets a negrito. Faz parte do estilo: muda-o para "Design próprio" até ser guardado.

Mais detalhes (em inglês)

#Guardar estilo

Botãoescritos

Guarda o design atual como estilo próprio com o nome escrito ao lado e torna-o o estilo do HUD.

O nome de uma predefinição é recusado; um estilo seu com o mesmo nome é substituído.

Mais detalhes (em inglês)

#Importar estilo...

Botãoescritos

Lê um ficheiro de estilo e torna-o um dos seus estilos e o estilo do HUD.

Um nome que já usa recebe um número.

Mais detalhes (em inglês)

#Exportar estilo...

Botãoescritos

Guarda o design atual como ficheiro de estilo para partilhar ou guardar; o HUD não muda.

Mais detalhes (em inglês)

#Desfazer alterações

Botãoescritos

Dica Voltar ao estilo escolhido acima

Repõe o design no estilo que tinha antes das alterações feitas à mão: o último estilo escolhido, guardado ou importado.

Mais detalhes (em inglês)

#Eliminar

Botãoescritos

Elimina o estilo próprio escolhido. Os widgets que o usavam voltam ao estilo do HUD; o HUD mantém o aspeto atual.

Mais detalhes (em inglês)

#Mostrar dispositivo e botão

Caixa de verificaçãoescritos

Acrescenta o dispositivo e o botão por baixo de cada linha de O que o botão faz.

Mais detalhes (em inglês)

#Só enquanto um jogo estiver em execução

Caixa de verificaçãoescritos

Mostra as linhas de O que o botão faz só enquanto um jogo suportado está a correr; desligado, também aparecem no ambiente de trabalho.

Mais detalhes (em inglês)

#Clicar através (aplica-se ao iniciar)

Caixa de verificaçãoescritos

Os cliques do rato passam pela janela do HUD até ao jogo.

Aplicado quando o HUD arranca: pare-o e inicie-o depois de alterar isto.

Mais detalhes (em inglês)

#Instalar hook do DCS

Botãoescritos

Instala o hook do DCS: Scripts\JoyProOverlay.lua e uma linha protegida em Export.lua.

Feche primeiro o DCS.

Mais detalhes (em inglês)

#Remover

Botãoescritos

Remove de novo o hook do DCS: o Export.lua fica byte a byte como antes.

Feche primeiro o DCS.

Mais detalhes (em inglês)

#Verificar

Botãoescritos

Verifica se o hook do DCS está instalado na pasta do DCS indicada nas Configurações.

Não altera nada.

Mais detalhes (em inglês)

#O meu ecrã

Opçãoescritos2 ×

O meu ecrã / O stream: o que a pré-visualização do editor mostra, os widgets marcados para o seu ecrã ou os marcados para o stream.

Só a pré-visualização muda; a escolha fica guardada para o próximo arranque.

Mais detalhes (em inglês)

#Mostrar no stream

Caixa de verificaçãoescritos

Mostra o widget selecionado no stream: a página OBS e a janela do stream.

Mais detalhes (em inglês)

#Nome

Caixa de verificaçãoescritos

Mostra o nome do dispositivo no seu widget.

#Imagem

Caixa de verificaçãoescritos

Widget de cabeçalho do jogo: mostra a imagem do jogo ou da aeronave do DCS ao lado do seu nome.

#A imagem inclina-se com o manche

Caixa de verificaçãoescritos

Inclina e torce a imagem do dispositivo com o manche, como se o manche real se movesse.

#Os botões acendem

Caixa de verificaçãoescritos2 ×

Widget de dispositivo: os botões premidos acendem-se. Widget de aeronave: o controlo da aeronave que o botão premido representa acende-se no seu manche ou acelerador.

Mais detalhes (em inglês)

#Nomes dos botões mantidos premidos

Caixa de verificaçãoescritos2 ×

Widget de dispositivo: os botões premidos aparecem como etiquetas com os seus nomes do catálogo de dispositivos.

Widget de aeronave: os controlos premidos da aeronave, pelo nome, por baixo dos punhos.

Mais detalhes (em inglês)

#Eixos e alavancas

Caixa de verificaçãoescritos2 ×

Widget de dispositivo: cada eixo e alavanca move-se como uma barra.

Widget de aeronave: uma barra ao lado do acelerador com a posição da sua alavanca.

Mais detalhes (em inglês)

#Valores dos eixos

Caixa de verificaçãoescritos

Escreve o valor de cada eixo ao lado da sua barra.

#Posição do manche (gimbal)

Caixa de verificaçãoescritos2 ×

Mostra o elemento do manche: um ponto num anel na posição do manche, com um traço para a torção.

Mais detalhes (em inglês)

#Hats

Caixa de verificaçãoescritos

Mostra os hats; a direção premida acende-se.

#Manche

Caixa de verificaçãoescritos

Widget de aeronave: mostra a imagem do próprio manche da aeronave, a inclinar-se com o seu manche.

#Acelerador

Caixa de verificaçãoescritos

Widget de aeronave: mostra a imagem do próprio acelerador da aeronave, a deslizar com a primeira alavanca do seu acelerador.