Hi fellow wiki editors!

To help newly registered users get more familiar with the wiki (and maybe older users too) there is now a {{Welcome to the wiki}} template. Have a look at it and feel free to add it to new users discussion pages (and perhaps your own).

I have tried to keep the template short, but meaningful. /Johan G

Difference between revisions of "Fgfsrc"

From FlightGear wiki
Jump to: navigation, search
(page created, far from finished)
 
(temporarily finished :P)
Line 1: Line 1:
{{stub}}
 
  
 +
= fgfsrc =
 +
The files ''fgfsrc'' purpose is to contain [[Command Line Parameters]] which are read by ''fgfs'' at startup. This is for users who start FlightGear from the [[command line]], users using a graphical user interface like [[fgrun]] don't have to bother about this at all. Anyhow, it is possible to use fgrun to create your personal set of options by copy'n'paste_ing them from the ''Show command line'' textbox into ''fgfsrc''.
  
  
Lines starting with # are comments. Lines containing an option followed by a comment are *not* allowed!
+
It is very likely that this file does not exist on your system yet and therefore has to be created by the user, you. The contents of the file are handled the same way by ''fgfs'' on all operating systems. But the name and location is not:
  
A basic example:
+
* on ''GNU/Linux'' (POSIX = Mac OS X?) the file is called ''.fgfsrc'' (note the leading dot!) and ''fgfs'' is looking for it inside the users $HOME directory. To figure out where this is on your system, open a terminal window (shell) and enter <code>cd $HOME</code>.
 +
 
 +
* on ''Windows'' systems the file is called ''system.fgfsrc'' and lives in $FG_ROOT which, on a standard installation, is ''C:\Program Files\FlightGear\data''.
 +
 
 +
 
 +
===== Some 'rules' for the content: =====
 +
* Each line contains one option only.
 +
* If the first 'visible' character is a '#', ''fgfs'' does not read this line (comment).
 +
* Lines containing an option followed by a comment are *not* allowed! (<code>--some-option  # some comment</code>)
 +
 
 +
 
 +
===== An example of a basic ''fgfsrc'' file: =====
  
 
  # $HOME/.fgfsrc
 
  # $HOME/.fgfsrc
#
+
 
#
+
 
 
  ### Aircraft
 
  ### Aircraft
 
  #
 
  #
 
  --aircraft=ec135
 
  --aircraft=ec135
   ## a24, Albatross, Catalina, dhc2F, dhc3[A/F], dhc6F
+
   ## Catalina, dhc3[A/F], p47d-30, F1-156-de, ZivkoEdge540  
  ## p47d-30, F1-156-de, ZivkoEdge540
+
  ## alouette2[/F], Alouette-III, apache, ch47, ch53e, dauphin, HUP, ka50, Lynx,
+
  ## R22, S-51, s76c, s58, superfrelon, tigre, uh1, uh60, v22
+
 
   ## MPcarrier: nimitz, nimitz-ATC, nimitz_observer, foch, vinson, eisenhower
 
   ## MPcarrier: nimitz, nimitz-ATC, nimitz_observer, foch, vinson, eisenhower
#--prop:/sim/remote/pilot-callsign=U-FLY
+
 
#
+
 
#
+
 
  ### Initial position
 
  ### Initial position
 
  #
 
  #
Line 27: Line 35:
 
  #--parkpos=A11
 
  #--parkpos=A11
 
  #
 
  #
 +
# In air:
 
  #--offset-distance=1.5
 
  #--offset-distance=1.5
 
  #--altitude=6000
 
  #--altitude=6000
Line 32: Line 41:
 
  #--enable-freeze
 
  #--enable-freeze
 
  #
 
  #
  #
+
  # Coordinates:
 +
  ## Oilrig Lennox:
 +
#--lon=-3.17547
 +
#--lat=53.63305
 +
#--altitude=205
 +
 
 +
 
 
  ### Environment
 
  ### Environment
 
  #
 
  #
Line 50: Line 65:
 
  --prop:/sim/frame-rate-throttle-hz=30
 
  --prop:/sim/frame-rate-throttle-hz=30
 
  --ai-scenario=nimitz_demo
 
  --ai-scenario=nimitz_demo
#
+
 
#
+
 
 
  ### Network
 
  ### Network
 
  #
 
  #
 
  --callsign=I-FLY
 
  --callsign=I-FLY
 +
#--prop:/sim/remote/pilot-callsign=U-FLY
 
  --multiplay=out,10,mpserver01.flightgear.org,5000
 
  --multiplay=out,10,mpserver01.flightgear.org,5000
 
  #--multiplay=in,10,localhost,5000
 
  #--multiplay=in,10,localhost,5000
Line 62: Line 78:
 
   ## fgcom -Sfgcom.flightgear.org.uk [-f910] :
 
   ## fgcom -Sfgcom.flightgear.org.uk [-f910] :
 
  --generic=socket,out,10,localhost,16661,udp,fgcom
 
  --generic=socket,out,10,localhost,16661,udp,fgcom
#
+
 
#
+
 
 
  ### System
 
  ### System
 
  #
 
  #
Line 76: Line 92:
 
   ## disable mouse mode 'fly':
 
   ## disable mouse mode 'fly':
 
  --prop:/input/mice/mouse/mode/button[2]/binding/value=2
 
  --prop:/input/mice/mouse/mode/button[2]/binding/value=2
 +
 +
 +
Some options (mostly properties) are only temporary of interest to the 'normal' user or even only for CVS users:
 +
 
   ## parkpos, temporary:
 
   ## parkpos, temporary:
 
  --prop:/sim/traffic-manager/use-custom-scenery-data=true
 
  --prop:/sim/traffic-manager/use-custom-scenery-data=true
 +
(explanation missing)
 +
  
Please feel free to add other usefull options!!!
+
Please feel free to add other usefull options to the temporary and basic ones!!!

Revision as of 15:54, 8 October 2009

fgfsrc

The files fgfsrc purpose is to contain Command Line Parameters which are read by fgfs at startup. This is for users who start FlightGear from the command line, users using a graphical user interface like fgrun don't have to bother about this at all. Anyhow, it is possible to use fgrun to create your personal set of options by copy'n'paste_ing them from the Show command line textbox into fgfsrc.


It is very likely that this file does not exist on your system yet and therefore has to be created by the user, you. The contents of the file are handled the same way by fgfs on all operating systems. But the name and location is not:

  • on GNU/Linux (POSIX = Mac OS X?) the file is called .fgfsrc (note the leading dot!) and fgfs is looking for it inside the users $HOME directory. To figure out where this is on your system, open a terminal window (shell) and enter cd $HOME.
  • on Windows systems the file is called system.fgfsrc and lives in $FG_ROOT which, on a standard installation, is C:\Program Files\FlightGear\data.


Some 'rules' for the content:
  • Each line contains one option only.
  • If the first 'visible' character is a '#', fgfs does not read this line (comment).
  • Lines containing an option followed by a comment are *not* allowed! (--some-option # some comment)


An example of a basic fgfsrc file:
# $HOME/.fgfsrc
 
 
### Aircraft
#
--aircraft=ec135
 ## Catalina, dhc3[A/F], p47d-30, F1-156-de, ZivkoEdge540 
 ## MPcarrier: nimitz, nimitz-ATC, nimitz_observer, foch, vinson, eisenhower
 
 
### Initial position
#
--airport=LOWI
#--runway=08L
#--parkpos=A11
#
# In air:
#--offset-distance=1.5
#--altitude=6000
#--vc=70
#--enable-freeze
#
# Coordinates:
 ## Oilrig Lennox:
#--lon=-3.17547
#--lat=53.63305
#--altitude=205
 
 
### Environment
#
--timeofday=noon
--random-wind
--enable-real-weather-fetch
 ##rain/snow:
--prop:/sim/rendering/precipitation-enable=false
--enable-horizon-effect
--enable-specular-highlight
--enable-ai-models
--enable-clouds3d
--shading-flat
--fog-nicest
--enable-random-objects
--prop:/sim/rendering/random-vegetation=true
--prop:/sim/frame-rate-throttle-hz=30
--ai-scenario=nimitz_demo
 
 
### Network
#
--callsign=I-FLY
#--prop:/sim/remote/pilot-callsign=U-FLY
--multiplay=out,10,mpserver01.flightgear.org,5000
#--multiplay=in,10,localhost,5000
--httpd=5500
 ## nice terrasync -p 5505 -S -d /opt/fgfs/scenery.terrasync :
--atlas=socket,out,1,localhost,5505,udp 
 ## fgcom -Sfgcom.flightgear.org.uk [-f910] :
--generic=socket,out,10,localhost,16661,udp,fgcom
 
 
### System
#
#--log-level=info
 ## alarm,warn,info,debug
--fg-root=/opt/fgfs/data
--fg-scenery=/opt/fgfs/data/Scenery:/opt/fgfs/scenery.1.0.1:/opt/fgfs/scenery.terrasync
--geometry=1280x1024
--bpp=24
--control=joystick
--prop:/sim/traffic-manager/enabled=0
 ## disable mouse mode 'fly':
--prop:/input/mice/mouse/mode/button[2]/binding/value=2


Some options (mostly properties) are only temporary of interest to the 'normal' user or even only for CVS users:

 ## parkpos, temporary:
--prop:/sim/traffic-manager/use-custom-scenery-data=true

(explanation missing)


Please feel free to add other usefull options to the temporary and basic ones!!!