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., 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 "September 2002" "@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).
49 Enable atc610x interface.
51 .BI "--atlas=" "medium" "," "direction" "," "hz" "," "options" "," "..."
52 Open an IO connection using the Atlas protocol.
55 Specify the bits per pixel for the renderer.
57 .BI "--browser-app=" "path"
58 Specify location of your web browser.
60 .BI "--callsign=" "value"
61 Specify a unique name for multiplayer play.
63 .BI "--config=" "path"
64 Load additional properties from path. Multiple instances of this
65 option are recognized.
67 .BI "--control=" "mode"
68 Primary control mode (joystick, keyboard, mouse).
70 .B "--disable-anti-alias-hud"
71 Disable anti-aliased HUD.
73 .B "--disable-auto-coordination"
74 Disable auto coordination between aileron and rudder.
77 Disable cloud rendering.
79 .B "--disable-distance-attenuation"
80 Disable runway light distance attenuation.
83 Start out in a running state.
85 .B "--disable-fuel-freeze"
86 Disable fuel freeze (enabling fuel consumption).
88 .B "--disable-fullscreen"
89 Disable fullscreen mode.
91 .B "--disable-game-mode"
92 Disable fullscreen game mode.
97 .B "--disable-intro-music"
98 Disable introduction music.
100 .B "--disable-mouse-pointer"
101 Disable extra mouse pointer.
103 .B "--disable-network-olk"
104 Disable Multi-pilot mode.
107 Disable instrument panel.
109 .B "--disable-random-objects"
110 Disable random scenery objects (buildings, trees, etc).
112 .B "--disable-skyblend"
113 Disable sky blending.
116 Disable sound effects.
118 .B "--disable-splash-screen"
119 Disable splash screen.
121 .B "--disable-textures"
124 .B "--disable-wireframe"
125 Disable wireframe drawing mode.
127 .B "--enable-anti-alias-hud"
128 Enable anti-aliased HUD.
130 .B "--enable-auto-coordination"
131 Enable auto coordination between aileron and rudder.
134 Enable cloud rendering.
136 .B "--enable-distance-attenuation"
137 Enable runway light distance attenuation.
140 Start out in a frozen state.
142 .B "--enable-fuel-freeze"
143 Enable fuel freeze (disabling fuel consumption).
145 .B "--enable-fullscreen"
146 Enable fullscreen mode.
148 .B "--enable-game-mode"
149 Enable fullscreen game mode.
154 .B "--enable-intro-music"
155 Enable introduction music.
157 .B "--enable-mouse-pointer"
158 Enable extra mouse pointer (i.e. for full screen voodoo/voodoo-II
161 .B "--enable-network-olk"
162 Enable Multi-pilot mode.
165 Enable instrument panel.
167 .B "--enable-random-objects"
168 Enable random scenery objects (buildings, trees, etc).
170 .B "--enable-skyblend"
174 Enable sound effects.
176 .B "--enable-splash-screen"
177 Enable splash screen.
179 .B "--enable-textures"
182 .B "--enable-wireframe"
183 Enable wireframe drawing mode.
186 Specify the flight dynamics model to use. Can be one of jsb, larcsim, yasim,
187 magic, balloon, ada, external, or null.
189 .BI "--fg-root=" "path"
190 Specify the root path for data files.
192 .BI "--fg-scenery=" "path"
193 Specify the base path for scenery data.
196 Specify starting position relative to a fix.
198 .BI "--flight-plan=" "file"
199 Read all waypoints from the specified file.
202 Disable fog rendering.
205 Enable fastest fog rendering.
208 Enable nicest fog rendering.
210 .BI "--fov=" "degrees"
211 Specify initial field of view angle (degrees).
213 .BI "--garmin=" "medium" "," "direction" "," "hz" "," "options" "," "..."
214 Open an IO connection using the Garmin GPS protocol.
216 .BI "--generic=" "params"
217 Open connection using the serial port protocol. See README.IO for details.
219 .BI "--geometry=" "WxH"
220 Specify window geometry (ie. 640x480, 800x600, etc).
222 .BI "--heading=" "degrees"
223 Specify heading or yaw angle (degrees).
225 .BR "--help" ", " "-h"
226 Show a brief help message. Use --verbose,-v for a full listing of options.
228 .BI "--httpd=" "port"
229 Start an HTTP server on the specified port.
232 HUD displays percentage of triangles culled.
235 HUD displays number of triangles rendered.
238 Start up in the air. This is implied when specifying an initial
239 altitude above ground level.
241 .BI "--joyclient=" "medium" "," "direction" "," "hz" "," "options" "," "..."
242 Open an IO connection to an Agwagon joystick.
244 .BI "--jpg-httpd=" "port"
245 Start a screen shot HTTP server on the specified port.
247 .BI "--lat=" "degrees"
248 Specify starting latitude (degrees).
250 .BI "--log-level=" "value"
251 Set log level for this session (1..5 where 1=verbose, 5=quiet).
253 .BI "--lon=" "degrees"
254 Specify starting longitude (degrees).
256 .BI "--mach=" "value"
257 Specify initial mach number.
259 .BI "--model-hz=" "n"
260 Run the FDM at this rate (iterations per second).
262 .BI "--multiplay=" "direction,hz,address,port"
263 Specify multiplayer communication settings. Multiple instances allowed.
265 .BI "--native-ctrls=" "medium" "," "direction" "," "hz" "," "options" "," "..."
266 Open an IO connection using the FlightGear Native Controls protocol.
268 .BI "--native-fdm=" "medium" "," "direction" "," "hz" "," "options" "," "..."
269 Open an IO connection using the FlightGear Native FDM protocol.
271 .BI "--native=" "medium" "," "direction" "," "hz" "," "options" "," "..."
272 Open an IO connection using the FlightGear Native protocol.
275 Specify starting position relative to an NDB.
278 Enable network information in the HUD.
280 .BI "--net-id=" "name"
281 Specify your callsign.
283 .BI "--nmea=" "medium" "," "direction" "," "hz" "," "options" "," "..."
284 Open an IO connection using the NMEA protocol.
287 Do not attempt to trim the model when initializing the JSBSim FDM.
289 .BI "--offset-azimuth=" "degrees"
290 specify heading to threshhold (degrees).
292 .BI "--offset-distance=" "nm"
293 Specify distance to threshhold (nautical miles).
296 Start up at ground level.
298 .BI "--opengc=" "medium" "," "direction" "," "hz" "," "options" "," "..."
299 Open an IO connect to an OpenGC host.
301 .BI "--pitch=" "degrees"
302 Specify pitch angle (degrees).
304 .BI "--props=" "medium" "," "direction" "," "hz" "," "options" "," "..."
305 Specify an IO device in which to provide an interactive property manager.
307 .BI "--prop:name=" "value"
308 set property <name> to <value>.
310 .BI "--pve=" "medium" "," "direction" "," "hz" "," "options" "," "..."
311 Open an IO connection using the PVE (Provision Entertainment) protocol.
314 Randomize initial wind parameters. See also: --wind.
316 .BI "--ray=" "medium" "," "direction" "," "hz" "," "options" "," "..."
317 Open an IO connection to a "RayWoodworth" motion chair.
319 .BI "--roll=" "degrees"
320 Specify roll angle (degrees).
322 .BI "--rul=" "medium" "," "direction" "," "hz" "," "options" "," "..."
323 Open an IO connection using the RUL protocol.
328 .B "--shading-smooth"
329 Enable smooth shading.
332 Show a listing of all available aircraft.
335 Run the FDM "n" times faster than real-time.
337 .BI "--start-date-gmt=" "yyyy:mm:dd:hh:mm:ss"
338 Specify a starting date/time with respect to GMT (Greenwich Mean Time).
340 .BI "--start-date-lat=" "yyyy:mm:dd:hh:mm:ss"
341 Specify a starting date/time with respect to Local Aircraft Time.
343 .BI "--start-date-sys=" "yyyy:mm:dd:hh:mm:ss"
344 Specify a starting date/time with respect to your local system time.
346 .BI "--telnet=" "port"
347 Start a telnet interface to the property manager on the specified port.
349 .B "--time-match-local"
350 Synchronize time with local real-world time.
352 .B "--time-match-real"
353 Synchronize time with the real-world time.
355 .BI "--time-offset=" "[+-]hh:mm:ss"
356 Specify a time offset with respect to the current time.
358 .BI "--trace-read=" "property"
359 Trace the reads for a property. Multiple instances allowed.
361 .BI "--trace-write=" "property"
362 Trace the writes for a property. Multiple instances allowed.
364 .BI "--turbulence=" "value"
365 Specify turbulence from 0.0 (calm) to 1.0 (severe).
367 .BI "--uBody=" "value"
368 Specify velocity along the body X axis (feet per second unless
369 --units-meters specified).
372 Use feet instead of meters. Affects other options as well as the
373 values displayed by the HUD.
376 Use meters instead of feet. Affects other options as well as the
377 values displayed by the HUD.
379 .BI "--vBody=" "value"
380 Specify velocity along the body Y axis (feet per second unless
381 --units-meters specified).
384 Specify initial airspeed (knots).
386 .BI "--view-offset=" "value"
387 Specify the default forward view direction as an offset from straight
388 ahead. Allowable values are LEFT, RIGHT, CENTER, or a specific number
392 Show verbose help message.
394 .BI "--visibility-miles=" "value"
395 Specify initial visibility (miles).
397 .BI "--visibility=" "value"
398 Specify initial visibility (meters).
401 Specify starting position relative to a VOR.
403 .BI "--wBody=" "value"
404 Specify velocity along the body Z axis (feet per second unless
405 --units-meters specified).
407 .BI "--wind=" "DIR@SPEED"
408 Specify wind coming from DIR (degrees) at SPEED (knots). Values may be
409 specified as a range by using a colon separator; for example, 180:220@10:15.
411 .BI "--wp=" "ID[@alt]"
412 Specify a waypoint for the GC autopilot. Multiple instances of this
413 option are recognized in build a route.
417 Path used to locate data files.
421 Per user configuration file.
424 $FG_ROOT/system.fgfsrc
426 System-wide configuration file in command line format.
429 $FG_ROOT/preferences.xml
431 System-wide configuration file in XML format.
434 $FG_ROOT/keyboard.xml
439 $FG_ROOT/Input/Joysticks/
449 Send bug reports to <flightgear-devel@flightgear.org>.
453 Curt L. Olson, et al. See
455 file for a list of contributors.