envvars(3)

NAME
envvars - Miscellaneous Environment Variables

 - Various aspects of the Coin runtime behaviour can be controlled through setting different environment variables to some value.

SYNOPSIS

  Variables
typedef EnvironmentVariable
EnvironmentVariable COIN_DEBUG_GLU_INFO
EnvironmentVariable COIN_DEBUG_GLU_VERSION
EnvironmentVariable COIN_DEBUG_FONTSUPPORT
EnvironmentVariable COIN_DEBUG_3DS
EnvironmentVariable COIN_DEBUG_AUDIO
EnvironmentVariable COIN_DEBUG_BREAK
EnvironmentVariable COIN_DEBUG_CACHING
EnvironmentVariable COIN_DEBUG_DL
EnvironmentVariable COIN_DEBUG_IMPORT
EnvironmentVariable COIN_DEBUG_LISTMODULES
EnvironmentVariable COIN_DEBUG_SOINPUT_FINDFILE
EnvironmentVariable COIN_DEBUG_SOOFFSCREENRENDERER
EnvironmentVariable COIN_DEBUG_WRITEREFS
EnvironmentVariable COIN_RANDOMIZE_RENDER_CACHING
EnvironmentVariable COIN_FREETYPE2_LIBNAME
EnvironmentVariable COIN_FORCE_FREETYPE_OFF
EnvironmentVariable COIN_FORCE_WIN32FONTS_OFF
EnvironmentVariable COIN_FONT_PATH
EnvironmentVariable COIN_DISABLE_UTF8
EnvironmentVariable COIN_GLBBOX
EnvironmentVariable COIN_GLU_LIBNAME
EnvironmentVariable COIN_AGLGLUE_NO_PBUFFERS
EnvironmentVariable COIN_SIMAGE_LIBNAME
EnvironmentVariable COIN_GLXGLUE_NO_GLX13_PBUFFERS
EnvironmentVariable COIN_GLXGLUE_NO_PBUFFERS
EnvironmentVariable COIN_ZLIB_LIBNAME
EnvironmentVariable COIN_BZIP2_LIBNAME
EnvironmentVariable COIN_WGLGLUE_NO_PBUFFERS
EnvironmentVariable COIN_DONT_MANGLE_OUTPUT_NAMES
EnvironmentVariable COIN_EXTSELECTION_SAVE_OFFSCREENBUFFER
EnvironmentVariable COIN_FORCE_TILED_OFFSCREENRENDERING
EnvironmentVariable COIN_GLERROR_DEBUGGING
EnvironmentVariable COIN_IDA_DEBUG
EnvironmentVariable COIN_OFFSCREENRENDERER_MAX_TILESIZE
EnvironmentVariable COIN_OFFSCREENRENDERER_TILEHEIGHT
EnvironmentVariable COIN_OFFSCREENRENDERER_TILEWIDTH
EnvironmentVariable COIN_OLDSTYLE_FORMATTING
EnvironmentVariable COIN_SEPARATE_DIFFUSE_TRANSPARENCY_OVERRIDE
EnvironmentVariable COIN_SOINPUT_SEARCH_GLOBAL_DICT
EnvironmentVariable COIN_SOOFFSCREENRENDERER_TILEPREFIX
EnvironmentVariable COIN_SORTED_LAYERS_USE_NVIDIA_RC
EnvironmentVariable COIN_SOUND_BUFFER_LENGTH
EnvironmentVariable COIN_SOUND_DISABLE
EnvironmentVariable COIN_SOUND_DRIVER_NAME
EnvironmentVariable COIN_SOUND_ENABLE
EnvironmentVariable COIN_SOUND_INTRO_PAUSE
EnvironmentVariable COIN_SOUND_NUM_BUFFERS
EnvironmentVariable COIN_SOUND_THREAD_SLEEP_TIME
EnvironmentVariable COIN_OPENAL_LIBNAME
EnvironmentVariable COIN_TEX2_LINEAR_LIMIT
EnvironmentVariable COIN_TEX2_LINEAR_MIPMAP_LIMIT
EnvironmentVariable COIN_TEX2_MIPMAP_LIMIT
EnvironmentVariable COIN_TEX2_SCALEUP_LIMIT
EnvironmentVariable COIN_TEX2_USE_GLTEXSUBIMAGE
EnvironmentVariable COIN_MAXIMUM_TEXTURE2_SIZE
EnvironmentVariable COIN_MAXIMUM_TEXTURE3_SIZE
EnvironmentVariable COIN_USE_GL_VERTEX_ARRAYS
EnvironmentVariable COIN_NORMALIZATION_CUBEMAP_SIZE
EnvironmentVariable OIV_NUM_SORTED_LAYERS_PASSES
EnvironmentVariable COIN_MAX_VBO_MEMORY
EnvironmentVariable COIN_NUM_SORTED_LAYERS_PASSES
EnvironmentVariable COIN_QUADMESH_PRECISE_LIGHTING
EnvironmentVariable COIN_ENABLE_CONFORMANT_GL_CLAMP
EnvironmentVariable IV_SEPARATOR_MAX_CACHES
EnvironmentVariable COIN_AUTOCACHE_LOCAL_MAX
EnvironmentVariable COIN_AUTOCACHE_LOCAL_MIN
EnvironmentVariable COIN_AUTOCACHE_REMOTE_MAX
EnvironmentVariable COIN_AUTOCACHE_REMOTE_MIN
EnvironmentVariable COIN_AUTO_CACHING
EnvironmentVariable COIN_ENABLE_VBO
EnvironmentVariable COIN_VBO
EnvironmentVariable COIN_VBO_MAX_LIMIT
EnvironmentVariable COIN_VBO_MIN_LIMIT
EnvironmentVariable COIN_SOOFFSCREENRENDERER_ALLOW_RESOURCEHOG
EnvironmentVariable SO_DRAGGER_DIR
EnvironmentVariable SO_SHADER_DIR
EnvironmentVariable COINDIR
EnvironmentVariable COIN_ALLOW_SPIDERMONKEY
EnvironmentVariable COIN_AUTOCACHE_VBO_LIMIT
EnvironmentVariable COIN_CALCULATE_NURBS_NORMALS
EnvironmentVariable COIN_CGLGLUE_NO_PBUFFERS
EnvironmentVariable COIN_CG_LIBNAME
EnvironmentVariable COIN_DEBUG_ASSERT_SOBASE_SETNAME
EnvironmentVariable COIN_DEBUG_BINARY_INPUT
EnvironmentVariable COIN_DEBUG_CLEANUP
EnvironmentVariable COIN_DEBUG_EXTRA
EnvironmentVariable COIN_DEBUG_FLATTEN_NODEKITS_ON_WRITE
EnvironmentVariable COIN_DEBUG_GLRENDER_TRAVERSAL
EnvironmentVariable COIN_DEBUG_GLUNURBSSURFACE
EnvironmentVariable COIN_DEBUG_INTERSECTIONDETECTIONACTION
EnvironmentVariable COIN_DEBUG_MUTEXLOCK_MAXTIME
EnvironmentVariable COIN_DEBUG_MUTEXLOCK_TIMING
const char * COIN_DEBUG_MUTEX_COUNT = 'COIN_DEBUG_MUTEX_COUNT'
EnvironmentVariable COIN_DEBUG_NORMALIZE
EnvironmentVariable COIN_DEBUG_NPRINTF
EnvironmentVariable COIN_DEBUG_NURBS_COMPLEXITY
EnvironmentVariable COIN_DEBUG_ROOT_NOTIFICATIONS
EnvironmentVariable COIN_DEBUG_SIMAGE
EnvironmentVariable COIN_DEBUG_SOEXTSELECTION
EnvironmentVariable COIN_DEBUG_SOFILE_READ
EnvironmentVariable COIN_DEBUG_SOOFFSCREENRENDERER_TILEPREFIX
EnvironmentVariable COIN_DEBUG_SPIDERMONKEY_BINDING
EnvironmentVariable COIN_DEBUG_STRING_GROW
EnvironmentVariable COIN_DEBUG_TRACK_SOBASE_INSTANCES
EnvironmentVariable COIN_DEBUG_VBO
EnvironmentVariable COIN_DEBUG_VRMLSCRIPT
EnvironmentVariable COIN_FONTCONFIG_LIBNAME
EnvironmentVariable COIN_FORCE_AGL
EnvironmentVariable COIN_FORCE_FONTCONFIG_OFF
EnvironmentVariable COIN_GLU_SILENCE_TESS_COMBINE_WARNING
EnvironmentVariable COIN_GL_DISABLE_VBO
EnvironmentVariable COIN_GL_NO_CURRENT_CONTEXT_CHECK
EnvironmentVariable COIN_HANDLE_STACK_OVERFLOW
EnvironmentVariable COIN_NESTED_CACHING
EnvironmentVariable COIN_NOT_STRICT_VRML97
EnvironmentVariable COIN_NO_NVIDIA_COLOR_PER_FACE_BUG_WORKAROUND
EnvironmentVariable COIN_NO_SOTYPE_DYNLOAD
EnvironmentVariable COIN_OFFSCREEN_STENCIL_BITS
EnvironmentVariable COIN_OLD_NURBS_COMPLEXITY
EnvironmentVariable COIN_PREFER_GLU_TESSELLATOR
EnvironmentVariable COIN_REDUCE_LINEAR_NURBS_STEPS
EnvironmentVariable COIN_SMART_CACHING
EnvironmentVariable COIN_SPIDERMONKEY_LIBNAME
EnvironmentVariable COIN_TEX2_ANISOTROPIC_LIMIT
EnvironmentVariable COIN_TEX2_USE_SGIS_GENERATE_MIPMAP
EnvironmentVariable COIN_VERTEX_ARRAYS
EnvironmentVariable COIN_VIEWUP
EnvironmentVariable WINDIR

Detailed Description

Various aspects of the Coin runtime behaviour can be controlled through setting different environment variables to some value. Most of these variables are there for debugging and problem-workaround purposes, but a few are for telling Coin where to locate external resource files.

Here we will set up a list of some of the environment variables Coin will check for and can alter behavior because of. Scene Graph Profiler The scene graph profiler subsystem uses the following environment variables:

•   COIN_PROFILER

•   COIN_PROFILER_OVERLAY

A lot of other environment variables will also affect the profiling and listing them all would be tedious. Most useful is perhaps the IV_SEPARATOR_MAX_CACHES variable for disabling caching, and those that disable features like vertex arrays and frame buffer objects, but using these will of course cause you to profile special cases that may not be as important as you might think.

Variable Documentation

  EnvironmentVariable
This is a fake type to peg documentation for environment variables that Coin uses on.

Environment variables are variables you set on your system, which are read in by the Coin-based application at runtime. These environment variables are irrelevant at compile time when Coin is built.

  EnvironmentVariable COIN_DEBUG_GLU_INFO

  EnvironmentVariable COIN_DEBUG_GLU_VERSION

  EnvironmentVariable COIN_DEBUG_FONTSUPPORT

  EnvironmentVariable COIN_DEBUG_3DS

  EnvironmentVariable COIN_DEBUG_AUDIO

  EnvironmentVariable COIN_DEBUG_BREAK

  EnvironmentVariable COIN_DEBUG_CACHING

  EnvironmentVariable COIN_DEBUG_DL

  EnvironmentVariable COIN_DEBUG_IMPORT

  EnvironmentVariable COIN_DEBUG_LISTMODULES

  EnvironmentVariable COIN_DEBUG_SOINPUT_FINDFILE

  EnvironmentVariable COIN_DEBUG_SOOFFSCREENRENDERER

  EnvironmentVariable COIN_DEBUG_WRITEREFS

  EnvironmentVariable COIN_RANDOMIZE_RENDER_CACHING

  EnvironmentVariable COIN_FREETYPE2_LIBNAME

  EnvironmentVariable COIN_FORCE_FREETYPE_OFF

  EnvironmentVariable COIN_FORCE_WIN32FONTS_OFF

  EnvironmentVariable COIN_FONT_PATH

  EnvironmentVariable COIN_DISABLE_UTF8
Coin from version 4.0 onwards expects all characters related to text rendering to be UTF-8 encoded.

This variable should be a set, if you need to reinstate the old behavior of treating all characters according to the Western Latin-1 encoding.

  EnvironmentVariable COIN_GLBBOX
If the environment variable COIN_GLBBOX is set to 1, rendering action traversals will apply a bounding box action before rendering. This will make sure bounding box caches are updated (needed for view frustum culling). The default Quarter/SoQt/SoWin/SoXt viewers will handle this at their end (which is the proper way to do it), so we don't do this by default.

  EnvironmentVariable COIN_GLU_LIBNAME

  EnvironmentVariable COIN_AGLGLUE_NO_PBUFFERS

  EnvironmentVariable COIN_SIMAGE_LIBNAME

  EnvironmentVariable COIN_GLXGLUE_NO_GLX13_PBUFFERS

  EnvironmentVariable COIN_GLXGLUE_NO_PBUFFERS

  EnvironmentVariable COIN_ZLIB_LIBNAME

  EnvironmentVariable COIN_BZIP2_LIBNAME

  EnvironmentVariable COIN_WGLGLUE_NO_PBUFFERS

  EnvironmentVariable COIN_DONT_MANGLE_OUTPUT_NAMES

  EnvironmentVariable COIN_EXTSELECTION_SAVE_OFFSCREENBUFFER

  EnvironmentVariable COIN_FORCE_TILED_OFFSCREENRENDERING

  EnvironmentVariable COIN_GLERROR_DEBUGGING

  EnvironmentVariable COIN_IDA_DEBUG

  EnvironmentVariable COIN_OFFSCREENRENDERER_MAX_TILESIZE

  EnvironmentVariable COIN_OFFSCREENRENDERER_TILEHEIGHT

  EnvironmentVariable COIN_OFFSCREENRENDERER_TILEWIDTH

  EnvironmentVariable COIN_OLDSTYLE_FORMATTING

  EnvironmentVariable COIN_SEPARATE_DIFFUSE_TRANSPARENCY_OVERRIDE

  EnvironmentVariable COIN_SOINPUT_SEARCH_GLOBAL_DICT

  EnvironmentVariable COIN_SOOFFSCREENRENDERER_TILEPREFIX

  EnvironmentVariable COIN_SORTED_LAYERS_USE_NVIDIA_RC

  EnvironmentVariable COIN_SOUND_BUFFER_LENGTH

  EnvironmentVariable COIN_SOUND_DISABLE

  EnvironmentVariable COIN_SOUND_DRIVER_NAME

  EnvironmentVariable COIN_SOUND_ENABLE

  EnvironmentVariable COIN_SOUND_INTRO_PAUSE

  EnvironmentVariable COIN_SOUND_NUM_BUFFERS

  EnvironmentVariable COIN_SOUND_THREAD_SLEEP_TIME

  EnvironmentVariable COIN_OPENAL_LIBNAME

  EnvironmentVariable COIN_TEX2_LINEAR_LIMIT

  EnvironmentVariable COIN_TEX2_LINEAR_MIPMAP_LIMIT

  EnvironmentVariable COIN_TEX2_MIPMAP_LIMIT

  EnvironmentVariable COIN_TEX2_SCALEUP_LIMIT

  EnvironmentVariable COIN_TEX2_USE_GLTEXSUBIMAGE

  EnvironmentVariable COIN_MAXIMUM_TEXTURE2_SIZE

  EnvironmentVariable COIN_MAXIMUM_TEXTURE3_SIZE

  EnvironmentVariable COIN_USE_GL_VERTEX_ARRAYS

  EnvironmentVariable COIN_NORMALIZATION_CUBEMAP_SIZE

  EnvironmentVariable OIV_NUM_SORTED_LAYERS_PASSES

  EnvironmentVariable COIN_MAX_VBO_MEMORY

  EnvironmentVariable COIN_NUM_SORTED_LAYERS_PASSES

  EnvironmentVariable COIN_QUADMESH_PRECISE_LIGHTING

  EnvironmentVariable COIN_ENABLE_CONFORMANT_GL_CLAMP

  EnvironmentVariable IV_SEPARATOR_MAX_CACHES
Can be used to tune the number of display list caches stored in each SoSeparator. The default value is 2.

Setting this value to 0 will disable display list caching, and this is often useful if you experience weird rendering bugs which are hard to track down.

  EnvironmentVariable COIN_AUTOCACHE_LOCAL_MAX

  EnvironmentVariable COIN_AUTOCACHE_LOCAL_MIN

  EnvironmentVariable COIN_AUTOCACHE_REMOTE_MAX

  EnvironmentVariable COIN_AUTOCACHE_REMOTE_MIN

  EnvironmentVariable COIN_AUTO_CACHING

  EnvironmentVariable COIN_ENABLE_VBO

  EnvironmentVariable COIN_VBO
Set COIN_VBO=0 to disable VBO rendering in Coin. This is useful if you suspect bugs in either Coin's VBO code or in the OpenGL driver VBO handling.

  EnvironmentVariable COIN_VBO_MAX_LIMIT
Can be used to set the maximum number of items (coordinates, normals, texcoords or colors) allowed when creating a vertex buffer object. On most drivers it's actually slower to render large arrays with VBOs than with normal vertex array rendering.

The default value is 256000, and when the number of items exceeds this Coin will fall back to normal vertex array or immediate mode rendering.

See also
    COIN_VBO_MIN_LIMIT

  EnvironmentVariable COIN_VBO_MIN_LIMIT
Can be used to set the minimum number of items (coordinates, normals, texcoords or colors) allowed when creating a vertex buffer object. It's a bit of overhead setting up the VBOs and the VBO rendering, so we avoid doing this for very small arrays. The default value is 20.

See also
    COIN_VBO_MAX_LIMIT

  EnvironmentVariable COIN_SOOFFSCREENRENDERER_ALLOW_RESOURCEHOG

  EnvironmentVariable SO_DRAGGER_DIR

  EnvironmentVariable SO_SHADER_DIR

  EnvironmentVariable COINDIR

  EnvironmentVariable COIN_ALLOW_SPIDERMONKEY

  EnvironmentVariable COIN_AUTOCACHE_VBO_LIMIT

  EnvironmentVariable COIN_CALCULATE_NURBS_NORMALS

  EnvironmentVariable COIN_CGLGLUE_NO_PBUFFERS

  EnvironmentVariable COIN_CG_LIBNAME

  EnvironmentVariable COIN_DEBUG_ASSERT_SOBASE_SETNAME

  EnvironmentVariable COIN_DEBUG_BINARY_INPUT

  EnvironmentVariable COIN_DEBUG_CLEANUP

  EnvironmentVariable COIN_DEBUG_EXTRA

  EnvironmentVariable COIN_DEBUG_FLATTEN_NODEKITS_ON_WRITE

  EnvironmentVariable COIN_DEBUG_GLRENDER_TRAVERSAL

  EnvironmentVariable COIN_DEBUG_GLUNURBSSURFACE

  EnvironmentVariable COIN_DEBUG_INTERSECTIONDETECTIONACTION

  EnvironmentVariable COIN_DEBUG_MUTEXLOCK_MAXTIME

  EnvironmentVariable COIN_DEBUG_MUTEXLOCK_TIMING

  EnvironmentVariable COIN_DEBUG_MUTEX_COUNT = 'COIN_DEBUG_MUTEX_COUNT'

  EnvironmentVariable COIN_DEBUG_NORMALIZE

  EnvironmentVariable COIN_DEBUG_NPRINTF

  EnvironmentVariable COIN_DEBUG_NURBS_COMPLEXITY

  EnvironmentVariable COIN_DEBUG_ROOT_NOTIFICATIONS

  EnvironmentVariable COIN_DEBUG_SIMAGE

  EnvironmentVariable COIN_DEBUG_SOEXTSELECTION

  EnvironmentVariable COIN_DEBUG_SOFILE_READ

  EnvironmentVariable COIN_DEBUG_SOOFFSCREENRENDERER_TILEPREFIX

  EnvironmentVariable COIN_DEBUG_SPIDERMONKEY_BINDING

  EnvironmentVariable COIN_DEBUG_STRING_GROW

  EnvironmentVariable COIN_DEBUG_TRACK_SOBASE_INSTANCES

  EnvironmentVariable COIN_DEBUG_VBO

  EnvironmentVariable COIN_DEBUG_VRMLSCRIPT

  EnvironmentVariable COIN_FONTCONFIG_LIBNAME

  EnvironmentVariable COIN_FORCE_AGL

  EnvironmentVariable COIN_FORCE_FONTCONFIG_OFF

  EnvironmentVariable COIN_GLU_SILENCE_TESS_COMBINE_WARNING

  EnvironmentVariable COIN_GL_DISABLE_VBO

  EnvironmentVariable COIN_GL_NO_CURRENT_CONTEXT_CHECK

  EnvironmentVariable COIN_HANDLE_STACK_OVERFLOW

  EnvironmentVariable COIN_NESTED_CACHING

  EnvironmentVariable COIN_NOT_STRICT_VRML97

  EnvironmentVariable COIN_NO_NVIDIA_COLOR_PER_FACE_BUG_WORKAROUND

  EnvironmentVariable COIN_NO_SOTYPE_DYNLOAD

  EnvironmentVariable COIN_OFFSCREEN_STENCIL_BITS

  EnvironmentVariable COIN_OLD_NURBS_COMPLEXITY

  EnvironmentVariable COIN_PREFER_GLU_TESSELLATOR

  EnvironmentVariable COIN_REDUCE_LINEAR_NURBS_STEPS

  EnvironmentVariable COIN_SMART_CACHING

  EnvironmentVariable COIN_SPIDERMONKEY_LIBNAME

  EnvironmentVariable COIN_TEX2_ANISOTROPIC_LIMIT

  EnvironmentVariable COIN_TEX2_USE_SGIS_GENERATE_MIPMAP

  EnvironmentVariable COIN_VERTEX_ARRAYS

  EnvironmentVariable COIN_VIEWUP

  EnvironmentVariable WINDIR
%WINDIR%/Fonts is always searched for fonts on Windows.

Author

Generated automatically by Doxygen for Coin from the source code.