]> git.mxchange.org Git - flightgear.git/blob - docs-mini/README.running
Merge branch 'jmt/gui' into next
[flightgear.git] / docs-mini / README.running
1 Starting the executable
2 =======================
3
4 Unix:    runfgfs
5 Windows: runfgfs.bat
6
7 "runfgfs" is a script which runs the Flight Gear executable with
8 (hopefully) the correct $FG_ROOT directory specified.
9
10
11 First Flight
12 ============
13
14 By default, the plane should be looking more or less straight down a
15 runway, and the mouse cursor should be a regular pointer.  The
16 following steps will help you to get into the air:
17
18 - click the right mouse button once, so that a cross cursor
19   appears (now, the mouse will act as a control yoke)
20
21 - while holding down the left mouse button, push the mouse cursor up
22   until the engine is at full power (the throttle indicator is on the
23   left side of the HUD), then release the left mouse button
24
25 - when the plane is moving fast enough (say, 100 knots for the default 
26   Navion), slowly pull the mouse cursor down (with no buttons pressed) 
27   to raise the elevators until the plane rolls off the runway and into
28   the air
29
30 - while holding down the left mouse button, move the mouse cursor down 
31   slightly to ease up on the throttle, then release the left mouse
32   button
33
34 - move the mouse up, down, and sideways as necessary to establish
35   level flight -- small movements are best, or you may lose control of
36   the plane
37
38 - click the right mouse button once more, so that a double-arrow
39   cursor appears (now, the mouse will allow you to look around)
40
41 - move the mouse around to look out of the plane at different angles
42
43 - press the left mouse button once to return the view to front and
44   centre
45
46 - click the right mouse button *twice*, so that the cross cursor
47   appears again (you're in yoke mode)
48
49 - now that you know how to operate the throttle, ailerons, and
50   elevators (as well as how to look around), try to circle around and
51   land back on the runway (best of luck)
52
53
54 Mouse controls
55 ==============
56
57 It is possible to manipulate the basic flight controls and the view
58 using only the mouse.  Clicking the right mouse button toggles the
59 mouse among three different modes:
60
61 1. Pointer mode (the default: mouse cursor is a pointer)
62 2. Yoke mode (mouse cursor is a cross)
63 3. Look-around mode (mouse pointer is a double arrow)
64
65 In yoke mode and look-around mode, the mouse cursor will remain
66 trapped in the Flight Gear window.
67
68
69 Yoke mode
70 ---------
71
72 In yoke mode (mouse cursor as cross), mouse movement adjusts the main
73 flight controls, depending on which buttons you press.
74
75 With no button pressed:
76 (like a control yoke on an airplane)
77 - horizontal movement controls the ailerons
78 - vertical movement controls the elevators
79
80 With left button pressed:
81 - horizontal movement controls the brakes
82 - vertical movement controls the throttle
83
84 With middle button pressed:
85 - horizontal movement controls the rudder
86 - vertical movement controls the trim
87
88
89 Look-around mode
90 ----------------
91
92 In look-around mode (mouse cursor as double arrow), mouse movement
93 changes the viewing direction: horizontal movement scrolls the view
94 horizontally, and vertical movement scrolls the view vertically in the
95 direction of mouse movement.
96
97 To return the view to front and center, click the left mouse button
98 once.
99
100
101 Keyboard controls
102 =================
103
104 It is also possible to fly using the numeric keypad.  There is some
105 unresolved wierdness with the GLUT libraries and keyboard input, so
106 for now, the state of the "Num Lock" key is important.
107
108 Num Lock Active
109 ---------------
110
111     Pg Up/Pg Dn             Throttle
112     Left Arrow/Right Arrow  Aileron
113     Up Arrow/Down Arrow     Elevator
114     Ins/Enter               Rudder
115     "5"                     Center aileron/elevator/rudder
116     Home/End                Elevator Trim
117
118 Num Lock Inactive
119 -----------------
120     Shift + <Numeric Keypad Key>   Change view
121
122     where key is one of:
123
124     8 = forward
125     7 = left/forward
126     4 = left
127     1 = left/back
128     2 = back
129     3 = right/back
130     6 = right
131     9 = right/forward
132
133 Brakes
134 ------
135     Press the "b" key to toggle
136
137 Autopilot
138 ---------
139     Control + A             Toggle autopilot altitude lock.
140     Control + H             Toggle autopilot heading lock.
141     Control + S             Toggle autopilot autothrottle.
142     Control + T             Toggle autopilot terrain follow.
143
144 Simulation
145 ----------
146
147     ESC                     Quit Flight Gear.
148
149     a                       Increase speedup.
150     b                       Toggle brakes.
151     h                       Dim HUD.
152     i                       Revert to full HUD.
153     m                       Increase time warp.
154     p                       Toggle pause.
155     t                       Increase time warp delta.
156     v                       Toggle external view mode.
157     x                       Zoom out (narrow field of view).
158     z                       Increase visibility.
159
160     Shift + A               Decrease speedup.
161     Shift + H               Brighten HUD
162     Shift + I               Minimize HUD
163     Shift + M               Decrease time warp.
164     Shift + P               Toggle 2D panel display.
165     Shift + T               Decrease time warp delta.
166     Shift + W               Toggle fullscreen/window mode.
167     Shift + X               Zoom out (widen field of view).
168     Shift + Z               Decrease visibility.
169
170 Other
171 -----
172     F2 = Reload tile cache.
173     F6 = Toggle autopilot target location.
174     F8 = Toggle fog modes (off, fastest, nicest)
175     F9 = Toggle textures on/off
176     F10 = Toggle menu
177     F11 = Set autopilot altitude
178     F12 = Set autopilot heading