blob: 6d7a321da9fb577c39e87adaea57a314ec2c402b [file] [log] [blame]
Brian Paul0b27ace2003-03-08 17:38:57 +00001<HTML>
2
3<TITLE>Environment Variables</TITLE>
4
Brian Paul36da0452005-01-20 03:55:10 +00005<link rel="stylesheet" type="text/css" href="mesa.css"></head>
6
7<BODY>
Brian Paul0b27ace2003-03-08 17:38:57 +00008
9<H1>Environment Variables</H1>
10
11<p>
12Mesa supports the following environment variables:
13</p>
14<ul>
Brian Paulb07d6a82004-02-02 22:35:55 +000015<li>MESA_NO_ASM - if set, disables all assembly language optimizations
16<li>MESA_NO_MMX - if set, disables Intel MMX optimizations
17<li>MESA_NO_3DNOW - if set, disables AMD 3DNow! optimizations
18<li>MESA_NO_SSE - if set, disables Intel SSE optimizations
Brian Pauleacd3472005-08-19 23:34:10 +000019<li>MESA_DEBUG - if set, error messages are printed to stderr.
20If the value of MESA_DEBUG is "FP" floating point arithmetic errors will
21generate exceptions.
Brian Paulb07d6a82004-02-02 22:35:55 +000022<li>MESA_NO_DITHER - if set, disables dithering, overriding glEnable(GL_DITHER)
Brian Paul4d3ab192006-06-01 20:22:30 +000023<li>MESA_TEX_PROG - if set, implement conventional texture env modes with
24fragment programs (intended for developers only)
25<li>MESA_TNL_PROG - if set, implement conventional vertex transformation
26operations with vertex programs (intended for developers only).
27Setting this variable automatically sets the MESA_TEX_PROG variable as well.
Brian Paulcc26e272009-06-08 10:56:51 -060028<li>MESA_EXTENSION_OVERRIDE - can be used to enable/disable extensions.
29A value such as "GL_EXT_foo -GL_EXT_bar" will enable the GL_EXT_foo extension
30and disable the GL_EXT_bar extension.
Brian Paulb07d6a82004-02-02 22:35:55 +000031</ul>
32
33<p>
Brian Paul5e9d7312006-01-27 20:12:06 +000034The following are only applicable to the Xlib software driver.
Brian Paulb6c41fd2009-01-22 09:58:52 -070035See the <A HREF="xlibdriver.html">Xlib software driver page</A> for details.
Brian Paulb07d6a82004-02-02 22:35:55 +000036</p>
37<ul>
Brian Paul5e9d7312006-01-27 20:12:06 +000038<li>MESA_RGB_VISUAL - specifies the X visual and depth for RGB mode
39<li>MESA_CI_VISUAL - specifies the X visual and depth for CI mode
40<li>MESA_BACK_BUFFER - specifies how to implement the back color buffer,
41 either "pixmap" or "ximage"
42<li>MESA_GAMMA - gamma correction coefficients for red, green, blue channels
43<li>MESA_XSYNC - enable synchronous X behavior (for debugging only)
44<li>MESA_GLX_FORCE_CI - if set, force GLX to treat 8bpp visuals as CI visuals
Brian Paulb07d6a82004-02-02 22:35:55 +000045<li>MESA_GLX_FX - set to either "fullscreen" for full-screen rendering,
46 "window" to render into a window, or "disable" to disable the Glide driver.
Brian Paul4f6b1ad2004-07-23 15:49:12 +000047<li>MESA_GLX_FORCE_ALPHA - if set, forces RGB windows to have an alpha channel.
Brian Pauldfa5c2b2004-07-23 23:32:15 +000048<li>MESA_GLX_DEPTH_BITS - specifies default number of bits for depth buffer.
Brian Paul8894a552005-11-05 03:12:06 +000049<li>MESA_GLX_ALPHA_BITS - specifies default number of bits for alpha channel.
Brian Paul0b27ace2003-03-08 17:38:57 +000050</ul>
51
52
53</BODY>
54</HTML>