1 .\" Copyright (C) 2001 Cameron Moore
3 .\" This program is free software; you can redistribute it and/or
4 .\" modify it under the terms of the GNU General Public License
5 .\" as published by the Free Software Foundation; either version 2
6 .\" of the License, or (at your option) any later version.
8 .\" This program is distributed in the hope that it will be useful,
9 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
10 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 .\" GNU General Public License for more details.
13 .\" You should have received a copy of the GNU General Public License
14 .\" along with this program; if not, write to the Free Software
15 .\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
16 .\" Or try here: http://www.fsf.org/copyleft/gpl.html
19 .TH FGFS 1 "August 2001" "@VERSION@" "@PACKAGE@"
21 fgfs \- FlightGear Flight Simulator
27 is a free, open-source, multi-platform, and sophisticated flight
28 simulator framework for the development and pursuit of interesting
29 flight simulator ideas.
33 Specify aerodynamics model to load.
35 .BI "--aircraft=" "name"
36 Specify aircraft to load.
38 .BI "--aircraft-dir=" "path"
39 Specify the aircraft model directory relative to the path of the
40 executable. This is used for UIUC aircraft only.
42 .BI "--airport-id=" "id"
43 Specify starting postion by airport ID.
45 .BI "--altitude=" "value"
46 Specify starting altitude (in feet unless --units-meters specified).
48 .BI "--atlas=" "medium" "," "direction" "," "hz" "," "options" "," "..."
49 Open an IO connection using the Atlas protocol.
52 Specify the bits per pixel for the renderer.
54 .BI "--browser-app=" "path"
55 Specify location of your web browser.
57 .BI "--clouds-asl=" "altitude"
58 Specify altitude of cloud layer above sea level.
60 .BI "--config=" "path"
61 Load additional properties from path. Multiple instances of this
62 option are recognized.
64 .BI "--control=" "mode"
65 Primary control mode (joystick, keyboard, mouse).
67 .B "--disable-anti-alias-hud"
68 Disable anti-aliased HUD.
70 .B "--disable-auto-coordination"
71 Disable auto coordination between aileron and rudder.
74 Disable cloud rendering.
77 Start out in a running state.
79 .B "--disable-fuel-freeze"
80 Disable fuel freeze (enabling fuel consumption).
82 .B "--disable-fullscreen"
83 Disable fullscreen mode.
85 .B "--disable-game-mode"
86 Disable fullscreen game mode.
91 .B "--disable-intro-music"
92 Disable introduction music.
94 .B "--disable-mouse-pointer"
95 Disable extra mouse pointer.
97 .B "--disable-network-olk"
98 Disable Multi-pilot mode.
101 Disable instrument panel.
103 .B "--disable-skyblend"
104 Disable sky blending.
107 Disable sound effects.
109 .B "--disable-splash-screen"
110 Disable splash screen.
112 .B "--disable-textures"
115 .B "--disable-wireframe"
116 Disable wireframe drawing mode.
118 .B "--enable-anti-alias-hud"
119 Enable anti-aliased HUD.
121 .B "--enable-auto-coordination"
122 Enable auto coordination between aileron and rudder.
125 Enable cloud rendering.
128 Start out in a frozen state.
130 .B "--enable-fuel-freeze"
131 Enable fuel freeze (disabling fuel consumption).
133 .B "--enable-fullscreen"
134 Enable fullscreen mode.
136 .B "--enable-game-mode"
137 Enable fullscreen game mode.
142 .B "--enable-intro-music"
143 Enable introduction music.
145 .B "--enable-mouse-pointer"
146 Enable extra mouse pointer (i.e. for full screen voodoo/voodoo-II
149 .B "--enable-network-olk"
150 Enable Multi-pilot mode.
153 Enable instrument panel.
155 .B "--enable-skyblend"
159 Enable sound effects.
161 .B "--enable-splash-screen"
162 Enable splash screen.
164 .B "--enable-textures"
167 .B "--enable-wireframe"
168 Enable wireframe drawing mode.
171 Specify the flight dynamics model to use. Can be one of jsb, larcsim, yasim,
172 magic, balloon, ada, external, or null.
174 .BI "--fg-root=" "path"
175 Specify the root path for data files.
177 .BI "--fg-scenery=" "path"
178 Specify the base path for scenery data.
180 .BI "--flight-plan=" "file"
181 Read all waypoints from the specified file.
184 Disable fog rendering.
187 Enable fastest fog rendering.
190 Enable nicest fog rendering.
192 .BI "--fov=" "degrees"
193 Specify initial field of view angle (degrees).
195 .BI "--garmin=" "medium" "," "direction" "," "hz" "," "options" "," "..."
196 Open an IO connection using the Garmin GPS protocol.
198 .BI "--geometry=" "WxH"
199 Specify window geometry (ie. 640x480, 800x600, etc).
201 .BI "--heading=" "degrees"
202 Specify heading or yaw angle (degrees).
204 .BR "--help" ", " "-h"
207 .BI "--httpd=" "port"
208 Start an HTTP server on the specified port.
211 HUD displays percentage of triangles culled.
214 HUD displays number of triangles rendered.
217 Start up in the air. This is implied when specifying an initial
218 altitude above ground level.
220 .BI "--joyclient=" "medium" "," "direction" "," "hz" "," "options" "," "..."
221 Open an IO connection to an Agwagon joystick
223 .BI "--jpg-httpd=" "port"
224 Start a screen shot HTTP server on the specified port.
226 .BI "--lat=" "degrees"
227 Specify starting latitude (degrees).
229 .BI "--lon=" "degrees"
230 Specify starting longitude (degrees).
232 .BI "--mach=" "value"
233 Specify initial mach number.
235 .BI "--model-hz=" "n"
236 Run the FDM at this rate (iterations per second).
238 .BI "--native-ctrls=" "medium" "," "direction" "," "hz" "," "options" "," "..."
239 Open an IO connection using the FlightGear Native Controls protocol.
241 .BI "--native-fdm=" "medium" "," "direction" "," "hz" "," "options" "," "..."
242 Open an IO connection using the FlightGear Native FDM protocol.
244 .BI "--native=" "medium" "," "direction" "," "hz" "," "options" "," "..."
245 Open an IO connection using the FlightGear Native protocol.
248 Enable network information in the HUD.
250 .BI "--net-id=" "name"
251 Specify your callsign.
253 .BI "--nmea=" "medium" "," "direction" "," "hz" "," "options" "," "..."
254 Open an IO connection using the NMEA protocol.
257 Do not attempt to trim the model when initializing the JSBSim FDM.
259 .BI "--offset-azimuth=" "degrees"
260 specify heading to threshhold (degrees).
262 .BI "--offset-distance=" "nm"
263 Specify distance to threshhold (nautical miles).
266 Start up at ground level.
268 .BI "--opengc=" "medium" "," "direction" "," "hz" "," "options" "," "..."
269 Open an IO connect to an OpenGC host.
271 .BI "--pitch=" "degrees"
272 Specify pitch angle (degrees).
274 .BI "--props=" "medium" "," "direction" "," "hz" "," "options" "," "..."
275 Specify an IO device in which to provide an interactive property manager.
277 .BI "--prop:name=" "value"
278 set property <name> to <value>.
280 .BI "--pve=" "medium" "," "direction" "," "hz" "," "options" "," "..."
281 Open an IO connection using the PVE (Provision Entertainment) protocol.
283 .BI "--ray=" "medium" "," "direction" "," "hz" "," "options" "," "..."
284 Open an IO connection to a "RayWoodworth" motion chair
286 .BI "--roll=" "degrees"
287 Specify roll angle (degrees).
289 .BI "--rul=" "medium" "," "direction" "," "hz" "," "options" "," "..."
290 Open an IO connection using the RUL protocol.
295 .B "--shading-smooth"
296 Enable smooth shading.
299 Run the FDM "n" times faster than real-time.
301 .BI "--start-date-gmt=" "yyyy:mm:dd:hh:mm:ss"
302 Specify a starting date/time with respect to GMT (Greenwich Mean Time).
304 .BI "--start-date-lat=" "yyyy:mm:dd:hh:mm:ss"
305 Specify a starting date/time with respect to Local Aircraft Time.
307 .BI "--start-date-sys=" "yyyy:mm:dd:hh:mm:ss"
308 Specify a starting date/time with respect to your local system time.
310 .B "--time-match-local"
311 Synchronize time with local real-world time.
313 .B "--time-match-real"
314 Synchronize time with the real-world time.
316 .BI "--time-offset=" "[+-]hh:mm:ss"
317 Specify a time offset with respect to the current time. May be used in
318 conjunction with other --time-* options.
320 .BI "--trace-read=" "property"
321 Trace the reads for a property. Multiple instances allowed.
323 .BI "--trace-write=" "property"
324 Trace the writes for a property. Multiple instances allowed.
326 .BI "--uBody=" "value"
327 Specify velocity along the body X axis (feet per second unless
328 --units-meters specified).
331 Use feet instead of meters. Affects other options as well as the
332 values displayed by the HUD.
335 Use meters instead of feet. Affects other options as well as the
336 values displayed by the HUD.
338 .BI "--vBody=" "value"
339 Specify velocity along the body Y axis (feet per second unless
340 --units-meters specified).
343 Specify initial airspeed (knots).
345 .BI "--view-offset=" "value"
346 Specify the default forward view direction as an offset from straight
347 ahead. Allowable values are LEFT, RIGHT, CENTER, or a specific number
350 .BI "--visibility-miles=" "value"
351 Specify initial visibility (miles).
353 .BI "--visibility=" "value"
354 Specify initial visibility (meters).
356 .BI "--wBody=" "value"
357 Specify velocity along the body Z axis (feet per second unless
358 --units-meters specified).
360 .BI "--wind=" "DIR@SPEED"
361 Specify wind coming from DIR (degrees) at SPEED (knots).
363 .BI "--wp=" "ID[@alt]"
364 Specify a waypoint for the GC autopilot. Multiple instances of this
365 option are recognized in build a route.
369 Path used to locate data files.
373 Per user configuration file.
376 $FGROOT/system.fgfsrc
378 System-wide configuration file in command line format
381 $FGROOT/preferences.xml
383 System-wide configuration file in XML format
396 Send bug reports to <flightgear-devel@flightgear.org>.
400 Curt L. Olson, et al. See
402 file for a list of contributors.