Overriding cfg file content

This topic relates to Using defines to override.

Overriding configuration file content

Although the cfg configuration files are suited to override defines, sometimes it can be useful to override the cfg configuration file itself.

One reason to do this, is to run the same application with different settings without having to directly modify the code.

Overriding cfg files with configuration

To override a cfg configuration file you can create one or more overriding configuration files.

When running the XR Viewer or the XR Instructor executables, you can pass a file with the -configuration command attribute.

MWPLplayer -configuration .\GameData\configuration\player0.xml

The second configuration file is loaded after the application cfg configuration files, so it can be used to override the contents of the original configuration file.

Notes on overriding configuration files

• The overriding configuration file is .another cfg configuration file.

• A configuration file must include the complete hierarchical structure of all and only the parameters to be redefined. For this reason, it can include parts of other different cfg configuration files.

• The XR Studio property editor offers instruments for creating configuration files.

Overriding cfg files with custom.xml file

While configuration files enable you to create predefined settings, the custom.xml gives the end user the ability to modify each parameter before launching an application.

Notes about custom.xml file

• The custom.xml file is a cfg configuration file.

• It must include the complete hierarchical structure of all and only the parameters to be redefined. For this reason, it can include parts of other different cfg configuration files.

• The custom file can be used not only for customizing modules, but also to expose developer-created defines.