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.xmlxda 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.
#Pôr a funcionar em 3 passos
- Configurar tudo por mim
na página Início - Usar estes botões
veja primeiro a lista - 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
- 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.
- 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.
- 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
- Feche o simulador. Ele reescreve o ficheiro quando sai; o JoyPro recusa enquanto
fsx.exeouPrepar3D.exeestiver a correr. - Abra Exportar e use o cartão do seu simulador.
- 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.
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.
#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.
#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"]
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>1para eventos que se repetem) e<POV>(um hat inteiro). Cabeçalhoencoding="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_SLIDER2para<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(efsxse,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 eventosAXIS_*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 paraengine 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.ps1com 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.