envvars (3)

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 thise will of course cause you to profile special cases that may not be as important as you might think.

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

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.

Generated automatically by Doxygen for Coin from the source code.