#Alternar overlay
BotãoescritosIniciar 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.
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.


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"]
Parar HUD (o mesmo botão) fecha-o. Tudo o que definir aqui fica guardado e volta a estar lá depois de reiniciar.
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.


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.
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).
http://127.0.0.1:8765/hud).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.


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


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


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


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.
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.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.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.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.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.%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.
A documentação das funções por trás desta página, gerada a partir do repositório:
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.
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.
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.
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.
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.
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.
A marca de monitor de um widget na lista: mostra-o no seu ecrã.
A marca OBS de um widget na lista: mostra-o no stream.
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.
Marca todos os widgets para o seu ecrã. Desmarque na lista os que não quer.
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.
Repõe cada widget na sua posição e tamanho predefinidos; o que cada widget mostra mantém-se.
Dica Estilo seguinte
Muda o HUD para a entrada seguinte da lista Estilo.
Dá ao estilo esta cor de destaque. O HUD aplica-a de imediato; o estilo aparece como "Design próprio" até o guardar.
Mostra os nomes dos widgets a negrito. Faz parte do estilo: muda-o para "Design próprio" até ser guardado.
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.
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.
Guarda o design atual como ficheiro de estilo para partilhar ou guardar; o HUD não muda.
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.
Elimina o estilo próprio escolhido. Os widgets que o usavam voltam ao estilo do HUD; o HUD mantém o aspeto atual.
Acrescenta o dispositivo e o botão por baixo de cada linha de O que o botão faz.
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.
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.
Instala o hook do DCS: Scripts\JoyProOverlay.lua e uma linha protegida em Export.lua.
Feche primeiro o DCS.
Remove de novo o hook do DCS: o Export.lua fica byte a byte como antes.
Feche primeiro o DCS.
Verifica se o hook do DCS está instalado na pasta do DCS indicada nas Configurações.
Não altera nada.
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.
Mostra o widget selecionado no seu ecrã.
Mostra o widget selecionado no stream: a página OBS e a janela do stream.
Mostra o nome do dispositivo no seu widget.
Widget de cabeçalho do jogo: mostra a imagem do jogo ou da aeronave do DCS ao lado do seu nome.
Mostra o tipo do dispositivo por baixo do seu nome.
Mostra a imagem do dispositivo.
Inclina e torce a imagem do dispositivo com o manche, como se o manche real se movesse.
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.
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.
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.
Escreve o nome de cada eixo ao lado da sua barra.
Escreve o valor de cada eixo ao lado da sua barra.
Mostra o elemento do manche: um ponto num anel na posição do manche, com um traço para a torção.
Mostra os hats; a direção premida acende-se.
Widget de aeronave: mostra a imagem do próprio manche da aeronave, a inclinar-se com o seu manche.
Widget de aeronave: mostra a imagem do próprio acelerador da aeronave, a deslizar com a primeira alavanca do seu acelerador.