envvars.3coin4 man page

envvars ā€” 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:

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 run-time. 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 bbox 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.

Info

Tue Jan 28 2020 Version 4.0.0 Coin