FSX, FSX: Steam Edition en Prepar3D v4, v5 en v6 bewaren je bediening in één XML-bestand in %APPDATA%: één map per apparaat met zijn assen, knoppen en hat, plus het toetsenbord. JoyPro leest dat bestand in je profiel, koppelt het in relaties aan je andere games en schrijft het blok voor blok terug, waarbij opmaak, commentaar en andere maps blijven zoals ze zijn. Elke sim is in JoyPro een eigen game, omdat elke sim een eigen bestand heeft.
Deze koppeling is geschreven op basis van openbare bronnen en wordt alleen door een synthetisch testbestand gedekt: geen van deze sims is al met JoyPro getest op een echte installatie. Open na je eerste export de bediening van de sim, controleer de toewijzingen en meld alsjeblieft wat afwijkt.
Microsoft Flight Simulator X rechtstreeks (eigen toewijzingsbestanden)
- Ondersteuning
- rechtstreeks (eigen toewijzingsbestanden)
- Engine-commando
engine fsx- Toewijzingsbestand
%APPDATA%\Microsoft\FSX\Controls\Standard.XML(XML)- Inputs die de game leest
- leest 32 knoppen, 8 assen per joystick (gemeld)
- Commandolijst uit
- JoyPro's eigen eventlijst (openbare SDK-id's) + de events van je besturingsbestanden en het sjabloon van de installatie
- ✓ Importeren
- ✓ Exporteren
- ✓ Toetsenbordtoewijzingen
- ◐ ModifiersFSX en Prepar3D: Ctrl/Shift/Alt op toetsen; geen modifier op joysticktoewijzingen.
- ✓ Commandolijst gemaakt op je pc
- ✓ Gamebewaking
- ✓ Ascurves en dode zones
- ✗ Bedieningsinstellingen van de game
- ✗ Force-feedbackinstellingen in de game
- ✗ Force feedback uit telemetrie
- ✗ Telemetrie-opname
- ✓ Virtuele joystick (vJoy)
- ◐ Virtuele Xbox-pad
- ✓ Virtuele functies
- ◐ Installatiewizard / Automatisch toewijzen
- ✓ Cockpits
- ✓ Spiekbrieven
- ✗ In-game test
Microsoft Flight Simulator X: Steam Edition rechtstreeks (eigen toewijzingsbestanden)
- Ondersteuning
- rechtstreeks (eigen toewijzingsbestanden)
- Engine-commando
engine fsxse- Toewijzingsbestand
%APPDATA%\Microsoft\FSX-SE\Controls\(of de FSX-map), XML- Inputs die de game leest
- leest 32 knoppen, 8 assen per joystick (gemeld)
- Commandolijst uit
- zoals FSX
- ✓ Importeren
- ✓ Exporteren
- ✓ Toetsenbordtoewijzingen
- ◐ ModifiersFSX en Prepar3D: Ctrl/Shift/Alt op toetsen; geen modifier op joysticktoewijzingen.
- ✓ Commandolijst gemaakt op je pc
- ✓ Gamebewaking
- ✓ Ascurves en dode zones
- ✗ Bedieningsinstellingen van de game
- ✗ Force-feedbackinstellingen in de game
- ✗ Force feedback uit telemetrie
- ✗ Telemetrie-opname
- ✓ Virtuele joystick (vJoy)
- ◐ Virtuele Xbox-pad
- ✓ Virtuele functies
- ◐ Installatiewizard / Automatisch toewijzen
- ✗ Cockpits
- ✓ Spiekbrieven
- ✗ In-game test
Prepar3D v4 rechtstreeks (eigen toewijzingsbestanden)
- Ondersteuning
- rechtstreeks (eigen toewijzingsbestanden)
- Engine-commando
engine p3d4- Toewijzingsbestand
%APPDATA%\Lockheed Martin\Prepar3D v4\Controls\Standard.xml(XML)- Inputs die de game leest
- leest 32 knoppen, 8 assen per joystick (gemeld)
- Commandolijst uit
- JoyPro's eigen eventlijst + je besturingsbestanden + de
Standard.xmlxvan de installatie
- ✓ Importeren
- ✓ Exporteren
- ✓ Toetsenbordtoewijzingen
- ◐ ModifiersFSX en Prepar3D: Ctrl/Shift/Alt op toetsen; geen modifier op joysticktoewijzingen.
- ✓ Commandolijst gemaakt op je pc
- ✓ Gamebewaking
- ✓ Ascurves en dode zones
- ✗ Bedieningsinstellingen van de game
- ✗ Force-feedbackinstellingen in de game
- ✗ Force feedback uit telemetrie
- ✗ Telemetrie-opname
- ✓ Virtuele joystick (vJoy)
- ◐ Virtuele Xbox-pad
- ✓ Virtuele functies
- ◐ Installatiewizard / Automatisch toewijzen
- ✗ Cockpits
- ✓ Spiekbrieven
- ✗ In-game test
Prepar3D v5 rechtstreeks (eigen toewijzingsbestanden)
- Ondersteuning
- rechtstreeks (eigen toewijzingsbestanden)
- Engine-commando
engine p3d5- Toewijzingsbestand
%APPDATA%\Lockheed Martin\Prepar3D v5\Controls\Standard.xml(XML)- Inputs die de game leest
- leest 32 knoppen, 8 assen per joystick (gemeld)
- Commandolijst uit
- zoals Prepar3D v4
- ✓ Importeren
- ✓ Exporteren
- ✓ Toetsenbordtoewijzingen
- ◐ ModifiersFSX en Prepar3D: Ctrl/Shift/Alt op toetsen; geen modifier op joysticktoewijzingen.
- ✓ Commandolijst gemaakt op je pc
- ✓ Gamebewaking
- ✓ Ascurves en dode zones
- ✗ Bedieningsinstellingen van de game
- ✗ Force-feedbackinstellingen in de game
- ✗ Force feedback uit telemetrie
- ✗ Telemetrie-opname
- ✓ Virtuele joystick (vJoy)
- ◐ Virtuele Xbox-pad
- ✓ Virtuele functies
- ◐ Installatiewizard / Automatisch toewijzen
- ✓ Cockpits
- ✓ Spiekbrieven
- ✗ In-game test
Prepar3D v6 rechtstreeks (eigen toewijzingsbestanden)
- Ondersteuning
- rechtstreeks (eigen toewijzingsbestanden)
- Engine-commando
engine p3d6- Toewijzingsbestand
%APPDATA%\Lockheed Martin\Prepar3D v6\Controls\Standard.xml(XML)- Inputs die de game leest
- leest 32 knoppen, 8 assen per joystick (gemeld)
- Commandolijst uit
- zoals Prepar3D v4
- ✓ Importeren
- ✓ Exporteren
- ✓ Toetsenbordtoewijzingen
- ◐ ModifiersFSX en Prepar3D: Ctrl/Shift/Alt op toetsen; geen modifier op joysticktoewijzingen.
- ✓ Commandolijst gemaakt op je pc
- ✓ Gamebewaking
- ✓ Ascurves en dode zones
- ✗ Bedieningsinstellingen van de game
- ✗ Force-feedbackinstellingen in de game
- ✗ Force feedback uit telemetrie
- ✗ Telemetrie-opname
- ✓ Virtuele joystick (vJoy)
- ◐ Virtuele Xbox-pad
- ✓ Virtuele functies
- ◐ Installatiewizard / Automatisch toewijzen
- ✗ Cockpits
- ✓ Spiekbrieven
- ✗ In-game test
Uit de ondersteuningstabel, gegenereerd uit de code van de engine: alle games.
#In 3 stappen aan de slag
- Alles voor me instellen
op de startpagina - Deze knoppen gebruiken
bekijk eerst de lijst - Naar mijn game schrijven
houd de sim gesloten
Vooraf: start de sim één keer met je apparaten aangesloten en sluit hem dan.
Daarna: open de bedieningsinstellingen van de sim en controleer de toewijzingen. Deze koppeling is nog niet getest op een echte installatie: meld alsjeblieft wat afwijkt.
Heb je eerder knoppen toegewezen in de sim? Dan biedt de startpagina Importeren, dan gaten vullen aan. Je toewijzingen blijven, en alleen vrije knoppen krijgen nieuwe taken. Zie Snelstart: mijn stick laten werken.
#Wat JoyPro doet voor FSX en Prepar3D
- Importeren: de assen, knoppen en hats van je apparaten komen in je profiel, met de gevoeligheid en null zone van elke as. Toetsenbordtoetsen komen mee als je erom vraagt.
- Relaties: één relatie is één functie in al je games ("Gear" in FSX, MSFS en X-Plane op dezelfde knop). De commando's zijn de openbare eventnamen van de sims (
GEAR_TOGGLE,AXIS_AILERONS_SET...). - Exporteren: JoyPro schrijft het actieve bedieningsbestand van de sim die je exporteert.
#Je toewijzingen importeren
- Open Start. De kaart van je sim toont de afbeelding ervan. Vraagt de kaart om een commandolijst, druk dan op Lijst maken: JoyPro combineert zijn eigen eventlijst met de events die je bedieningsbestanden (en de eigen sjabloonbestanden van de sim) noemen.
- Druk op Importeren op de kaart. Kies Aan mijn profiel toevoegen en vink Neem ook de toetsenbordtoetsen over aan als je je toetsen ook wilt.
- Druk op Nu importeren. Mijn relaties bekijken opent wat er binnenkwam.
#Relaties maken en controleren
Op de pagina Relaties staat het event van de sim bij een relatie naast dezelfde functie in je andere games. Gebruik de werkwijze voor relaties om ze samen te voegen en druk dan op Nu controleren op de pagina Exporteren (de controle).
#Exporteren
- Sluit de sim. Hij herschrijft het bestand bij het afsluiten; JoyPro weigert zolang
fsx.exeofPrepar3D.exedraait. - Open Exporteren en gebruik de kaart van je sim.
- Laat Vervangen op mijn apparaten met Ook mijn andere apparaten wissen staan als je je apparaten in JoyPro instelt. Druk op Nu exporteren op de kaart.
Start de sim en open de bedieningsinstellingen: daar staan de toewijzingen van je apparaten, en de gevoeligheid en null zone van elke as op de kalibratiepagina. Het precieze menupad en hoe de sims het bestand van JoyPro tonen, zijn nog niet bevestigd.
#Wat je zelf doet in FSX en Prepar3D
- Start de sim één keer met je apparaten aangesloten, zodat hij zijn bedieningsbestand schrijft.
- Controleer het resultaat na de eerste export (zie hierboven). Het is de eerste echte test van deze koppeling op je pc.
- Een hat wordt als geheel toegewezen en is normaal gesproken het rondkijken (
PAN_VIEW). Andere events op losse hatrichtingen worden niet geschreven; wijs die in de sim toe.
#Veelgemaakte fouten
- "De sim draait": sluit hem en exporteer opnieuw.
- Een apparaat verloor zijn toewijzingen na opnieuw aansluiten: Windows kan een apparaat een nieuwe GUID geven. JoyPro vindt de map dan op naam als precies één aangesloten apparaat die naam heeft (met een waarschuwing).
- Een joysticktoewijzing met modifier ontbreekt: het formaat kent geen modifiers op joystickknoppen. Toetsen kunnen Ctrl, Shift en Alt hebben.
#Bestanden die JoyPro leest en schrijft
| Sim | Bedieningsbestand |
|---|---|
| FSX (boxed) | %APPDATA%\Microsoft\FSX\Controls\Standard.XML (actief bestand uit fsx.cfg [CONTROLS] Controls_Current) |
| FSX: Steam Edition | %APPDATA%\Microsoft\FSX-SE\Controls\ naast boxed FSX, %APPDATA%\Microsoft\FSX\Controls\ als het alleen geïnstalleerd is |
| Prepar3D v4 / v5 / v6 | %APPDATA%\Lockheed Martin\Prepar3D v<N>\Controls\Standard.xml (actief bestand uit Prepar3D.cfg [CONTROLS]) |
| alle | <file>.joypro.json (de inputs die JoyPro schreef), <file>.joypro-meta.json (namen, groepen en afstemming voor de volgende import) |
Standard.xmlx van Prepar3D (apparaatpresets) en het sjabloon van FSX in de installatiemap worden gelezen voor de commandolijst en nooit geschreven.
#De exportmodi in FSX en Prepar3D
| Modus | Wat er in de sim gebeurt |
|---|---|
| Alleen toevoegen | Verwijdert of vervangt nooit een blok. Een toewijzing op een input die een ander event heeft, wordt niet geschreven en wordt vermeld. |
| Bijwerken, toewijzingen van game behouden | Vervangt het event op je input (het conflict) en houdt al het andere. |
| Bijwerken, mijn profiel wint | Verwijdert ook de andere inputs van de events die je toewijst (aangesloten apparaten; het toetsenbord alleen met de toetsenbordoptie). |
| Vervangen op mijn apparaten | De hoofdmaps van de apparaten die je schrijft, houden alleen jouw toewijzingen. |
| + Ook mijn andere apparaten wissen | De hoofdmaps van de andere aangesloten apparaten worden leeggemaakt (de maps blijven). |
#Wat nooit wordt aangeraakt
- Maps van apparaten die niet zijn aangesloten, de genegeerde apparaten van de import en het vJoy-apparaat waar JoyPro doorheen tunnelt.
- De slew-maps (
... SLEW {GUID}),Mouse Yoke,Mouse Look, de maps per SimObject van Prepar3D, en de toetsenbordmap, tenzij je toetsenbordtoewijzingen exporteert. - Toetscombinaties van twee gewone toetsen, opmerkingen, opmaak en onbekende elementen.
#Curves en instellingen
- Granulariteit: globaal, één bestand voor alle toestellen.
- Asinstellingen (asmodel
fsx): gevoeligheid (0 tot 127) en null zone (0 tot 127) per apparaatas, zoals op de kalibratiepagina. De Standaardcurve wordt aangepast (dode zone naar null zone, saturatie naar gevoeligheid); een curvevorm heeft geen tegenhanger. In de modus Bijwerken blijven waarden die in de sim zijn ingesteld, als die van JoyPro de gewone standaard zijn. - Omkeren: een negatieve gevoeligheid.
- Geen force feedback, game-instellingen of telemetrie. De gamebewaking merkt wijzigingen op nadat de sim is afgesloten.
#Binnen in de koppeling voor FSX en Prepar3D
flowchart LR
P["Je profiel<br/>(relaties + toewijzingen)"] --> E["engine fsx / fsxse /<br/>p3d4 / p3d5 / p3d6 export"]
E --> X["Controls / Standard.XML:<br/>één map per apparaat<br/>(apparaatnaam {GUID}),<br/>KEYBOARD_MAIN (alleen met<br/>de toetsenbordoptie)"]
X --> G["De bedieningsinstellingen van de sim"]
Code: engine\Games\FsxIntegration.cs (één klasse, één game per sim), engine\Games\FsxControlsFile.cs (tekstbewerking van hele blokken), engine\Games\FsxEvents.cs (de eventlijst van JoyPro).
- Formaat:
<SimControls.Map>met<Name>,<Axis>(<Index>0 tot 7 = X, Y, Z, Rx, Ry, Rz, Slider, tweede slider;<AxEvent>,<AxScale>,<AxNull>),<Entry>(knop-<Index>vanaf 0,<Down>/<Up>,<DownRpt>1voor herhalende events) en<POV>(een hele hat). Headerencoding="Windows-1252". - Apparaten: een map per DirectInput-apparaat met de naam
<instance name>{<instance GUID>}; gekoppeld op GUID, anders op naam als precies één aangesloten apparaat die naam heeft. Een apparaat dat niet in het bestand staat, krijgt een nieuwe map. Per apparaat worden 32 knoppen en 8 assen gemeld. - Toewijzingstabel:
JOY_X..JOY_SLIDER2naar<Index>0 tot 7,JOY_BTN<n>naar<Index>n-1, een hat op zijn richting omhoog (JOY_BTN_POV1_U). - Commandolijst:
engine fsx refresh-db(enfsxse,p3d4,p3d5,p3d6): ongeveer 150 events met de titels van JoyPro plus elk event dat je bedieningsbestanden en de sjablonen van de sim noemen;AXIS_*-events zijn assen. - Importeren / exporteren:
engine fsx paths(het actieve bestand eerst),engine fsx import,engine fsx scan,engine fsx export, en hetzelfde voorengine fsxse export,engine p3d4 export,engine p3d5 export,engine p3d6 export. Back-up vóór de eerste keer schrijven.
#Bekende beperkingen
- Alles moet nog op een echte installatie worden gecontroleerd: de header van Prepar3D v4+ en of
<Name>nog de GUID bevat, de exacte bytes die de sims schrijven, de asnaam van de tweede slider, en of een sim een nieuwe map houdt die JoyPro toevoegt voor een apparaat dat de sim nog niet heeft gezien. - De naam van het configuratiebestand van FSX: Steam Edition is afgeleid.
- Tests:
engine\tests\smoke\fsx.ps1met een kunstmatig bestand, opgebouwd uit het gedocumenteerde formaat.
Alle technische notities over deze game (gegenereerd uit de repository): fsx-p3d.md.