X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=docs%2Fenvvars.html;h=c9733e6523458c08283062a41d88900a64edba7c;hb=refs%2Fheads%2Fnougat-x86;hp=2269f1856460549f1c53d23fc36b11db981dc90b;hpb=41ad178b1347ad58a5cbad733426ee3b7b37a835;p=android-x86%2Fexternal-mesa.git diff --git a/docs/envvars.html b/docs/envvars.html index 2269f185646..c9733e65234 100644 --- a/docs/envvars.html +++ b/docs/envvars.html @@ -29,12 +29,12 @@ sometimes be useful for debugging end-user issues.
  • LIBGL_DEBUG - If defined debug information will be printed to stderr. If set to 'verbose' additional information will be printed.
  • LIBGL_DRIVERS_PATH - colon-separated list of paths to search for DRI drivers -
  • LIBGL_ALWAYS_INDIRECT - forces an indirect rendering context/connection. -
  • LIBGL_ALWAYS_SOFTWARE - if set, always use software rendering -
  • LIBGL_NO_DRAWARRAYS - if set do not use DrawArrays GLX protocol (for debugging) +
  • LIBGL_ALWAYS_INDIRECT - if set to `true`, forces an indirect rendering context/connection. +
  • LIBGL_ALWAYS_SOFTWARE - if set to `true`, always use software rendering +
  • LIBGL_NO_DRAWARRAYS - if set to `true`, do not use DrawArrays GLX protocol (for debugging)
  • LIBGL_SHOW_FPS - print framerate to stdout based on the number of glXSwapBuffers calls per second. -
  • LIBGL_DRI3_DISABLE - disable DRI3 if set (the value does not matter) +
  • LIBGL_DRI3_DISABLE - disable DRI3 if set to `true`. @@ -46,6 +46,9 @@ sometimes be useful for debugging end-user issues.
  • MESA_NO_MMX - if set, disables Intel MMX optimizations
  • MESA_NO_3DNOW - if set, disables AMD 3DNow! optimizations
  • MESA_NO_SSE - if set, disables Intel SSE optimizations +
  • 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 - 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 @@ -85,22 +88,40 @@ This is a work-around for that.
  • MESA_GL_VERSION_OVERRIDE - changes the value returned by glGetString(GL_VERSION) and possibly the GL API type.
  • MESA_GLES_VERSION_OVERRIDE - changes the value returned by glGetString(GL_VERSION) for OpenGL ES. @@ -114,19 +135,34 @@ glGetString(GL_VERSION) for OpenGL ES. 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 - if set, disables the GLSL shader cache +
  • MESA_GLSL_CACHE_DISABLE - if set to `true`, disables the GLSL shader cache
  • 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, gigabytes will be -assumed. And if unset, a maxium size of 1GB will be used. +assumed. And if unset, a maximum size of 1GB will be used. Note: A separate +cache might be created for each architecture that 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 - 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 (if -that variable is set), or else within .cache/mesa within the user's +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 - shading language compiler options
  • MESA_NO_MINMAX_CACHE - when set, the minmax index cache is globally disabled. +
  • MESA_SHADER_CAPTURE_PATH - see Capturing Shaders
    • +
  • MESA_SHADER_DUMP_PATH and MESA_SHADER_READ_PATH - see Experimenting with Shader Replacements
    • +
  • MESA_VK_VERSION_OVERRIDE - changes the Vulkan physical device version + as returned in VkPhysicalDeviceProperties::apiVersion. + +
    • @@ -157,47 +193,49 @@ See the Xlib software driver page for details. This is useful for debugging hangs, etc.
  • INTEL_DEBUG - a comma-separated list of named flags, which do various things: +
  • INTEL_SCALAR_VS (or TCS, TES, GS) - force scalar/vec4 mode for a shader stage (Gen8-9 only)
  • INTEL_PRECISE_TRIG - if set to 1, true or yes, then the driver prefers accuracy over performance in trig functions.
    • @@ -231,10 +269,10 @@ Mesa EGL supports different sets of environment variables. See the Especially useful to toggle hud at specific points of application and disable for unencumbered viewing the rest of the time. For example, set GALLIUM_HUD_VISIBLE to false and GALLIUM_HUD_TOGGLE_SIGNAL to 10 (SIGUSR1). - Use kill -10 to toggle the hud as desired. + Use kill -10 <pid> to toggle the hud as desired.
  • GALLIUM_HUD_DUMP_DIR - specifies a directory for writing the displayed hud values into files. -
  • GALLIUM_DRIVER - useful in combination with LIBGL_ALWAYS_SOFTWARE=1 for +
  • GALLIUM_DRIVER - useful in combination with LIBGL_ALWAYS_SOFTWARE=true for choosing one of the software renderers "softpipe", "llvmpipe" or "swr".
  • GALLIUM_LOG_FILE - specifies a file for logging all errors, warnings, etc. rather than stderr. @@ -298,9 +336,17 @@ See src/mesa/state_tracker/st_debug.c for other options. (will often result in incorrect rendering).
  • SVGA_DEBUG - for dumping shaders, constant buffers, etc. See the code for details. +
  • SVGA_EXTRA_LOGGING - if set, enables extra logging to the vmware.log file, +such as the OpenGL program's name and command line arguments.
  • See the driver code for other, lesser-used variables. +

    WGL environment variables

    +

    VA-API state tracker environment variables