1 .\" Copyright (C) 2002 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
16 .\" Or try here: http://www.fsf.org/copyleft/gpl.html
18 .TH FGFS 1 "February 2012" "@VERSION@" "@PACKAGE@"
20 fgfs \- FlightGear Flight Simulator
26 is a free, open-source, multi-platform, and sophisticated flight
27 simulator framework for the development and pursuit of interesting
28 flight simulator ideas.
29 For more information visit <http://www.flightgear.org>.
32 .BI "--adf=" "[rotation:]frequency"
33 Specify the initial ADF radio frequency. Optionally may be preceded by a
37 Specify aerodynamics model to load.
39 .BI "--aircraft=" "name"
40 Specify aircraft to load.
42 .BI "--aircraft-dir=" "path"
43 Specify the aircraft model directory relative to the path of the
44 executable. This is used for UIUC aircraft only.
46 .BI "--airport-id=" "id"
47 Specify starting postion by airport ID.
49 .BI "--altitude=" "value"
50 Specify starting altitude (in feet unless --units-meters specified).
53 Enable atc610x interface.
55 .BI "--atlas=" "medium" "," "direction" "," "hz" "," "options" "," "..."
56 Open an IO connection using the Atlas protocol.
59 Specify the bits per pixel for the renderer.
61 .BI "--browser-app=" "path"
62 Specify location of your web browser.
64 .BI "--callsign=" "value"
65 Specify a unique name for multiplayer play.
67 .BI "--ceiling=" "value[:thickness]"
68 Create an overcast ceiling (feet above sea level). May optionally specify
69 a thickness (feet) which defaults to 2000.
71 .BI "--com1=" "frequency"
72 Set the initial COM1 radio frequency.
74 .BI "--com2=" "frequency"
75 Set the initial COM2 radio frequency.
77 .BI "--config=" "path"
78 Load additional properties from path. Multiple instances of this
79 option are recognized.
81 .BI "--control=" "mode"
82 Primary control mode (joystick, keyboard, mouse).
84 .BI "--dme=" "{nav1|nav2|frequency}"
85 Specify the NAV radio from which to slave the ADF or set its internal
88 .B "--disable-anti-alias-hud"
89 Disable anti-aliased HUD.
91 .B "--disable-auto-coordination"
92 Disable auto coordination between aileron and rudder.
94 .B "--disable-clock-freeze"
95 Disable clock freezing so that time advances normally.
98 Disable cloud rendering.
100 .B "--disable-distance-attenuation"
101 Disable runway light distance attenuation.
103 .B "--disable-enhanced-lighting"
104 Disable enhanced runway lighting.
106 .B "--disable-freeze"
107 Start out in a running state.
109 .B "--disable-fuel-freeze"
110 Disable fuel freeze (enabling fuel consumption).
112 .B "--disable-fullscreen"
113 Disable fullscreen mode.
115 .B "--disable-game-mode"
116 Disable fullscreen game mode.
118 .B "--disable-horizon-effect"
119 Disable celestial body growth illusion near the horizon..
124 .B "--disable-hud-3d"
127 .B "--disable-intro-music"
128 Disable introduction music.
130 .B "--disable-mouse-pointer"
131 Disable extra mouse pointer.
133 .B "--disable-network-olk"
134 Disable Multi-pilot mode.
137 Disable instrument panel.
139 .B "--disable-random-objects"
140 Disable random scenery objects (buildings, trees, etc).
142 .B "--disable-skyblend"
143 Disable sky blending.
146 Disable sound effects.
148 .B "--disable-specular-highlight"
149 Disable specular reflections on textured objects.
151 .B "--disable-splash-screen"
152 Disable splash screen.
154 .B "--disable-textures"
157 .B "--disable-wireframe"
158 Disable wireframe drawing mode.
160 .B "--enable-anti-alias-hud"
161 Enable anti-aliased HUD.
163 .B "--enable-auto-coordination"
164 Enable auto coordination between aileron and rudder.
166 .B "--enable-clock-freeze"
167 Enable clock freezing so that time does not advance.
170 Enable cloud rendering.
172 .B "--enable-distance-attenuation"
173 Enable runway light distance attenuation.
175 .B "--enable-enhanced-lighting"
176 Enable enhanced runway lighting.
179 Start out in a frozen state.
181 .B "--enable-fuel-freeze"
182 Enable fuel freeze (disabling fuel consumption).
184 .B "--enable-fullscreen"
185 Enable fullscreen mode.
187 .B "--enable-game-mode"
188 Enable fullscreen game mode.
190 .B "--enable-horizon-effect"
191 Enable celestial body growth illusion near the horizon.
199 .B "--enable-intro-music"
200 Enable introduction music.
202 .B "--enable-mouse-pointer"
203 Enable extra mouse pointer (i.e. for full screen voodoo/voodoo-II
206 .B "--enable-network-olk"
207 Enable Multi-pilot mode.
210 Enable instrument panel.
212 .B "--enable-random-objects"
213 Enable random scenery objects (buildings, trees, etc).
215 .B "--enable-skyblend"
219 Enable sound effects.
221 .B "--enable-specular-highlight"
222 Enable specular reflections on textured objects.
224 .B "--enable-splash-screen"
225 Enable splash screen.
227 .B "--enable-textures"
230 .B "--enable-wireframe"
231 Enable wireframe drawing mode.
233 .BI "--failure=" "system"
234 Fail a system on the aircraft. System may be one of pitot, static, vacuum,
235 or electrical. Multiple instances allowed.
238 Specify the flight dynamics model to use. Name may be one of jsb, larcsim,
239 yasim, magic, balloon, ada, external, or null.
241 .BI "--fg-root=" "path"
242 Specify the root path for data files.
244 .BI "--fg-scenery=" "path"
245 Specify the base path for scenery data.
248 Specify starting position relative to a fix.
250 .BI "--flight-plan=" "file"
251 Read all waypoints from the specified file.
254 Disable fog rendering.
257 Enable fastest fog rendering.
260 Enable nicest fog rendering.
262 .BI "--fov=" "degrees"
263 Specify initial field of view angle (degrees).
265 .BI "--garmin=" "medium" "," "direction" "," "hz" "," "options" "," "..."
266 Open an IO connection using the Garmin GPS protocol.
268 .BI "--generic=" "params"
269 Open connection using the serial port protocol. See README.IO for details.
271 .BI "--geometry=" "WxH"
272 Specify window geometry (ie. 640x480, 800x600, etc).
274 .BI "--heading=" "degrees"
275 Specify heading or yaw angle (degrees).
277 .BR "--help" ", " "-h"
278 Show a brief help message. Use --verbose,-v for a full listing of options.
280 .BI "--httpd=" "port"
281 Start an HTTP server on the specified port.
284 HUD displays percentage of triangles culled.
287 HUD displays number of triangles rendered.
290 Start up in the air. This is implied when specifying an initial
291 altitude above ground level.
293 .BI "--joyclient=" "medium" "," "direction" "," "hz" "," "options" "," "..."
294 Open an IO connection to an Agwagon joystick.
296 .BI "--jpg-httpd=" "port"
297 Start a screen shot HTTP server on the specified port.
299 .BI "--lat=" "degrees"
300 Specify starting latitude (degrees).
302 .BI "--log-level=" "value"
303 Set log level for this session (1..5 where 1=verbose, 5=quiet).
305 .BI "--lon=" "degrees"
306 Specify starting longitude (degrees).
308 .BI "--mach=" "value"
309 Specify initial mach number.
311 .BI "--model-hz=" "n"
312 Run the FDM at this rate (iterations per second).
314 .BI "--multiplay=" "direction,hz,address,port"
315 Specify multiplayer communication settings. Multiple instances allowed.
317 .BI "--native-ctrls=" "medium" "," "direction" "," "hz" "," "options" "," "..."
318 Open an IO connection using the FlightGear Native Controls protocol.
320 .BI "--native-fdm=" "medium" "," "direction" "," "hz" "," "options" "," "..."
321 Open an IO connection using the FlightGear Native FDM protocol.
323 .BI "--native=" "medium" "," "direction" "," "hz" "," "options" "," "..."
324 Open an IO connection using the FlightGear Native protocol.
326 .BI "--nav1=" "[radial:]frequency"
327 Specify the initial NAV1 radio frequency. Optionally may be preceded by a
330 .BI "--nav2=" "[radial:]frequency"
331 Specify the initial NAV2 radio frequency. Optionally may be preceded by a
335 Specify starting position relative to an NDB.
338 Enable network information in the HUD.
340 .BI "--net-id=" "name"
341 Specify your callsign.
343 .BI "--nmea=" "medium" "," "direction" "," "hz" "," "options" "," "..."
344 Open an IO connection using the NMEA protocol.
347 Do not attempt to trim the model when initializing the JSBSim FDM.
349 .BI "--offset-azimuth=" "degrees"
350 specify heading to threshhold (degrees).
352 .BI "--offset-distance=" "nm"
353 Specify distance to threshhold (nautical miles).
356 Start up at ground level.
358 .BI "--opengc=" "medium" "," "direction" "," "hz" "," "options" "," "..."
359 Open an IO connect to an OpenGC host.
361 .BI "--pitch=" "degrees"
362 Specify pitch angle (degrees).
364 .BI "--props=" "medium" "," "direction" "," "hz" "," "options" "," "..."
365 Specify an IO device in which to provide an interactive property manager.
367 .BI "--prop:name=" "value"
368 set property <name> to <value>.
370 .BI "--pve=" "medium" "," "direction" "," "hz" "," "options" "," "..."
371 Open an IO connection using the PVE (Provision Entertainment) protocol.
374 Randomize initial wind parameters. See also: --wind.
376 .BI "--ray=" "medium" "," "direction" "," "hz" "," "options" "," "..."
377 Open an IO connection to a "RayWoodworth" motion chair.
379 .BI "--roll=" "degrees"
380 Specify roll angle (degrees).
382 .BI "--rul=" "medium" "," "direction" "," "hz" "," "options" "," "..."
383 Open an IO connection using the RUL protocol.
388 .B "--shading-smooth"
389 Enable smooth shading.
392 Show a listing of all available aircraft.
395 Run the FDM "n" times faster than real-time.
397 .BI "--start-date-gmt=" "yyyy:mm:dd:hh:mm:ss"
398 Specify a starting date/time with respect to GMT (Greenwich Mean Time).
400 .BI "--start-date-lat=" "yyyy:mm:dd:hh:mm:ss"
401 Specify a starting date/time with respect to Local Aircraft Time.
403 .BI "--start-date-sys=" "yyyy:mm:dd:hh:mm:ss"
404 Specify a starting date/time with respect to your local system time.
406 .BI "--telnet=" "port"
407 Start a telnet interface to the property manager on the specified port.
409 .BI "--timeofday=" "value"
410 Specify a time of day. Value may be one of dawn, dusk, noon, or midnight.
412 .B "--time-match-local"
413 Synchronize time with local real-world time.
415 .B "--time-match-real"
416 Synchronize time with the real-world time.
418 .BI "--time-offset=" "[+-]hh:mm:ss"
419 Specify a time offset with respect to the current time.
421 .BI "--trace-read=" "property"
422 Trace the reads for a property. Multiple instances allowed.
424 .BI "--trace-write=" "property"
425 Trace the writes for a property. Multiple instances allowed.
427 .BI "--turbulence=" "value"
428 Specify turbulence from 0.0 (calm) to 1.0 (severe).
430 .BI "--uBody=" "value"
431 Specify velocity along the body X axis (feet per second unless
432 --units-meters specified).
435 Use feet instead of meters. Affects other options as well as the
436 values displayed by the HUD.
439 Use meters instead of feet. Affects other options as well as the
440 values displayed by the HUD.
442 .BI "--vBody=" "value"
443 Specify velocity along the body Y axis (feet per second unless
444 --units-meters specified).
447 Specify initial airspeed (knots).
449 .BI "--view-offset=" "value"
450 Specify the default forward view direction as an offset from straight
451 ahead. Allowable values are LEFT, RIGHT, CENTER, or a specific number
455 Show verbose help message.
457 .BI "--visibility-miles=" "value"
458 Specify initial visibility (miles).
460 .BI "--visibility=" "value"
461 Specify initial visibility (meters).
464 Specify starting position relative to a VOR.
466 .BI "--wBody=" "value"
467 Specify velocity along the body Z axis (feet per second unless
468 --units-meters specified).
470 .BI "--wind=" "DIR@SPEED"
471 Specify wind coming from DIR (degrees) at SPEED (knots). Values may be
472 specified as a range by using a colon separator; for example, 180:220@10:15.
474 .BI "--wp=" "ID[@alt]"
475 Specify a waypoint for the GC autopilot. Multiple instances of this
476 option are recognized in build a route.
480 Path used to locate data files.
484 Per user configuration file.
487 $FG_ROOT/system.fgfsrc
489 System-wide configuration file in command line format.
492 $FG_ROOT/preferences.xml
494 System-wide configuration file in XML format.
497 $FG_ROOT/keyboard.xml
502 $FG_ROOT/Input/Joysticks/
512 Send bug reports to <flightgear-devel@lists.sourceforge.net> or visit
513 <http://code.google.com/p/flightgear-bugs>.
515 fgjs(1), fgpanel(1), js_demo(1), terrasync(1)
517 Curt L. Olson, et al. See
519 file for a list of contributors.