envvars.html 2.89 KB
Newer Older
1
2
3
4
<HTML>

<TITLE>Environment Variables</TITLE>

Brian Paul's avatar
Brian Paul committed
5
6
7
<link rel="stylesheet" type="text/css" href="mesa.css"></head>

<BODY>
8
9
10
11
12
13
14

<H1>Environment Variables</H1>

<p>
Mesa supports the following environment variables:
</p>
<ul>
Brian Paul's avatar
Brian Paul committed
15
16
17
18
<li>MESA_NO_ASM - if set, disables all assembly language optimizations
<li>MESA_NO_MMX - if set, disables Intel MMX optimizations
<li>MESA_NO_3DNOW - if set, disables AMD 3DNow! optimizations
<li>MESA_NO_SSE - if set, disables Intel SSE optimizations
Brian Paul's avatar
Brian Paul committed
19
20
21
<li>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.
Brian Paul's avatar
Brian Paul committed
22
<li>MESA_NO_DITHER - if set, disables dithering, overriding glEnable(GL_DITHER)
23
24
25
26
27
<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
operations with vertex programs (intended for developers only).
Setting this variable automatically sets the MESA_TEX_PROG variable as well.
28
29
30
<li>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.
31
<li>MESA_GLSL - <a href="shading.html#envvars">shading language options</a>
Brian Paul's avatar
Brian Paul committed
32
33
34
</ul>

<p>
Brian Paul's avatar
Brian Paul committed
35
The following are only applicable to the Xlib software driver.
36
See the <A HREF="xlibdriver.html">Xlib software driver page</A> for details.
Brian Paul's avatar
Brian Paul committed
37
38
</p>
<ul>
Brian Paul's avatar
Brian Paul committed
39
40
41
42
43
44
45
<li>MESA_RGB_VISUAL - specifies the X visual and depth for RGB mode
<li>MESA_CI_VISUAL - specifies the X visual and depth for CI mode
<li>MESA_BACK_BUFFER - specifies how to implement the back color buffer,
    either "pixmap" or "ximage"
<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
Brian Paul's avatar
Brian Paul committed
46
47
<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.
48
<li>MESA_GLX_FORCE_ALPHA - if set, forces RGB windows to have an alpha channel.
Brian Paul's avatar
Brian Paul committed
49
<li>MESA_GLX_DEPTH_BITS - specifies default number of bits for depth buffer.
Brian Paul's avatar
Brian Paul committed
50
<li>MESA_GLX_ALPHA_BITS - specifies default number of bits for alpha channel.
51
52
53
</ul>


54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
<p>
These environment variables are for the Intel i945/i965 drivers:
</p>
<ul>
<li>INTEL_STRICT_CONFORMANCE - if set to 1, enable sw fallbacks to improve
    OpenGL conformance.  If set to 2, always use software rendering.
<li>INTEL_NO_BLIT - if set, disable hardware-accelerated glBitmap,
    glCopyPixels, glDrawPixels.
</ul>


<p>
These environment variables are for the Radeon R300 driver:
</p>
<ul>
<li>R300_NO_TCL - if set, disable hardware-accelerated Transform/Clip/Lighting.
</ul>

72
73
74
75
<p>
Mesa EGL supports different sets of environment variables.  See the
<a href="egl.html">Mesa EGL</a> page for the details.
</p>
76

77
78
</BODY>
</HTML>