Environment Variables¶
This is a list of environment variables supported by osgEarth.
Caching:
OSGEARTH_CACHE_PATH: Sets up a cache at the specified folder (path) OSGEARTH_CACHE_ONLY: Directs osgEarth to ONLY use the cache and no data sources (set to 1) OSGEARTH_NO_CACHE: Directs osgEarth to NEVER use the cache (set to 1) OSGEARTH_CACHE_DRIVER: Sets the name of the plugin to use for caching (default is “filesystem”)
Threading/Performance:
OSG_NUM_DATABASE_THREADS: Sets the total number of threads that the OSG DatabasePager will use to load terrain tiles and feature data tiles. OSG_NUM_HTTP_DATABASE_THREADS: Sets the number of threads in the Pager’s thread pool (see above) that should be used for “high-latency” operations. (Usually this means operations that do not read data from the cache, or are expected to take more time than average.)
Debugging:
OSGEARTH_NOTIFY_LEVEL: Similar to OSG_NOTIFY_LEVEL
, sets the verbosity for console output. Values areDEBUG
,INFO
,NOTICE
, andWARN
. Default isNOTICE
. (This is distinct from OSG’s notify level.)OSGEARTH_MP_PROFILE: Dumps verbose profiling and timing data about the terrain engine’s tile generator to the console. Set to 1 for detailed per-tile timings; Set to 2 for average tile load time calculations OSGEARTH_MP_DEBUG: Draws tile bounding boxes and tilekey labels atop the map OSGEARTH_MERGE_SHADERS: Consolidate all shaders within a single shader program; this is required for GLES (mobile devices) and is therefore useful for testing. (set to 1). OSGEARTH_DUMP_SHADERS: Prints composed shader programs to the console (set to 1).
Rendering:
OSGEARTH_DEFAULT_FONT: Name of the default font to use for text symbology OSGEARTH_MIN_STAR_MAGNITUDE: Smallest star magnitude to use in SkyNode
Networking:
OSGEARTH_HTTP_DEBUG: Prints HTTP debugging messages (set to 1) OSGEARTH_HTTP_TIMEOUT: Sets an HTTP timeout (seconds) OSG_CURL_PROXY: Sets a proxy server for HTTP requests (string) OSG_CURL_PROXYPORT: Sets a proxy port for HTTP proxy server (integer) OSGEARTH_CURL_PROXYAUTH: Sets proxy authentication information (username:password) OSGEARTH_SIMULATE_HTTP_RESPONSE_CODE: Simulates HTTP errors (for debugging; set to HTTP response code)
Misc:
OSGEARTH_USE_PBUFFER_TEST: Directs the osgEarth platform Capabilities analyzer to create a PBUFFER-based graphics context for collecting GL support information. (set to 1)