Joystick autopilot bindings: Difference between revisions

Moving up a suitable first section; Breaking out a prerequisite section; cat
m (Minor linguistic improvements)
(Moving up a suitable first section; Breaking out a prerequisite section; cat)
Line 1: Line 1:
== Introduction ==
This page describes joystick bindings, which can be used to control the (simulated) autopilot with a set of joystick buttons.


== Prerequisites ==
Before you start, read [[Input device]] and probably [[Writing Joystick Code: Part 1]].
Before you start, read [[Input device]] and probably [[Writing Joystick Code: Part 1]].


Autopilots are often very useful devices, but unfortunately there standard key bindings of Flightgear control the `magic autopilot' rather than the simulated real one, and the only way to control popular GA autopilots is by clicking the corresponding buttons in the 3D-cockpit. This is awkward if there is a need to change mode or turn off the autopilot quickly (at final stage of ILS landing, or if the autopilot does something silly). This page describes joystick bindings, which can be used to control the (simulated) autopilot with a set of joystick buttons.
== Introduction ==
Autopilots are often very useful devices, but unfortunately there standard key bindings of Flightgear control the `magic autopilot' rather than the simulated real one, and the only way to control popular GA autopilots is by clicking the corresponding buttons in the 3D-cockpit. This is awkward if there is a need to change mode or turn off the autopilot quickly (at final stage of ILS landing, or if the autopilot does something silly).
 
Every type of autopilot is operated quite differently, such that these keys only work for specific models. Here, key bindings are provided for the  [[Bendix/King KAP140 Autopilot]] (in the [[Cessna 172]]) and the [http://www.centuryflight.com/manuals/CENTIII.pdf CENTURY III Autopilot POH] ([[Seneca II]]).
Every type of autopilot is operated quite differently, such that these keys only work for specific models. Here, key bindings are provided for the  [[Bendix/King KAP140 Autopilot]] (in the [[Cessna 172]]) and the [http://www.centuryflight.com/manuals/CENTIII.pdf CENTURY III Autopilot POH] ([[Seneca II]]).
Those were prioritised, as the more complex autopilots in jets usually have a dedicated GUI and therefore maybe less in need of joystick binding. However, it is planned to provide bindings for at least basic functions like AUTOPILOT OFF for other autopilot types in the future.  
Those were prioritised, as the more complex autopilots in jets usually have a dedicated GUI and therefore maybe less in need of joystick binding. However, it is planned to provide bindings for at least basic functions like AUTOPILOT OFF for other autopilot types in the future.  


== Implementation ==
== Implementation ==
The example code provides a setup for six buttons arranged like this:
The example code provides a setup for six buttons arranged like this:


Line 636: Line 638:
== Summary ==
== Summary ==
For convenience all of the above bindings are summarised into one file accessible at [http://pastebin.com/2HM9S1df pastebin] (at the time of writing identical to the combination of the snippets above but of course the pastebin might not always keep up with the Wiki - beware)
For convenience all of the above bindings are summarised into one file accessible at [http://pastebin.com/2HM9S1df pastebin] (at the time of writing identical to the combination of the snippets above but of course the pastebin might not always keep up with the Wiki - beware)
[[Category:Documentation]]