From 8a191c08ddda2e66fa26f148d6c21959bb08f923 Mon Sep 17 00:00:00 2001 From: marha Date: Sun, 20 Feb 2011 12:29:25 +0000 Subject: xserver xkeyboard-config libX11 pixman mesa git update 2011 --- mesalib/docs/envvars.html | 233 ++++++++++++++++++++++++++++++---------------- 1 file changed, 155 insertions(+), 78 deletions(-) (limited to 'mesalib/docs/envvars.html') diff --git a/mesalib/docs/envvars.html b/mesalib/docs/envvars.html index fd1700a02..5240c803f 100644 --- a/mesalib/docs/envvars.html +++ b/mesalib/docs/envvars.html @@ -1,78 +1,155 @@ - - -Environment Variables - - - - - -

Environment Variables

- -

-Mesa supports the following environment variables: -

MESA_NO_ASM - if set, disables all assembly language optimizations -
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_DEBUG - if set, error messages are printed to stderr. -If the value of MESA_DEBUG is "FP" floating point arithmetic errors will -generate exceptions. -
MESA_NO_DITHER - if set, disables dithering, overriding glEnable(GL_DITHER) -
MESA_TEX_PROG - if set, implement conventional texture env modes with -fragment programs (intended for developers only) -
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 - 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_GLSL - shading language options -

- -

-The following are only applicable to the Xlib software driver. -See the Xlib software driver page for details. -

MESA_RGB_VISUAL - specifies the X visual and depth for RGB mode -
MESA_CI_VISUAL - specifies the X visual and depth for CI mode -
MESA_BACK_BUFFER - specifies how to implement the back color buffer, - either "pixmap" or "ximage" -
MESA_GAMMA - gamma correction coefficients for red, green, blue channels -
MESA_XSYNC - enable synchronous X behavior (for debugging only) -
MESA_GLX_FORCE_CI - if set, force GLX to treat 8bpp visuals as CI visuals -
MESA_GLX_FX - set to either "fullscreen" for full-screen rendering, - "window" to render into a window, or "disable" to disable the Glide driver. -
MESA_GLX_FORCE_ALPHA - if set, forces RGB windows to have an alpha channel. -
MESA_GLX_DEPTH_BITS - specifies default number of bits for depth buffer. -
MESA_GLX_ALPHA_BITS - specifies default number of bits for alpha channel. -

- - -

-These environment variables are for the Intel i945/i965 drivers: -

INTEL_STRICT_CONFORMANCE - if set to 1, enable sw fallbacks to improve - OpenGL conformance. If set to 2, always use software rendering. -
INTEL_NO_BLIT - if set, disable hardware-accelerated glBitmap, - glCopyPixels, glDrawPixels. -

- - -

-These environment variables are for the Radeon R300 driver: -

R300_NO_TCL - if set, disable hardware-accelerated Transform/Clip/Lighting. -

- -

-Mesa EGL supports different sets of environment variables. See the -Mesa EGL page for the details. -

- - - + + +Environment Variables + + + + + +

Environment Variables

+ +

+Normally, no environment variables need to be set. Most of the environment +variables used by Mesa/Gallium are for debugging purposes, but they can +sometimes be useful for debugging end-user issues. +

+ + +

LibGL environment variables

+ +

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) +

+ + + +

Core Mesa environment variables

+ +

MESA_NO_ASM - if set, disables all assembly language optimizations +
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_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 occured, and possibly why, will be + printed to stderr.
+ If the value of MESA_DEBUG is 'FP' floating point arithmetic errors will + generate exceptions. +
MESA_TEX_PROG - if set, implement conventional texture env modes with +fragment programs (intended for developers only) +
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 - 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_GLSL - shading language compiler options +

+ + +

Mesa Xlib driver environment variables

+ +

+The following are only applicable to the Mesa Xlib software driver. +See the Xlib software driver page for details. +

MESA_RGB_VISUAL - specifies the X visual and depth for RGB mode +
MESA_CI_VISUAL - specifies the X visual and depth for CI mode +
MESA_BACK_BUFFER - specifies how to implement the back color buffer, + either "pixmap" or "ximage" +
MESA_GAMMA - gamma correction coefficients for red, green, blue channels +
MESA_XSYNC - enable synchronous X behavior (for debugging only) +
MESA_GLX_FORCE_CI - if set, force GLX to treat 8bpp visuals as CI visuals +
MESA_GLX_FX - set to either "fullscreen" for full-screen rendering, + "window" to render into a window, or "disable" to disable the Glide driver. +
MESA_GLX_FORCE_ALPHA - if set, forces RGB windows to have an alpha channel. +
MESA_GLX_DEPTH_BITS - specifies default number of bits for depth buffer. +
MESA_GLX_ALPHA_BITS - specifies default number of bits for alpha channel. +

+ + +

i945/i965 driver environment variables (non-Gallium)

+ +

INTEL_STRICT_CONFORMANCE - if set to 1, enable sw fallbacks to improve + OpenGL conformance. If set to 2, always use software rendering. +
INTEL_NO_BLIT - if set, disable hardware-accelerated glBitmap, + glCopyPixels, glDrawPixels. +

+ + +

Radeon R300 driver environment variables (non-Gallium)

+ +

R300_NO_TCL - if set, disable hardware-accelerated Transform/Clip/Lighting. +

+ + +

EGL environment variables

+ +

+Mesa EGL supports different sets of environment variables. See the +Mesa EGL page for the details. +

+ + +

Gallium environment variables

+ +

GALLIUM_PRINT_OPTIONS - if non-zero, print all the Gallium environment + variables which are used, and their current values. +
GALLIUM_NOSSE - if non-zero, do not use SSE runtime code generation for + shader execution +
GALLIUM_NOPPC - if non-zero, do not use PPC runtime code generation for + shader execution +
GALLIUM_DUMP_CPU - if non-zero, print information about the CPU on start-up +
TGSI_PRINT_SANITY - if set, do extra sanity checking on TGSI shaders and + print any errors to stderr. +
DRAW_FSE - ??? +
DRAW_NO_FSE - ??? +
DRAW_USE_LLVM - if set to zero, the draw module will not use LLVM to execute + shaders, vertex fetch, etc. +

+ +

Softpipe driver environment variables

SOFTPIPE_DUMP_FS - if set, the softpipe driver will print fragment shaders + to stderr +
SOFTPIPE_DUMP_GS - if set, the softpipe driver will print geometry shaders + to stderr +
SOFTPIPE_NO_RAST - if set, rasterization is no-op'd. For profiling purposes. +

+ + +

LLVMpipe driver environment variables

LP_NO_RAST - if set LLVMpipe will no-op rasterization +
LP_DEBUG - a comma-separated list of debug options is acceptec. See the + source code for details. +
LP_PERF - a comma-separated list of options to selectively no-op various + parts of the driver. See the source code for details. +
LP_NUM_THREADS - an integer indicating how many threads to use for rendering. + Zero turns of threading completely. The default value is the number of CPU + cores present. +

+ + +

+Other Gallium drivers have their own environment variables. These may change +frequently so the source code should be consulted for details. +

+ + +
+
+ + + + -- cgit v1.2.3