VGISConfiguration

A VGIS program whether it is a database build tool or the VGIS application contains one instance of CommonConfig called _commonConfig plus a number of other Config structures specific to the particular program. More...

Classes
struct	VGISConfig
	VGISConfig contains various configuration information for the interactive VGIS application. More...
class	CommonConfig
	CommonConfig contains VGIS program configuration information common to all VGIS programs. More...
class	ter_config_t
	ter_config_t contains the terrain library run-time configuration. More...
class	obj_config_t
	This structure contains options for the object library. More...

---

Detailed Description

A VGIS program whether it is a database build tool or the VGIS application contains one instance of CommonConfig called _commonConfig plus a number of other Config structures specific to the particular program.

The "Configurable Data Members" of these structures can be set on the command-line or in the the VGIS Configuration file (CommonConfig::configFile). Each data member of a Config structure is initialized in one of four ways:

• a default value
• an operating system environment variable
• the VGISConfig file (see CommonConfig::configFile)
• a command line argument

Initializing a member by a method later in this list will override any values set by a method earlier in the list. Some members can only be initialized by some subset of these methods. The description of each structure data member lists exactly which of these methods are available for setting that member.

The VGIS config file can declare and initialize one object of type CommonConfig plus one object of each additional Config class. The config file uses a C like syntax (see PCTypes.html: FILE SYNTAX and esp. subsection Struct and Class ). String CommonConfig members set in the file must be in C syntax (see PCTypes.html:FILE SYNTAX: Char Pointer ), but string members set on the command line should not use C string syntax.

Path Interpretation

String values for file or directory names are treated as follows. If the string begins with a path separator, '\' or '/', or a letter followed by a ':', then they are treated as absolute file paths. If the string begins with a '.' it is treated as relative to the directory in which VGIS was executed. In all other cases, the file name is treated as relative to each CommonConfig member's "default parent directory". Each member description gives its default parent directory.

---