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.
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.
134 Disable instrument panel.
136 .B "--disable-random-objects"
137 Disable random scenery objects (buildings, trees, etc).
140 Disable sound effects.
142 .B "--disable-specular-highlight"
143 Disable specular reflections on textured objects.
145 .B "--disable-splash-screen"
146 Disable splash screen.
148 .B "--disable-textures"
151 .B "--disable-wireframe"
152 Disable wireframe drawing mode.
154 .B "--enable-anti-alias-hud"
155 Enable anti-aliased HUD.
157 .B "--enable-auto-coordination"
158 Enable auto coordination between aileron and rudder.
160 .B "--enable-clock-freeze"
161 Enable clock freezing so that time does not advance.
164 Enable cloud rendering.
166 .B "--enable-distance-attenuation"
167 Enable runway light distance attenuation.
169 .B "--enable-enhanced-lighting"
170 Enable enhanced runway lighting.
173 Start out in a frozen state.
175 .B "--enable-fuel-freeze"
176 Enable fuel freeze (disabling fuel consumption).
178 .B "--enable-fullscreen"
179 Enable fullscreen mode.
181 .B "--enable-game-mode"
182 Enable fullscreen game mode.
184 .B "--enable-horizon-effect"
185 Enable celestial body growth illusion near the horizon.
193 .B "--enable-intro-music"
194 Enable introduction music.
196 .B "--enable-mouse-pointer"
197 Enable extra mouse pointer (i.e. for full screen voodoo/voodoo-II
201 Enable instrument panel.
203 .B "--enable-random-objects"
204 Enable random scenery objects (buildings, trees, etc).
207 Enable sound effects.
209 .B "--enable-specular-highlight"
210 Enable specular reflections on textured objects.
212 .B "--enable-splash-screen"
213 Enable splash screen.
215 .B "--enable-textures"
218 .B "--enable-wireframe"
219 Enable wireframe drawing mode.
221 .BI "--failure=" "system"
222 Fail a system on the aircraft. System may be one of pitot, static, vacuum,
223 or electrical. Multiple instances allowed.
226 Specify the flight dynamics model to use. Name may be one of jsb, larcsim,
227 yasim, magic, balloon, ada, external, or null.
229 .BI "--fg-root=" "path"
230 Specify the root path for data files.
232 .BI "--fg-scenery=" "path"
233 Specify the base path for scenery data.
236 Specify starting position relative to a fix.
238 .BI "--flight-plan=" "file"
239 Read all waypoints from the specified file.
242 Disable fog rendering.
245 Enable fastest fog rendering.
248 Enable nicest fog rendering.
250 .BI "--fov=" "degrees"
251 Specify initial field of view angle (degrees).
253 .BI "--garmin=" "medium" "," "direction" "," "hz" "," "options" "," "..."
254 Open an IO connection using the Garmin GPS protocol.
256 .BI "--generic=" "params"
257 Open connection using the serial port protocol. See README.IO for details.
259 .BI "--geometry=" "WxH"
260 Specify window geometry (ie. 640x480, 800x600, etc).
262 .BI "--heading=" "degrees"
263 Specify heading or yaw angle (degrees).
265 .BR "--help" ", " "-h"
266 Show a brief help message. Use \-\-verbose,\-v for a full listing of options.
268 .BI "--httpd=" "port"
269 Start an HTTP server on the specified port.
272 HUD displays percentage of triangles culled.
275 HUD displays number of triangles rendered.
278 Start up in the air. This is implied when specifying an initial
279 altitude above ground level.
281 .BI "--joyclient=" "medium" "," "direction" "," "hz" "," "options" "," "..."
282 Open an IO connection to an Agwagon joystick.
284 .BI "--jpg-httpd=" "port"
285 Start a screen shot HTTP server on the specified port.
287 .BI "--lat=" "degrees"
288 Specify starting latitude (degrees).
290 .BI "--log-level=" "value"
291 Set log level for this session (1..5 where 1=verbose, 5=quiet).
293 .BI "--lon=" "degrees"
294 Specify starting longitude (degrees).
296 .BI "--mach=" "value"
297 Specify initial mach number.
299 .BI "--model-hz=" "n"
300 Run the FDM at this rate (iterations per second).
302 .BI "--multiplay=" "direction,hz,address,port"
303 Specify multiplayer communication settings. Multiple instances allowed.
305 .BI "--native-ctrls=" "medium" "," "direction" "," "hz" "," "options" "," "..."
306 Open an IO connection using the FlightGear Native Controls protocol.
308 .BI "--native-fdm=" "medium" "," "direction" "," "hz" "," "options" "," "..."
309 Open an IO connection using the FlightGear Native FDM protocol.
311 .BI "--native=" "medium" "," "direction" "," "hz" "," "options" "," "..."
312 Open an IO connection using the FlightGear Native protocol.
314 .BI "--nav1=" "[radial:]frequency"
315 Specify the initial NAV1 radio frequency. Optionally may be preceded by a
318 .BI "--nav2=" "[radial:]frequency"
319 Specify the initial NAV2 radio frequency. Optionally may be preceded by a
323 Specify starting position relative to an NDB.
325 .BI "--nmea=" "medium" "," "direction" "," "hz" "," "options" "," "..."
326 Open an IO connection using the NMEA protocol.
329 Do not attempt to trim the model when initializing the JSBSim FDM.
331 .BI "--offset-azimuth=" "degrees"
332 specify heading to threshhold (degrees).
334 .BI "--offset-distance=" "nm"
335 Specify distance to threshhold (nautical miles).
338 Start up at ground level.
340 .BI "--opengc=" "medium" "," "direction" "," "hz" "," "options" "," "..."
341 Open an IO connect to an OpenGC host.
343 .BI "--pitch=" "degrees"
344 Specify pitch angle (degrees).
346 .BI "--props=" "medium" "," "direction" "," "hz" "," "options" "," "..."
347 Specify an IO device in which to provide an interactive property manager.
349 .BI "--prop:name=" "value"
350 set property <name> to <value>.
352 .BI "--pve=" "medium" "," "direction" "," "hz" "," "options" "," "..."
353 Open an IO connection using the PVE (Provision Entertainment) protocol.
356 Randomize initial wind parameters. See also: \-\-wind.
358 .BI "--ray=" "medium" "," "direction" "," "hz" "," "options" "," "..."
359 Open an IO connection to a "RayWoodworth" motion chair.
361 .BI "--roll=" "degrees"
362 Specify roll angle (degrees).
364 .BI "--rul=" "medium" "," "direction" "," "hz" "," "options" "," "..."
365 Open an IO connection using the RUL protocol.
370 .B "--shading-smooth"
371 Enable smooth shading.
374 Show a listing of all available aircraft.
377 Run the FDM "n" times faster than real-time.
379 .BI "--start-date-gmt=" "yyyy:mm:dd:hh:mm:ss"
380 Specify a starting date/time with respect to GMT (Greenwich Mean Time).
382 .BI "--start-date-lat=" "yyyy:mm:dd:hh:mm:ss"
383 Specify a starting date/time with respect to Local Aircraft Time.
385 .BI "--start-date-sys=" "yyyy:mm:dd:hh:mm:ss"
386 Specify a starting date/time with respect to your local system time.
388 .BI "--telnet=" "port"
389 Start a telnet interface to the property manager on the specified port.
391 .BI "--timeofday=" "value"
392 Specify a time of day. Value may be one of dawn, dusk, noon, or midnight.
394 .B "--time-match-local"
395 Synchronize time with local real-world time.
397 .B "--time-match-real"
398 Synchronize time with the real-world time.
400 .BI "--time-offset=" "[+-]hh:mm:ss"
401 Specify a time offset with respect to the current time.
403 .BI "--trace-read=" "property"
404 Trace the reads for a property. Multiple instances allowed.
406 .BI "--trace-write=" "property"
407 Trace the writes for a property. Multiple instances allowed.
409 .BI "--turbulence=" "value"
410 Specify turbulence from 0.0 (calm) to 1.0 (severe).
412 .BI "--uBody=" "value"
413 Specify velocity along the body X axis (feet per second unless
414 \-\-units\-meters specified).
417 Use feet instead of meters. Affects other options as well as the
418 values displayed by the HUD.
421 Use meters instead of feet. Affects other options as well as the
422 values displayed by the HUD.
424 .BI "--vBody=" "value"
425 Specify velocity along the body Y axis (feet per second unless
426 \-\-units\-meters specified).
429 Specify initial airspeed (knots).
431 .BI "--view-offset=" "value"
432 Specify the default forward view direction as an offset from straight
433 ahead. Allowable values are LEFT, RIGHT, CENTER, or a specific number
437 Show verbose help message.
439 .BI "--visibility-miles=" "value"
440 Specify initial visibility (miles).
442 .BI "--visibility=" "value"
443 Specify initial visibility (meters).
446 Specify starting position relative to a VOR.
448 .BI "--wBody=" "value"
449 Specify velocity along the body Z axis (feet per second unless
450 \-\-units-meters specified).
452 .BI "--wind=" "DIR@SPEED"
453 Specify wind coming from DIR (degrees) at SPEED (knots). Values may be
454 specified as a range by using a colon separator; for example, 180:220@10:15.
456 .BI "--wp=" "ID[@alt]"
457 Specify a waypoint for the GC autopilot. Multiple instances of this
458 option are recognized in build a route.
462 Path used to locate data files.
466 Per user configuration file.
469 $FG_ROOT/system.fgfsrc
471 System-wide configuration file in command line format.
474 $FG_ROOT/preferences.xml
476 System-wide configuration file in XML format.
479 $FG_ROOT/keyboard.xml
484 $FG_ROOT/Input/Joysticks/
494 Send bug reports to <flightgear\-devel@lists.sourceforge.net> or visit
495 <http://code.google.com/p/flightgear\-bugs>.
497 fgjs(1), fgpanel(1), js_demo(1), terrasync(1)
499 Curt L. Olson, et al. See
501 file for a list of contributors.