diff options
| author | Jonathan Gray <jsg@cvs.openbsd.org> | 2013-09-05 14:07:04 +0000 |
|---|---|---|
| committer | Jonathan Gray <jsg@cvs.openbsd.org> | 2013-09-05 14:07:04 +0000 |
| commit | 821893da535a9c114e427454fe97ee8db13dafbd (patch) | |
| tree | 5fac22b58520a25347ff8fada5894ca5c8a9b10c /dist/Mesa/docs/envvars.html | |
| parent | d0da870fb1db8146fc38e88a1f9b10c37890c46c (diff) | |
Merge Mesa 9.2.0
Diffstat (limited to 'dist/Mesa/docs/envvars.html')
| -rw-r--r-- | dist/Mesa/docs/envvars.html | 96 |
1 files changed, 71 insertions, 25 deletions
diff --git a/dist/Mesa/docs/envvars.html b/dist/Mesa/docs/envvars.html index 986d2f8eb..67d8e292b 100644 --- a/dist/Mesa/docs/envvars.html +++ b/dist/Mesa/docs/envvars.html @@ -1,12 +1,20 @@ -<HTML> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html lang="en"> +<head> + <meta http-equiv="content-type" content="text/html; charset=utf-8"> + <title>Environment Variables</title> + <link rel="stylesheet" type="text/css" href="mesa.css"> +</head> +<body> -<TITLE>Environment Variables</TITLE> +<div class="header"> + <h1>The Mesa 3D Graphics Library</h1> +</div> -<link rel="stylesheet" type="text/css" href="mesa.css"></head> +<iframe src="contents.html"></iframe> +<div class="content"> -<BODY> - -<H1>Environment Variables</H1> +<h1>Environment Variables</h1> <p> Normally, no environment variables need to be set. Most of the environment @@ -15,7 +23,7 @@ sometimes be useful for debugging end-user issues. </p> -<H2>LibGL environment variables</H2> +<h2>LibGL environment variables</h2> <ul> <li>LIBGL_DEBUG - If defined debug information will be printed to stderr. @@ -24,11 +32,13 @@ sometimes be useful for debugging end-user issues. <li>LIBGL_ALWAYS_INDIRECT - forces an indirect rendering context/connection. <li>LIBGL_ALWAYS_SOFTWARE - if set, always use software rendering <li>LIBGL_NO_DRAWARRAYS - if set do not use DrawArrays GLX protocol (for debugging) +<li>LIBGL_SHOW_FPS - print framerate to stdout based on the number of glXSwapBuffers + calls per second. </ul> -<H2>Core Mesa environment variables</H2> +<h2>Core Mesa environment variables</h2> <ul> <li>MESA_NO_ASM - if set, disables all assembly language optimizations @@ -41,6 +51,8 @@ sometimes be useful for debugging end-user issues. printed to stderr.<br> If the value of MESA_DEBUG is 'FP' floating point arithmetic errors will generate exceptions. +<li>MESA_LOG_FILE - specifies a file name for logging all errors, warnings, +etc., rather than stderr <li>MESA_TEX_PROG - if set, implement conventional texture env modes with fragment programs (intended for developers only) <li>MESA_TNL_PROG - if set, implement conventional vertex transformation @@ -58,15 +70,39 @@ copied into a fixed-size buffer without truncating. If the extension string is too long, the buffer overrun can cause the game to crash. This is a work-around for that. +<li>MESA_GL_VERSION_OVERRIDE - changes the value returned by +glGetString(GL_VERSION) and possibly the GL API type. +<ul> +<li> The format should be MAJOR.MINOR[FC] +<li> FC is an optional suffix that indicates a forward compatible context. +This is only valid for versions >= 3.0. +<li> GL versions < 3.0 are set to a compatibility (non-Core) profile +<li> GL versions = 3.0, see below +<li> GL versions > 3.0 are set to a Core profile +<li> Examples: 2.1, 3.0, 3.0FC, 3.1, 3.1FC +<ul> +<li> 2.1 - select a compatibility (non-Core) profile with GL version 2.1 +<li> 3.0 - select a compatibility (non-Core) profile with GL version 3.0 +<li> 3.0FC - select a Core+Forward Compatible profile with GL version 3.0 +<li> 3.1 - select a Core profile with GL version 3.1 +<li> 3.1FC - select a Core+Forward Compatible profile with GL version 3.1 +</ul> +<li> Mesa may not really implement all the features of the given version. +(for developers only) +</ul> +<li>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) <li>MESA_GLSL - <a href="shading.html#envvars">shading language compiler options</a> </ul> -<H2>Mesa Xlib driver environment variables</H2> +<h2>Mesa Xlib driver environment variables</h2> <p> The following are only applicable to the Mesa Xlib software driver. -See the <A HREF="xlibdriver.html">Xlib software driver page</A> for details. +See the <a href="xlibdriver.html">Xlib software driver page</a> for details. </p> <ul> <li>MESA_RGB_VISUAL - specifies the X visual and depth for RGB mode @@ -76,8 +112,6 @@ See the <A HREF="xlibdriver.html">Xlib software driver page</A> for details. <li>MESA_GAMMA - gamma correction coefficients for red, green, blue channels <li>MESA_XSYNC - enable synchronous X behavior (for debugging only) <li>MESA_GLX_FORCE_CI - if set, force GLX to treat 8bpp visuals as CI visuals -<li>MESA_GLX_FX - set to either "fullscreen" for full-screen rendering, - "window" to render into a window, or "disable" to disable the Glide driver. <li>MESA_GLX_FORCE_ALPHA - if set, forces RGB windows to have an alpha channel. <li>MESA_GLX_DEPTH_BITS - specifies default number of bits for depth buffer. <li>MESA_GLX_ALPHA_BITS - specifies default number of bits for alpha channel. @@ -94,10 +128,10 @@ See the <A HREF="xlibdriver.html">Xlib software driver page</A> for details. </ul> -<h2>Radeon R300 driver environment variables (non-Gallium)</h2> +<h2>Radeon driver environment variables (radeon, r200, and r300g)</h2> <ul> -<li>R300_NO_TCL - if set, disable hardware-accelerated Transform/Clip/Lighting. +<li>RADEON_NO_TCL - if set, disable hardware-accelerated Transform/Clip/Lighting. </ul> @@ -112,12 +146,13 @@ Mesa EGL supports different sets of environment variables. See the <h2>Gallium environment variables</h2> <ul> +<li>GALLIUM_HUD - draws various information on the screen, like framerate, + cpu load, driver statistics, performance counters, etc. + Set GALLIUM_HUD=help and run e.g. glxgears for more info. +<li>GALLIUM_LOG_FILE - specifies a file for logging all errors, warnings, etc. + rather than stderr. <li>GALLIUM_PRINT_OPTIONS - if non-zero, print all the Gallium environment variables which are used, and their current values. -<li>GALLIUM_NOSSE - if non-zero, do not use SSE runtime code generation for - shader execution -<li>GALLIUM_NOPPC - if non-zero, do not use PPC runtime code generation for - shader execution <li>GALLIUM_DUMP_CPU - if non-zero, print information about the CPU on start-up <li>TGSI_PRINT_SANITY - if set, do extra sanity checking on TGSI shaders and print any errors to stderr. @@ -125,6 +160,9 @@ Mesa EGL supports different sets of environment variables. See the <LI>DRAW_NO_FSE - ??? <li>DRAW_USE_LLVM - if set to zero, the draw module will not use LLVM to execute shaders, vertex fetch, etc. +<li>ST_DEBUG - controls debug output from the Mesa/Gallium state tracker. +Setting to "tgsi", for example, will print all the TGSI shaders. +See src/mesa/state_tracker/st_debug.c for other options. </ul> <h3>Softpipe driver environment variables</h3> @@ -134,6 +172,8 @@ Mesa EGL supports different sets of environment variables. See the <li>SOFTPIPE_DUMP_GS - if set, the softpipe driver will print geometry shaders to stderr <li>SOFTPIPE_NO_RAST - if set, rasterization is no-op'd. For profiling purposes. +<li>SOFTPIPE_USE_LLVM - if set, the softpipe driver will try to use LLVM JIT for + vertex shading procesing. </ul> @@ -149,16 +189,22 @@ Mesa EGL supports different sets of environment variables. See the cores present. </ul> +<h3>VMware SVGA driver environment variables</h3> +<ul> +<li>SVGA_FORCE_SWTNL - force use of software vertex transformation +<li>SVGA_NO_SWTNL - don't allow software vertex transformation fallbacks +(will often result in incorrect rendering). +<li>SVGA_DEBUG - for dumping shaders, constant buffers, etc. See the code +for details. +<li>See the driver code for other, lesser-used variables. +</ul> + <p> Other Gallium drivers have their own environment variables. These may change frequently so the source code should be consulted for details. </p> - -<br> -<br> - - -</BODY> -</HTML> +</div> +</body> +</html> |