ter_config_t Class Reference
[VGISConfiguration]

ter_config_t contains the terrain library run-time configuration. More...

List of all members.

Public Attributes
char **	vectorDirsArray
	these store the parsed vector directories
int	vectorDirsNumber
char	objectDatabaseVersionStr [256]
	String for paged object database version.
ODB_version_t	objectDatabaseVersion
	Paged object database version.
vgis_boolean_t	renderTerrain
	Enable/disable display of terrain polygons.
vgis_boolean_t	renderMesh
	Enable/disable display of terrain wireframe mesh.
vgis_boolean_t	useCCC
	This enables/disables the use of CCC coordinates for rendering paged objects.
float	maxMemoryLoad
	This determines the fraction of host memory load that VGIS should allow itself to use.
vgis_boolean_t	renderTerrain_
vgis_boolean_t	renderMesh_
vgis_boolean_t	useCCC_
Configurable Data Members
These members can be set as part of a VGIS program's run-time configuration (see VGISConfiguration). Path Interpretation discusses path interpretation (e.g. Default Parent Dir).
layerProperties_t	layerProperties [MAX_LAYERS]
	This array describes how each terrain layer is blended.
char *	terrainDirs [MAX_LAYERS]
	This directory contains the terrain data base.
char *	geometryDirs [MAX_LAYERS]
	This directory contains the geometry data base.
char *	elevationDirs [MAX_LAYERS]
	This directory contains the elevation data base.
char *	imageryDirs [MAX_LAYERS]
	This directory contains the imagery data base.
char *	phototextureDirs [MAX_LAYERS]
	This directory contains the phototexture data base.
char *	shadedDirs [MAX_LAYERS]
	This directory contains the shaded relief data base.
char *	propertiesDirs [MAX_LAYERS]
	This directory contains the properties data base.
char *	quickloadDirs [MAX_LAYERS]
	This directory contains the "quickload" cached terrain information.
char *	vectorFile
	This file contains vector data in non-processed text format.
char *	vectorDirs
	This is semi-separated list of directories containing vector data.
VectorHandling	vectorHandling
	This determines how VGIS handles vector data.
vgis_boolean_t	showTerrainBoundingBoxes
	Enable/Disable display of terrain quadnode bounding boxes.
vgis_boolean_t	showObjectBoundingBoxes
	Enable/Disable display of object quadnode bounding boxes.
vgis_boolean_t	cullPagedObjects
	Enable/Disable paged object culling (assuming database supports it).

---

Detailed Description

ter_config_t contains the terrain library run-time configuration.

The "Configurable Data Members" can be initialized at run-time as described in VGISConfiguration.

ter_config_t Directories

Data for the 3D world comes from these directories:

• CommonConfig::rootDir/data/terrain (see ter_config_t::terrainDir)
• CommonConfig::rootDir/data/vector (see ter_config_t::vectorDirs)

Specific files are:

• ter_config_t::vectorDirs [0]/vector_data.txt (see ter_config_t::vectorFile)

Todo:

Despite what any of the VGIS papers may say, I've never seen a version of VGIS that supported multiple render thread/terrain managers per process. There have always been way to many unorganized 'static' global variables. If this problem is ever fixed (i.e. massive code reorganization) ter_config_t would probably be split into a struct that is common to all terrain managers (one per terrain.lib) and struct members that are specific per terrain manager object (one per terrain manager).

---

Member Data Documentation

vgis_boolean_t ter_config_t::cullPagedObjects

Enable/Disable paged object culling (assuming database supports it). Default: TRUE

char* ter_config_t::elevationDirs[MAX_LAYERS]

This directory contains the elevation data base. Initialize Options: Default: ter_config_t::geometryDir/elevation Config File: YES Default Parent Dir: ter_config_t::geometryDir

char* ter_config_t::geometryDirs[MAX_LAYERS]

This directory contains the geometry data base. Initialize Options: Default: ter_config_t::terrainDir/geometry Config File: YES Default Parent Dir: ter_config_t::terrainDir

char* ter_config_t::imageryDirs[MAX_LAYERS]

This directory contains the imagery data base. Initialize Options: Default: ter_config_t::terrainDir/imagery Config File: YES Default Parent Dir: ter_config_t::terrainDir

layerProperties_t ter_config_t::layerProperties[MAX_LAYERS]

This array describes how each terrain layer is blended.

float ter_config_t::maxMemoryLoad

This determines the fraction of host memory load that VGIS should allow itself to use. A number of the paging algorithms will keep old data around until this limit is exceeded at which point the least recently used data is purged.

ODB_version_t ter_config_t::objectDatabaseVersion

Paged object database version. This is the version of the database that was loaded.

char ter_config_t::objectDatabaseVersionStr[256]

String for paged object database version. This is the version of the database that was loaded.

char* ter_config_t::phototextureDirs[MAX_LAYERS]

This directory contains the phototexture data base. Initialize Options: Default: ter_config_t::imageryDir/phototexture Config File: YES Default Parent Dir: ter_config_t::imageryDir

char* ter_config_t::propertiesDirs[MAX_LAYERS]

This directory contains the properties data base. Initialize Options: Default: CommonConfig::terrainDir/properties Config File: YES Default Parent Dir: CommonConfig::terrainDir

char* ter_config_t::quickloadDirs[MAX_LAYERS]

This directory contains the "quickload" cached terrain information. Initialize Options: Default: ter_config_t::terrainDir Config File: YES Command Line: (-quickloadDir | -qld ) <DirName> Default Parent Dir*: CommonConfig::dataDir

vgis_boolean_t ter_config_t::renderMesh

Enable/disable display of terrain wireframe mesh. Default: FALSE

vgis_boolean_t ter_config_t::renderMesh_

vgis_boolean_t ter_config_t::renderTerrain

Enable/disable display of terrain polygons. Default: TRUE

vgis_boolean_t ter_config_t::renderTerrain_

char* ter_config_t::shadedDirs[MAX_LAYERS]

This directory contains the shaded relief data base. Initialize Options: Default: ter_config_t::imageryDir/shaded Config File: YES Default Parent Dir: ter_config_t::imageryDir

vgis_boolean_t ter_config_t::showObjectBoundingBoxes

Enable/Disable display of object quadnode bounding boxes. Default: FALSE

vgis_boolean_t ter_config_t::showTerrainBoundingBoxes

Enable/Disable display of terrain quadnode bounding boxes. Default: FALSE

char* ter_config_t::terrainDirs[MAX_LAYERS]

This directory contains the terrain data base. Initialize Options: Default: CommonConfig::dataDir/terrain Config File: YES Default Parent Dir: CommonConfig::dataDir

vgis_boolean_t ter_config_t::useCCC

This enables/disables the use of CCC coordinates for rendering paged objects. This run-time switchablity is primarily here for debugging and performance tests. Default: TRUE

vgis_boolean_t ter_config_t::useCCC_

char* ter_config_t::vectorDirs

This is semi-separated list of directories containing vector data. Currently only polyline data is supported. see polylines.c). Initialize Options: Default: CommonConfig::dataDir/vector Config File: YES Command Line: (-vectorDirs | -vd) <DirName> Default Parent Dir: CommonConfig::dataDir

char** ter_config_t::vectorDirsArray

these store the parsed vector directories

int ter_config_t::vectorDirsNumber

char* ter_config_t::vectorFile

This file contains vector data in non-processed text format. Currently only polyline data is supported. (see polylines.c). Initialize Options: Default: ./vector_data.txt Config File: YES Command Line: (-vectorFile | -vrf ) <FileName> Default Parent Dir: first directory in ter_config_t::vectorDirs

VectorHandling ter_config_t::vectorHandling

This determines how VGIS handles vector data. Currently, only polyline data is supported (see polylines.c) Initialize Options: Default: V_IGNORE Config File: YES Command Line: (-vectorHandling | -vh ) < VectorHandling >

---

The documentation for this class was generated from the following file:

• ter_config.h

---