JoyPro2 Discord GitHub
Jogos

FSX e Prepar3D

Mostrar:

O FSX, o FSX: Steam Edition e o Prepar3D v4, v5 e v6 guardam os seus controlos num ficheiro XML em %APPDATA%: um mapa por dispositivo com os seus eixos, botões e hat, mais o teclado. O JoyPro lê esse ficheiro para o seu perfil, junta-o com os seus outros jogos em relações e escreve-o de volta bloco a bloco, deixando a formatação, os comentários e os outros mapas como estão. Cada simulador é um jogo próprio no JoyPro, porque cada um tem o seu próprio ficheiro.

Esta integração foi escrita a partir de fontes públicas e só está coberta por um ficheiro de teste sintético: nenhum destes simuladores foi ainda testado com o JoyPro numa instalação real. Depois da sua primeira exportação, abra os controlos do simulador e verifique as atribuições, e por favor comunique o que for diferente.

Microsoft Flight Simulator X nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine fsx
Ficheiro de atribuições
%APPDATA%\Microsoft\FSX\Controls\Standard.XML (XML)
Entradas que o jogo lê
lê 32 botões, 8 eixos por joystick (relatado)
Lista de comandos a partir de
a lista de eventos do próprio JoyPro (ids públicos do SDK) + os eventos dos seus ficheiros de controlos e do modelo da instalação
  • ✓ Importar
  • ✓ Exportar
  • ✓ Atribuições de teclado
  • ◐ ModificadoresFSX e Prepar3D: Ctrl/Shift/Alt nas teclas; nenhum modificador nas atribuições de joystick.
  • ✓ Lista de comandos criada no seu PC
  • ✓ Monitor de jogos
  • ✓ Curvas de eixo e zonas mortas
  • ✗ Configurações de controlo do jogo
  • ✗ Configurações de force feedback no jogo
  • ✗ Force feedback a partir da telemetria
  • ✗ Gravação de telemetria
  • ✓ Joystick virtual (vJoy)
  • ◐ Comando Xbox virtual
  • ✓ Funções virtuais
  • ◐ Assistente de configuração / Atribuição automática
  • ✓ Cockpits
  • ✓ Folhas de referência
  • ✗ Teste no jogo
Microsoft Flight Simulator X: Steam Edition nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine fsxse
Ficheiro de atribuições
%APPDATA%\Microsoft\FSX-SE\Controls\ (ou a pasta do FSX), XML
Entradas que o jogo lê
lê 32 botões, 8 eixos por joystick (relatado)
Lista de comandos a partir de
igual ao FSX
  • ✓ Importar
  • ✓ Exportar
  • ✓ Atribuições de teclado
  • ◐ ModificadoresFSX e Prepar3D: Ctrl/Shift/Alt nas teclas; nenhum modificador nas atribuições de joystick.
  • ✓ Lista de comandos criada no seu PC
  • ✓ Monitor de jogos
  • ✓ Curvas de eixo e zonas mortas
  • ✗ Configurações de controlo do jogo
  • ✗ Configurações de force feedback no jogo
  • ✗ Force feedback a partir da telemetria
  • ✗ Gravação de telemetria
  • ✓ Joystick virtual (vJoy)
  • ◐ Comando Xbox virtual
  • ✓ Funções virtuais
  • ◐ Assistente de configuração / Atribuição automática
  • ✗ Cockpits
  • ✓ Folhas de referência
  • ✗ Teste no jogo
Prepar3D v4 nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine p3d4
Ficheiro de atribuições
%APPDATA%\Lockheed Martin\Prepar3D v4\Controls\Standard.xml (XML)
Entradas que o jogo lê
lê 32 botões, 8 eixos por joystick (relatado)
Lista de comandos a partir de
a lista de eventos do próprio JoyPro + os seus ficheiros de controlos + o Standard.xmlx da instalação
  • ✓ Importar
  • ✓ Exportar
  • ✓ Atribuições de teclado
  • ◐ ModificadoresFSX e Prepar3D: Ctrl/Shift/Alt nas teclas; nenhum modificador nas atribuições de joystick.
  • ✓ Lista de comandos criada no seu PC
  • ✓ Monitor de jogos
  • ✓ Curvas de eixo e zonas mortas
  • ✗ Configurações de controlo do jogo
  • ✗ Configurações de force feedback no jogo
  • ✗ Force feedback a partir da telemetria
  • ✗ Gravação de telemetria
  • ✓ Joystick virtual (vJoy)
  • ◐ Comando Xbox virtual
  • ✓ Funções virtuais
  • ◐ Assistente de configuração / Atribuição automática
  • ✗ Cockpits
  • ✓ Folhas de referência
  • ✗ Teste no jogo
Prepar3D v5 nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine p3d5
Ficheiro de atribuições
%APPDATA%\Lockheed Martin\Prepar3D v5\Controls\Standard.xml (XML)
Entradas que o jogo lê
lê 32 botões, 8 eixos por joystick (relatado)
Lista de comandos a partir de
igual ao Prepar3D v4
  • ✓ Importar
  • ✓ Exportar
  • ✓ Atribuições de teclado
  • ◐ ModificadoresFSX e Prepar3D: Ctrl/Shift/Alt nas teclas; nenhum modificador nas atribuições de joystick.
  • ✓ Lista de comandos criada no seu PC
  • ✓ Monitor de jogos
  • ✓ Curvas de eixo e zonas mortas
  • ✗ Configurações de controlo do jogo
  • ✗ Configurações de force feedback no jogo
  • ✗ Force feedback a partir da telemetria
  • ✗ Gravação de telemetria
  • ✓ Joystick virtual (vJoy)
  • ◐ Comando Xbox virtual
  • ✓ Funções virtuais
  • ◐ Assistente de configuração / Atribuição automática
  • ✓ Cockpits
  • ✓ Folhas de referência
  • ✗ Teste no jogo
Prepar3D v6 nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine p3d6
Ficheiro de atribuições
%APPDATA%\Lockheed Martin\Prepar3D v6\Controls\Standard.xml (XML)
Entradas que o jogo lê
lê 32 botões, 8 eixos por joystick (relatado)
Lista de comandos a partir de
igual ao Prepar3D v4
  • ✓ Importar
  • ✓ Exportar
  • ✓ Atribuições de teclado
  • ◐ ModificadoresFSX e Prepar3D: Ctrl/Shift/Alt nas teclas; nenhum modificador nas atribuições de joystick.
  • ✓ Lista de comandos criada no seu PC
  • ✓ Monitor de jogos
  • ✓ Curvas de eixo e zonas mortas
  • ✗ Configurações de controlo do jogo
  • ✗ Configurações de force feedback no jogo
  • ✗ Force feedback a partir da telemetria
  • ✗ Gravação de telemetria
  • ✓ Joystick virtual (vJoy)
  • ◐ Comando Xbox virtual
  • ✓ Funções virtuais
  • ◐ Assistente de configuração / Atribuição automática
  • ✗ Cockpits
  • ✓ Folhas de referência
  • ✗ Teste no jogo

Da matriz de suporte, gerada a partir do código do motor: todos os jogos.

Para iniciantes

#Pôr a funcionar em 3 passos

  1. Configurar tudo por mim
    na página Início
  2. Usar estes botões
    veja primeiro a lista
  3. Escrever no meu jogo
    com o simulador fechado

Antes: inicie o simulador uma vez com os seus dispositivos ligados e depois feche-o.

Depois: abra as configurações de controlos do simulador e verifique as atribuições. Esta integração ainda não foi testada numa instalação real: por favor comunique o que for diferente.

Já atribuiu botões no simulador antes? Então a página Início oferece Importar e depois preencher lacunas. As suas atribuições ficam, e só os botões livres recebem novas funções. Veja Início rápido: pôr o meu manche a funcionar.

#O que o JoyPro faz pelo FSX e pelo Prepar3D

  • Importar: os eixos, botões e hats dos seus dispositivos entram no seu perfil, com a sensibilidade e a zona nula de cada eixo. As teclas do teclado entram quando as pede.
  • Relações: uma relação é uma função em todos os seus jogos ("Gear" no FSX, no MSFS e no X-Plane no mesmo botão). Os comandos são os nomes públicos de eventos dos simuladores (GEAR_TOGGLE, AXIS_AILERONS_SET ...).
  • Exportar: o JoyPro escreve o ficheiro de controlos ativo do simulador que exporta.

#Importar as suas atribuições

  1. Abra Iniciar. O cartão do seu simulador mostra a sua imagem. Se pedir uma lista de comandos, prima Criar lista: o JoyPro combina a sua própria lista de eventos com os eventos que os seus ficheiros de controlos (e os ficheiros de modelo do próprio simulador) nomeiam.
  2. Prima Importar no cartão. Escolha Adicionar ao meu perfil e marque Aceitar também as teclas do teclado se também quiser as suas teclas.
  3. Prima Importar agora. Ver as minhas relações abre o que entrou.

#Criar e verificar relações

Na página Relações, o evento do simulador de uma relação fica ao lado da mesma função nos seus outros jogos. Use o fluxo das relações para os juntar e depois prima Verificar agora na página Exportar (a Verificação).

#Exportar

  1. Feche o simulador. Ele reescreve o ficheiro quando sai; o JoyPro recusa enquanto fsx.exe ou Prepar3D.exe estiver a correr.
  2. Abra Exportar e use o cartão do seu simulador.
  3. Mantenha Substituir nos meus dispositivos com Limpar também os meus outros dispositivos se é no JoyPro que configura os seus dispositivos. Prima Exportar agora no cartão.
No jogo: O que vê no FSX e no Prepar3D

Inicie o simulador e abra as suas configurações de controlos: as atribuições dos seus dispositivos aparecem lá, e a sensibilidade e a zona nula de cada eixo na sua página de calibração. O caminho exato no menu e a forma como os simuladores mostram o ficheiro do JoyPro ainda não estão confirmados.

#O que faz você mesmo no FSX e no Prepar3D

  • Inicie o simulador uma vez com os seus dispositivos ligados, para que escreva o seu ficheiro de controlos.
  • Verifique o resultado depois da primeira exportação (veja acima). É o primeiro teste real desta integração no seu PC.
  • Um hat é atribuído como um todo e normalmente é o movimento da vista (PAN_VIEW). Outros eventos em direções individuais do hat não são escritos; atribua-os no simulador.

#Erros comuns

  • "O simulador está a correr": feche-o e exporte outra vez.
  • Um dispositivo perdeu as atribuições depois de o voltar a ligar: o Windows pode dar um GUID novo a um dispositivo. O JoyPro encontra então o seu mapa pelo nome quando exatamente um dispositivo ligado o tem (com um aviso).
  • Falta uma atribuição de joystick com modificador: o formato não tem modificadores em botões de joystick. As teclas podem ter Ctrl, Shift e Alt.
Avançado

#Ficheiros que o JoyPro lê e escreve

Simulador Ficheiro de controlos
FSX (versão em caixa) %APPDATA%\Microsoft\FSX\Controls\Standard.XML (ficheiro ativo segundo fsx.cfg [CONTROLS] Controls_Current)
FSX: Steam Edition %APPDATA%\Microsoft\FSX-SE\Controls\ ao lado do FSX em caixa, %APPDATA%\Microsoft\FSX\Controls\ quando instalado sozinho
Prepar3D v4 / v5 / v6 %APPDATA%\Lockheed Martin\Prepar3D v<N>\Controls\Standard.xml (ficheiro ativo segundo Prepar3D.cfg [CONTROLS])
todos <file>.joypro.json (as entradas que o JoyPro escreveu), <file>.joypro-meta.json (nomes, grupos e ajustes para a próxima importação)

O Standard.xmlx do Prepar3D (predefinições de dispositivo) e o modelo do FSX na pasta de instalação são lidos para a lista de comandos e nunca escritos.

#Os modos de exportação no FSX e no Prepar3D

Modo O que acontece no simulador
Só adicionar Nunca remove nem substitui um bloco. Uma atribuição numa entrada que tem outro evento não é escrita e é listada.
Atualizar, manter atribuições do jogo Substitui o evento na sua entrada (o conflito) e mantém tudo o resto.
Atualizar, o meu perfil ganha Também remove as outras entradas dos eventos que atribui (dispositivos ligados; o teclado só com a opção de teclado).
Substituir nos meus dispositivos Os mapas principais dos dispositivos que escreve ficam só com as suas atribuições.
+ Limpar também os meus outros dispositivos Os mapas principais dos outros dispositivos ligados são esvaziados (os mapas ficam).

#O que nunca é tocado

  • Os mapas de dispositivos que não estão ligados, os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha.
  • Os mapas de slew (... SLEW {GUID}), Mouse Yoke, Mouse Look, os mapas por SimObject do Prepar3D e o mapa do teclado, a menos que exporte atribuições de teclado.
  • Combinações de duas teclas simples, comentários, formatação e elementos desconhecidos.

#Curvas e configurações

  • Granularidade: global, um ficheiro para todas as aeronaves.
  • Configurações de eixo (modelo de eixos fsx): sensibilidade (0 a 127) e zona nula (0 a 127) por eixo de dispositivo, como na página de calibração. A Curva predefinida é ajustada (zona morta para zona nula, saturação para sensibilidade); uma forma de curva não tem equivalente. No modo Atualizar, os valores definidos no simulador ficam quando os do JoyPro são a predefinição simples.
  • Inverter: uma sensibilidade negativa.
  • Sem force feedback, configurações do jogo nem telemetria. O monitor de jogos deteta alterações depois de o simulador fechar.
Detalhes técnicos internos

#Por dentro da integração do FSX e do Prepar3D

flowchart LR
  P["O seu perfil<br/>(relações + atribuições)"] --> E["engine fsx / fsxse /<br/>p3d4 / p3d5 / p3d6 export"]
  E --> X["Controls / Standard.XML:<br/>um mapa por dispositivo<br/>(nome do dispositivo {GUID}),<br/>KEYBOARD_MAIN (só com<br/>a opção de teclado)"]
  X --> G["As configurações de controlos do simulador"]
Um ficheiro de controlos por simulador. O mapa do teclado só é escrito com a opção de teclado.

Código: engine\Games\FsxIntegration.cs (uma classe, um jogo por simulador), engine\Games\FsxControlsFile.cs (edição de texto de blocos inteiros), engine\Games\FsxEvents.cs (a lista de eventos do JoyPro).

  • Formato: <SimControls.Map> com <Name>, <Axis> (<Index> 0 a 7 = X, Y, Z, Rx, Ry, Rz, Slider, segundo slider; <AxEvent>, <AxScale>, <AxNull>), <Entry> (<Index> do botão a contar de 0, <Down> / <Up>, <DownRpt>1 para eventos que se repetem) e <POV> (um hat inteiro). Cabeçalho encoding="Windows-1252".
  • Dispositivos: um mapa por dispositivo DirectInput com o nome <instance name>{<instance GUID>}; a correspondência é feita pelo GUID, ou senão pelo nome quando exatamente um dispositivo ligado o tem. Um dispositivo que o ficheiro não tem recebe um mapa novo. São indicados 32 botões e 8 eixos por dispositivo.
  • Mapeamento: JOY_X .. JOY_SLIDER2 para <Index> 0 a 7, JOY_BTN<n> para <Index> n-1, um hat na sua direção para cima (JOY_BTN_POV1_U).
  • Lista de comandos: engine fsx refresh-db (e fsxse, p3d4, p3d5, p3d6): cerca de 150 eventos com os títulos do JoyPro, mais todos os eventos que os seus ficheiros de controlos e os modelos do simulador nomeiam; os eventos AXIS_* são eixos.
  • Importação / exportação: engine fsx paths (primeiro o ficheiro ativo), engine fsx import, engine fsx scan, engine fsx export, e o mesmo para engine fsxse export, engine p3d4 export, engine p3d5 export, engine p3d6 export. Backup antes da primeira escrita.

#Limites conhecidos

  • Tudo precisa de ser verificado numa instalação real: o cabeçalho do Prepar3D v4+ e se <Name> ainda contém o GUID, os bytes exatos que os simuladores escrevem, o nome do eixo do segundo slider, e se um simulador mantém um mapa novo que o JoyPro acrescente para um dispositivo que ainda não viu.
  • O nome do ficheiro de configuração do FSX: Steam Edition é deduzido.
  • Testes: engine\tests\smoke\fsx.ps1 com um ficheiro sintético criado a partir do formato documentado.

Todas as notas técnicas sobre este jogo (geradas a partir do repositório): fsx-p3d.md.