FlightGear configuration via XML: Difference between revisions
m (→defaults.xml and autosave.xml: cleanup) |
|||
Line 13: | Line 13: | ||
* {{Base Package Resource|filename=preferences.xml}} is a XML text file that contains the ''default configuration'' settings. It comes already installed with Flightgear. | * {{Base Package Resource|filename=preferences.xml}} is a XML text file that contains the ''default configuration'' settings. It comes already installed with Flightgear. | ||
: | :: <code>defaults.xml</code> should '''not''' be changed by users. | ||
* <code>autosave.xml</code> is a XML text file that contains ''changes'' to ''some'' settings contained in <code>defaults.xml</code>. Changes to these settings are saved between sessions. | * <code>autosave.xml</code> is a XML text file that contains ''changes'' to ''some'' settings contained in <code>defaults.xml</code>. Changes to these settings are saved between sessions. |
Revision as of 07:33, 9 September 2020
This article is a stub. You can help the wiki by expanding it. |
You can set up a FlightGear configuration via XML by creating a XML file that loads on to of FlightGear's other settings.
Next to using graphical launchers like FGRun or FGx or parsing console commands to FlightGear's binary, FlightGear's configuration can also be set by means of two .xml files.
defaults.xml and autosave.xml
On startup Flightgear reads both autosave.xml
and defaults.xml
to find values for all configuration settings. Flightgear then stores these settings in the property tree after which the parts of Flightgear that need settings will use them. These two files are XML text files and you can easily read or edit them using a simple text editor.
defaults.xml
(previously, preferences.xml FlightGear commit 78498c560d30797ee55c277ea5f1c74f120fe1a2 ) is a XML text file that contains the default configuration settings. It comes already installed with Flightgear.
defaults.xml
should not be changed by users.
autosave.xml
is a XML text file that contains changes to some settings contained indefaults.xml
. Changes to these settings are saved between sessions.
autosave.xml
should not be edited by users. If you want to set properties at startup a new custom settings XML file should be created instead of editingautosave.xml
.
- Note only some settings are saved between sessions. Settings which are to be saved have an XML attribute:
userarchive
. Changes to other settings will not be saved, and Flightgear will start up in the next session with the defaults fromdefaults.xml
.
- Note only some settings are saved between sessions. Settings which are to be saved have an XML attribute:
- If you want to restore default settings ('factory defaults') to see if a problem goes away you can delete
autosave.xml
. You can also back up the file and restore it later. See troubleshooting.
- If you want to restore default settings ('factory defaults') to see if a problem goes away you can delete
Note We should absolutely stop telling anyone to edit defaults.xml (previously, preferences.xml FlightGear commit 78498c560d30797ee55c277ea5f1c74f120fe1a2 ) in FG_ROOT; any documentation or advice which says to should be changed ASAP. [1]
|
defaults.xml
See defaults.xml for the main article about this subject. |
defaults.xml
(previously, preferences.xml FlightGear commit 78498c560d30797ee55c277ea5f1c74f120fe1a2 ) is FlightGear's main configuration file and is located within $FG_ROOT.
Using the property-list format it sets up a large number of properties and their values that determines various settings of FlightGear. It more or less contain all settings that can be set. All settings contained within this file get parsed by FlightGear while it starts up.
autosave.xml
autosave.xml
is a child of preferences.xml
in user space that contains the properties with an userarchive="y"
attribute. Location depends on the operating system used:
OS | Path |
---|---|
Windows Vista/7/8 | C:\Users\{Your username}\AppData\Roaming\flightgear.org\
|
Windows XP | C:\Documents and Settings\{Your username}\Application Data\flightgear.org\
|
Linux/OS X | ~/.fgfs
|
If not present, it is generated upon launching FGFS with the options set in its parent file Preferences.xml.
Any changes you do within FlightGear's user interface are saved into autosave.xml
, so a manual edit is, in most cases, not necessary. The next time you launch FGFS, the settings stored in autosave.xml
will be used.
Adding your own settings
Rather than modifying preferences.xml
or autosave.xml
you should create your own configuration file using the same format and load it using the --config
command-line parameter. You are not limited only to use properties from those files, but can use any properties from the property tree. You can also add entirely new properties if that is needed.
When you use the --config
option to load your own configuration, it will be loaded into FlightGear just as preferences.xml
and autosave.xml
, but your configuration will be used instead. To use your own configuration add this command-line parameter either in .fgfsrc
or when you start FlightGear:
--config=/home/<user name>/.fgfs/<my-preferences>.xml
The reason to why you should not modify preferences.xml
or autosave.xml
is that the modifications can cause problems with your FlightGear installation and, unless you manually make a copy of them, they will be lost when you upgrade or uninstall FlightGear. In addition, using a configuration file from one version of FlightGear with another version may not work too well either.
Related content
References
|