diff --git a/docs/envvars.html b/docs/envvars.html index c6e23731065..b22c180b499 100644 --- a/docs/envvars.html +++ b/docs/envvars.html @@ -26,40 +26,40 @@ sometimes be useful for debugging end-user issues.

LibGL environment variables

-
LIBGL_DEBUG
+
LIBGL_DEBUG
If defined debug information will be printed to stderr. If set to 'verbose' additional information will be printed.
-
LIBGL_DRIVERS_PATH
+
LIBGL_DRIVERS_PATH
colon-separated list of paths to search for DRI drivers
-
LIBGL_ALWAYS_INDIRECT
+
LIBGL_ALWAYS_INDIRECT
if set to `true`, forces an indirect rendering context/connection.
-
LIBGL_ALWAYS_SOFTWARE
+
LIBGL_ALWAYS_SOFTWARE
if set to `true`, always use software rendering
-
LIBGL_NO_DRAWARRAYS
+
LIBGL_NO_DRAWARRAYS
if set to `true`, do not use DrawArrays GLX protocol (for debugging)
-
LIBGL_SHOW_FPS
+
LIBGL_SHOW_FPS
print framerate to stdout based on the number of glXSwapBuffers calls per second.
-
LIBGL_DRI3_DISABLE
+
LIBGL_DRI3_DISABLE
disable DRI3 if set to `true`.

Core Mesa environment variables

-
MESA_NO_ASM
+
MESA_NO_ASM
if set, disables all assembly language optimizations
-
MESA_NO_MMX
+
MESA_NO_MMX
if set, disables Intel MMX optimizations
-
MESA_NO_3DNOW
+
MESA_NO_3DNOW
if set, disables AMD 3DNow! optimizations
-
MESA_NO_SSE
+
MESA_NO_SSE
if set, disables Intel SSE optimizations
-
MESA_NO_ERROR
+
MESA_NO_ERROR
if set to 1, error checking is disabled as per KHR_no_error. This will result in undefined behaviour for invalid use of the api, but can reduce CPU use for apps that are known to be error free.
-
MESA_DEBUG
+
MESA_DEBUG
if set, error messages are printed to stderr. For example, if the application generates a GL_INVALID_ENUM error, a corresponding error message indicating where the error occurred, and possibly why, will be @@ -67,34 +67,34 @@ sometimes be useful for debugging end-user issues. output). MESA_DEBUG accepts the following comma-separated list of named flags, which adds extra behaviour to just set MESA_DEBUG=1:
-
silent
+
silent
turn off debug messages. Only useful for debug builds.
-
flush
+
flush
flush after each drawing command
-
incomplete_tex
+
incomplete_tex
extra debug messages when a texture is incomplete
-
incomplete_fbo
+
incomplete_fbo
extra debug messages when a fbo is incomplete
-
context
+
context
create a debug context (see GLX_CONTEXT_DEBUG_BIT_ARB) and print error and performance messages to stderr (or MESA_LOG_FILE).
-
MESA_LOG_FILE
+
MESA_LOG_FILE
specifies a file name for logging all errors, warnings, etc., rather than stderr
-
MESA_TEX_PROG
+
MESA_TEX_PROG
if set, implement conventional texture env modes with fragment programs (intended for developers only)
-
MESA_TNL_PROG
+
MESA_TNL_PROG
if set, implement conventional vertex transformation operations with vertex programs (intended for developers only). Setting this variable automatically sets the MESA_TEX_PROG variable as well.
-
MESA_EXTENSION_OVERRIDE
+
MESA_EXTENSION_OVERRIDE
can be used to enable/disable extensions. A value such as "GL_EXT_foo -GL_EXT_bar" will enable the GL_EXT_foo extension and disable the GL_EXT_bar extension.
-
MESA_EXTENSION_MAX_YEAR
+
MESA_EXTENSION_MAX_YEAR
The GL_EXTENSIONS string returned by Mesa is sorted by extension year. If this variable is set to year X, only extensions defined on or before year X will be reported. This is to work-around a bug in some games where @@ -102,7 +102,7 @@ sometimes be useful for debugging end-user issues. truncating. If the extension string is too long, the buffer overrun can cause the game to crash. This is a work-around for that.
-
MESA_GL_VERSION_OVERRIDE
+
MESA_GL_VERSION_OVERRIDE
changes the value returned by glGetString(GL_VERSION) and possibly the GL API type.
-
MESA_GLES_VERSION_OVERRIDE
+
MESA_GLES_VERSION_OVERRIDE
changes the value returned by glGetString(GL_VERSION) for OpenGL ES.
-
MESA_GLSL_VERSION_OVERRIDE
+
MESA_GLSL_VERSION_OVERRIDE
changes the value returned by glGetString(GL_SHADING_LANGUAGE_VERSION). Valid values are integers, such as "130". Mesa will not really implement all the features of the given language version if it's higher than what's normally reported. (for developers only)
-
MESA_GLSL_CACHE_DISABLE
+
MESA_GLSL_CACHE_DISABLE
if set to `true`, disables the GLSL shader cache
-
MESA_GLSL_CACHE_MAX_SIZE
+
MESA_GLSL_CACHE_MAX_SIZE
if set, determines the maximum size of the on-disk cache of compiled GLSL programs. Should be set to a number optionally followed by 'K', 'M', or 'G' to specify a size in kilobytes, megabytes, or gigabytes. By default, @@ -170,21 +170,21 @@ glGetString(GL_VERSION) and possibly the GL API type. Mesa is installed for on your system. For example under the default settings you may end up with a 1GB cache for x86_64 and another 1GB cache for i386.
-
MESA_GLSL_CACHE_DIR
+
MESA_GLSL_CACHE_DIR
if set, determines the directory to be used for the on-disk cache of compiled GLSL programs. If this variable is not set, then the cache will be stored in $XDG_CACHE_HOME/mesa_shader_cache (if that variable is set), or else within .cache/mesa_shader_cache within the user's home directory.
-
MESA_GLSL
+
MESA_GLSL
shading language compiler options
-
MESA_NO_MINMAX_CACHE
+
MESA_NO_MINMAX_CACHE
when set, the minmax index cache is globally disabled.
-
MESA_SHADER_CAPTURE_PATH
+
MESA_SHADER_CAPTURE_PATH
see Capturing Shaders
-
MESA_SHADER_DUMP_PATH and MESA_SHADER_READ_PATH
+
MESA_SHADER_DUMP_PATH and MESA_SHADER_READ_PATH
see Experimenting with Shader Replacements
-
MESA_VK_VERSION_OVERRIDE
+
MESA_VK_VERSION_OVERRIDE
changes the Vulkan physical device version as returned in VkPhysicalDeviceProperties::apiVersion.