--- docs/application-issues.rst | 90 +- docs/autoconf.rst | 406 ++- docs/bugs.rst | 75 +- docs/codingstyle.rst | 244 +- docs/conform.rst | 1343 +++++----- docs/debugging.rst | 66 +- docs/developers.rst | 63 +- docs/devinfo.rst | 103 +- docs/dispatch.rst | 510 ++-- docs/download.rst | 130 +- docs/egl.rst | 311 +-- docs/envvars.rst | 746 +++--- docs/extensions.rst | 80 +- docs/faq.rst | 614 ++--- docs/helpwanted.rst | 110 +- docs/index.rst | 4365 ++++++++++++++++---------------- docs/install.rst | 335 ++- docs/intro.rst | 609 ++--- docs/license.rst | 163 +- docs/lists.rst | 129 +- docs/llvmpipe.rst | 519 ++-- docs/mangling.rst | 32 +- docs/meson.rst | 301 +-- docs/opengles.rst | 85 +- docs/osmesa.rst | 82 +- docs/perf.rst | 112 +- docs/postprocess.rst | 75 +- docs/precompiled.rst | 35 +- docs/release-calendar.rst | 218 +- docs/releasing.rst | 877 +++---- docs/relnotes.rst | 482 ++-- docs/relnotes/10.0.1.rst | 192 +- docs/relnotes/10.0.2.rst | 211 +- docs/relnotes/10.0.3.rst | 307 ++- docs/relnotes/10.0.4.rst | 331 ++- docs/relnotes/10.0.5.rst | 235 +- docs/relnotes/10.0.rst | 254 +- docs/relnotes/10.1.1.rst | 434 ++-- docs/relnotes/10.1.2.rst | 323 ++- docs/relnotes/10.1.3.rst | 107 +- docs/relnotes/10.1.4.rst | 119 +- docs/relnotes/10.1.5.rst | 124 +- docs/relnotes/10.1.6.rst | 176 +- docs/relnotes/10.1.rst | 90 +- docs/relnotes/10.2.1.rst | 72 +- docs/relnotes/10.2.2.rst | 261 +- docs/relnotes/10.2.3.rst | 158 +- docs/relnotes/10.2.4.rst | 214 +- docs/relnotes/10.2.5.rst | 340 ++- docs/relnotes/10.2.6.rst | 205 +- docs/relnotes/10.2.7.rst | 346 ++- docs/relnotes/10.2.8.rst | 167 +- docs/relnotes/10.2.9.rst | 121 +- docs/relnotes/10.2.rst | 121 +- docs/relnotes/10.3.1.rst | 229 +- docs/relnotes/10.3.2.rst | 147 +- docs/relnotes/10.3.3.rst | 378 ++- docs/relnotes/10.3.4.rst | 132 +- docs/relnotes/10.3.5.rst | 110 +- docs/relnotes/10.3.6.rst | 155 +- docs/relnotes/10.3.7.rst | 118 +- docs/relnotes/10.3.rst | 681 ++--- docs/relnotes/10.4.1.rst | 120 +- docs/relnotes/10.4.2.rst | 161 +- docs/relnotes/10.4.3.rst | 257 +- docs/relnotes/10.4.4.rst | 115 +- docs/relnotes/10.4.5.rst | 146 +- docs/relnotes/10.4.6.rst | 182 +- docs/relnotes/10.4.7.rst | 172 +- docs/relnotes/10.4.rst | 504 ++-- docs/relnotes/10.5.0.rst | 406 +-- docs/relnotes/10.5.1.rst | 379 ++- docs/relnotes/10.5.2.rst | 160 +- docs/relnotes/10.5.3.rst | 162 +- docs/relnotes/10.5.4.rst | 165 +- docs/relnotes/10.5.5.rst | 116 +- docs/relnotes/10.5.6.rst | 187 +- docs/relnotes/10.5.7.rst | 134 +- docs/relnotes/10.5.8.rst | 130 +- docs/relnotes/10.5.9.rst | 194 +- docs/relnotes/10.6.0.rst | 672 ++--- docs/relnotes/10.6.1.rst | 134 +- docs/relnotes/10.6.2.rst | 283 +-- docs/relnotes/10.6.3.rst | 124 +- docs/relnotes/10.6.4.rst | 181 +- docs/relnotes/10.6.5.rst | 153 +- docs/relnotes/10.6.6.rst | 224 +- docs/relnotes/10.6.7.rst | 87 +- docs/relnotes/10.6.8.rst | 162 +- docs/relnotes/10.6.9.rst | 161 +- docs/relnotes/11.0.0.rst | 512 ++-- docs/relnotes/11.0.1.rst | 166 +- docs/relnotes/11.0.2.rst | 104 +- docs/relnotes/11.0.3.rst | 297 +-- docs/relnotes/11.0.4.rst | 256 +- docs/relnotes/11.0.5.rst | 238 +- docs/relnotes/11.0.6.rst | 179 +- docs/relnotes/11.0.7.rst | 252 +- docs/relnotes/11.0.8.rst | 357 ++- docs/relnotes/11.0.9.rst | 160 +- docs/relnotes/11.1.0.rst | 559 +++-- docs/relnotes/11.1.1.rst | 345 ++- docs/relnotes/11.1.2.rst | 271 +- docs/relnotes/11.1.3.rst | 519 ++-- docs/relnotes/11.1.4.rst | 272 +- docs/relnotes/11.2.0.rst | 589 ++--- docs/relnotes/11.2.1.rst | 138 +- docs/relnotes/11.2.2.rst | 317 ++- docs/relnotes/12.0.0.rst | 676 ++--- docs/relnotes/12.0.1.rst | 75 +- docs/relnotes/12.0.2.rst | 763 +++--- docs/relnotes/12.0.3.rst | 82 +- docs/relnotes/12.0.4.rst | 547 ++-- docs/relnotes/12.0.5.rst | 177 +- docs/relnotes/12.0.6.rst | 219 +- docs/relnotes/13.0.0.rst | 617 ++--- docs/relnotes/13.0.1.rst | 323 ++- docs/relnotes/13.0.2.rst | 328 ++- docs/relnotes/13.0.3.rst | 307 ++- docs/relnotes/13.0.4.rst | 379 ++- docs/relnotes/13.0.5.rst | 381 ++- docs/relnotes/13.0.6.rst | 505 ++-- docs/relnotes/17.0.0.rst | 548 +++-- docs/relnotes/17.0.1.rst | 374 ++- docs/relnotes/17.0.2.rst | 286 +-- docs/relnotes/17.0.3.rst | 268 +- docs/relnotes/17.0.4.rst | 208 +- docs/relnotes/17.0.5.rst | 243 +- docs/relnotes/17.0.6.rst | 325 ++- docs/relnotes/17.0.7.rst | 187 +- docs/relnotes/17.1.0.rst | 433 ++-- docs/relnotes/17.1.1.rst | 305 +-- docs/relnotes/17.1.10.rst | 269 +- docs/relnotes/17.1.2.rst | 339 ++- docs/relnotes/17.1.3.rst | 208 +- docs/relnotes/17.1.4.rst | 342 ++- docs/relnotes/17.1.5.rst | 299 +-- docs/relnotes/17.1.6.rst | 396 ++- docs/relnotes/17.1.7.rst | 193 +- docs/relnotes/17.1.8.rst | 138 +- docs/relnotes/17.1.9.rst | 184 +- docs/relnotes/17.2.0.rst | 409 +-- docs/relnotes/17.2.1.rst | 339 ++- docs/relnotes/17.2.2.rst | 328 ++- docs/relnotes/17.2.3.rst | 310 ++- docs/relnotes/17.2.4.rst | 162 +- docs/relnotes/17.2.5.rst | 232 +- docs/relnotes/17.2.6.rst | 330 ++- docs/relnotes/17.2.7.rst | 364 ++- docs/relnotes/17.2.8.rst | 139 +- docs/relnotes/17.3.0.rst | 484 ++-- docs/relnotes/17.3.1.rst | 267 +- docs/relnotes/17.3.2.rst | 132 +- docs/relnotes/17.3.3.rst | 222 +- docs/relnotes/17.3.4.rst | 455 ++-- docs/relnotes/17.3.5.rst | 73 +- docs/relnotes/17.3.6.rst | 101 +- docs/relnotes/17.3.7.rst | 497 ++-- docs/relnotes/17.3.8.rst | 184 +- docs/relnotes/17.3.9.rst | 203 +- docs/relnotes/18.0.0.rst | 657 ++--- docs/relnotes/18.0.1.rst | 335 ++- docs/relnotes/18.0.2.rst | 183 +- docs/relnotes/18.0.3.rst | 120 +- docs/relnotes/18.0.4.rst | 225 +- docs/relnotes/18.1.0.rst | 530 ++-- docs/relnotes/18.2.0.rst | 75 +- docs/relnotes/6.4.1.rst | 119 +- docs/relnotes/6.4.2.rst | 132 +- docs/relnotes/6.4.rst | 164 +- docs/relnotes/6.5.1.rst | 254 +- docs/relnotes/6.5.2.rst | 239 +- docs/relnotes/6.5.3.rst | 209 +- docs/relnotes/6.5.rst | 226 +- docs/relnotes/7.0.1.rst | 188 +- docs/relnotes/7.0.2.rst | 161 +- docs/relnotes/7.0.3.rst | 155 +- docs/relnotes/7.0.4.rst | 144 +- docs/relnotes/7.0.rst | 175 +- docs/relnotes/7.1.rst | 164 +- docs/relnotes/7.10.1.rst | 732 +++--- docs/relnotes/7.10.2.rst | 368 ++- docs/relnotes/7.10.3.rst | 598 ++--- docs/relnotes/7.10.rst | 5747 ++++++++++++++++++++++--------------------- docs/relnotes/7.11.1.rst | 782 +++--- docs/relnotes/7.11.2.rst | 110 +- docs/relnotes/7.11.rst | 716 +++--- docs/relnotes/7.2.rst | 182 +- docs/relnotes/7.3.rst | 160 +- docs/relnotes/7.4.1.rst | 136 +- docs/relnotes/7.4.2.rst | 125 +- docs/relnotes/7.4.3.rst | 135 +- docs/relnotes/7.4.4.rst | 113 +- docs/relnotes/7.4.rst | 155 +- docs/relnotes/7.5.1.rst | 118 +- docs/relnotes/7.5.2.rst | 108 +- docs/relnotes/7.5.rst | 182 +- docs/relnotes/7.6.1.rst | 136 +- docs/relnotes/7.6.rst | 149 +- docs/relnotes/7.7.1.rst | 98 +- docs/relnotes/7.7.rst | 121 +- docs/relnotes/7.8.1.rst | 89 +- docs/relnotes/7.8.2.rst | 252 +- docs/relnotes/7.8.3.rst | 155 +- docs/relnotes/7.8.rst | 118 +- docs/relnotes/7.9.1.rst | 805 +++--- docs/relnotes/7.9.2.rst | 647 +++-- docs/relnotes/7.9.rst | 311 ++- docs/relnotes/8.0.1.rst | 209 +- docs/relnotes/8.0.2.rst | 215 +- docs/relnotes/8.0.3.rst | 540 ++-- docs/relnotes/8.0.4.rst | 370 ++- docs/relnotes/8.0.5.rst | 461 ++-- docs/relnotes/8.0.rst | 137 +- docs/relnotes/9.0.1.rst | 289 +-- docs/relnotes/9.0.2.rst | 522 ++-- docs/relnotes/9.0.3.rst | 453 ++-- docs/relnotes/9.0.rst | 146 +- docs/relnotes/9.1.1.rst | 369 ++- docs/relnotes/9.1.2.rst | 399 ++- docs/relnotes/9.1.3.rst | 413 ++-- docs/relnotes/9.1.4.rst | 547 ++-- docs/relnotes/9.1.5.rst | 185 +- docs/relnotes/9.1.6.rst | 246 +- docs/relnotes/9.1.7.rst | 263 +- docs/relnotes/9.1.rst | 117 +- docs/relnotes/9.2.1.rst | 331 ++- docs/relnotes/9.2.2.rst | 113 +- docs/relnotes/9.2.3.rst | 140 +- docs/relnotes/9.2.4.rst | 131 +- docs/relnotes/9.2.5.rst | 156 +- docs/relnotes/9.2.rst | 426 ++-- docs/repository.rst | 379 ++- docs/shading.rst | 336 ++- docs/sourcedocs.rst | 60 +- docs/sourcetree.rst | 300 ++- docs/submittingpatches.rst | 651 +++-- docs/systems.rst | 116 +- docs/thanks.rst | 192 +- docs/utilities.rst | 54 +- docs/versions.rst | 2967 +++++++++++----------- docs/viewperf.rst | 498 ++-- docs/vmware-guest.rst | 516 ++-- docs/webmaster.rst | 34 +- docs/xlibdriver.rst | 426 ++-- 245 files changed, 37063 insertions(+), 42172 deletions(-)
diff --git a/docs/application-issues.rst b/docs/application-issues.rst index b70d14e3d5..3ab4da4fc9 100644 --- a/docs/application-issues.rst +++ b/docs/application-issues.rst @@ -1,80 +1,48 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> -<html lang="en"><head> - <meta content="text/html; charset=utf-8" http-equiv="content-type"/> - <title>Application Issues</title> - <link href="mesa.css" rel="stylesheet" type="text/css"/> -</head> -<body> +Application Issues +================== - - - - - -<h1>Application Issues</h1> - -<p> This page documents known issues with some OpenGL applications. -</p> - -<h2>Topogun</h2> +Topogun +------- -<p> -<a href="http://www.topogun.com/";>Topogun</a> for Linux (version 2, at least) -creates a GLX visual without requesting a depth buffer. -This causes bad rendering if the OpenGL driver happens to choose a visual -without a depth buffer. -</p> +`Topogun <http://www.topogun.com/>`__ for Linux (version 2, at least) +creates a GLX visual without requesting a depth buffer. This causes bad +rendering if the OpenGL driver happens to choose a visual without a +depth buffer. -<p> -Mesa 9.1.2 and later (will) support a DRI configuration option to work around -this issue. -Using the <a href="https://dri.freedesktop.org/wiki/DriConf";>driconf</a> tool, -set the "Create all visuals with a depth buffer" option before running Topogun. +Mesa 9.1.2 and later (will) support a DRI configuration option to work +around this issue. Using the +`driconf <https://dri.freedesktop.org/wiki/DriConf>`__ tool, set the +"Create all visuals with a depth buffer" option before running Topogun. Then, all GLX visuals will be created with a depth buffer. -</p> +Old OpenGL games +---------------- -<h2>Old OpenGL games</h2> - -<p> Some old OpenGL games (approx. ten years or older) may crash during start-up because of an extension string buffer-overflow problem. -</p> -<p> -The problem is a modern OpenGL driver will return a very long string -for the glGetString(GL_EXTENSIONS) query and if the application -naively copies the string into a fixed-size buffer it can overflow the -buffer and crash the application. -</p> +The problem is a modern OpenGL driver will return a very long string for +the glGetString(GL\_EXTENSIONS) query and if the application naively +copies the string into a fixed-size buffer it can overflow the buffer +and crash the application. -<p> -The work-around is to set the MESA_EXTENSION_MAX_YEAR environment variable -to the approximate release year of the game. -This will cause the glGetString(GL_EXTENSIONS) query to only report extensions -older than the given year. -</p> +The work-around is to set the MESA\_EXTENSION\_MAX\_YEAR environment +variable to the approximate release year of the game. This will cause +the glGetString(GL\_EXTENSIONS) query to only report extensions older +than the given year. -<p> For example, if the game was released in 2001, do -</p><pre>export MESA_EXTENSION_MAX_YEAR=2001 -</pre> -before running the game. -<p></p> - - - -<h2>Viewperf</h2> - -<p> -See the <a href="viewperf.html">Viewperf issues</a> page for a detailed list -of Viewperf issues. -</p> +:: + export MESA_EXTENSION_MAX_YEAR=2001 +before running the game. +Viewperf +-------- -</body></html> \ No newline at end of file +See the `Viewperf issues <viewperf.html>`__ page for a detailed list of +Viewperf issues. diff --git a/docs/autoconf.rst b/docs/autoconf.rst index 11f106256a..007252feb0 100644 --- a/docs/autoconf.rst +++ b/docs/autoconf.rst @@ -1,253 +1,205 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> -<html lang="en"><head> - <meta content="text/html; charset=utf-8" http-equiv="content-type"/> - <title>Compilation and Installation using Autoconf</title> - <link href="mesa.css" rel="stylesheet" type="text/css"/> -</head> -<body> +Compilation and Installation using Autoconf +=========================================== +#. `Basic Usage <#basic>`__ +#. `Driver Options <#driver>`__ + - `Xlib Driver Options <#xlib>`__ + - `DRI Driver Options <#dri>`__ + - `OSMesa Driver Options <#osmesa>`__ +1. Basic Usage +-------------- +The autoconf generated configure script can be used to guess your +platform and change various options for building Mesa. To use the +configure script, type: -<h1>Compilation and Installation using Autoconf</h1> +:: -<ol> -<li><p><a href="#basic">Basic Usage</a></p></li> -<li><p><a href="#driver">Driver Options</a> - </p><ul> - <li><a href="#xlib">Xlib Driver Options</a></li> - <li><a href="#dri">DRI Driver Options</a></li> - <li><a href="#osmesa">OSMesa Driver Options</a></li> - </ul> -</li></ol> + ./configure +To see a short description of all the options, type +``./configure --help``. If you are using a development snapshot and the +configure script does not exist, type ``./autogen.sh`` to generate it +first. If you know the options you want to pass to ``configure``, you +can pass them to ``autogen.sh``. It will run ``configure`` with these +options after it is generated. Once you have run ``configure`` and set +the options to your preference, type: -<h2 id="basic">1. Basic Usage</h2> +:: + + make + +This will produce libGL.so and/or several other libraries depending on +the options you have chosen. Later, if you want to rebuild for a +different configuration run ``make realclean`` before rebuilding. -<p> -The autoconf generated configure script can be used to guess your -platform and change various options for building Mesa. To use the -configure script, type: -</p> - -<pre> ./configure -</pre> - -<p> -To see a short description of all the options, type <code>./configure ---help</code>. If you are using a development snapshot and the configure -script does not exist, type <code>./autogen.sh</code> to generate it -first. If you know the options you want to pass to -<code>configure</code>, you can pass them to <code>autogen.sh</code>. It -will run <code>configure</code> with these options after it is -generated. Once you have run <code>configure</code> and set the options -to your preference, type: -</p> - -<pre> make -</pre> - -<p> -This will produce libGL.so and/or several other libraries depending on the -options you have chosen. Later, if you want to rebuild for a different -configuration run <code>make realclean</code> before rebuilding. -</p> - -<p> Some of the generic autoconf options are used with Mesa: -</p> -<dl> -<dt><code>--prefix=PREFIX</code></dt> -<dd><p>This is the root directory where -files will be installed by <code>make install</code>. The default is -<code>/usr/local</code>.</p> -</dd> - -<dt><code>--exec-prefix=EPREFIX</code></dt> -<dd><p>This is the root directory -where architecture-dependent files will be installed. In Mesa, this is -only used to derive the directory for the libraries. The default is -<code>${prefix}</code>.</p> -</dd> - -<dt><code>--libdir=LIBDIR</code></dt> -<dd><p>This option specifies the directory -where the GL libraries will be installed. The default is -<code>${exec_prefix}/lib</code>. It also serves as the name of the -library staging area in the source tree. For instance, if the option -<code>--libdir=/usr/local/lib64</code> is used, the libraries will be -created in a <code>lib64</code> directory at the top of the Mesa source -tree.</p> -</dd> - -<dt><code>--sysconfdir=DIR</code></dt> -<dd><p>This option specifies the directory where the configuration -files will be installed. The default is <code>${prefix}/etc</code>. -Currently there's only one config file provided when dri drivers are -enabled - it's <code>drirc</code>.</p> -</dd> - -<dt><code>--enable-static, --disable-shared</code></dt> -<dd><p>By default, Mesa -will build shared libraries. Either of these options will force static -libraries to be built. It is not currently possible to build static and -shared libraries in a single pass.</p> -</dd> - -<dt><code>CC, CFLAGS, CXX, CXXFLAGS</code></dt> -<dd><p>These environment variables -control the C and C++ compilers used during the build. By default, -<code>gcc</code> and <code>g++</code> are used and the debug/optimisation -level is left unchanged.</p> -</dd> - -<dt><code>LDFLAGS</code></dt> -<dd><p>An environment variable specifying flags to -pass when linking programs. These should be empty and -<code>PKG_CONFIG_PATH</code> is recommended to be used instead. If needed -it can be used to direct the linker to use libraries in nonstandard -directories. For example, <code>LDFLAGS="-L/usr/X11R6/lib"</code>.</p> -</dd> - -<dt><code>PKG_CONFIG_PATH</code></dt> -<dd><p>The -<code>pkg-config</code> utility is a hard requirement for configuring and -building mesa. It is used to search for external libraries -on the system. This environment variable is used to control the search -path for <code>pkg-config</code>. For instance, setting -<code>PKG_CONFIG_PATH=/usr/X11R6/lib/pkgconfig</code> will search for -package metadata in <code>/usr/X11R6</code> before the standard -directories.</p> -</dd> -</dl> - -<p> -There are also a few general options for altering the Mesa build: -</p> -<dl> -<dt><code>--enable-debug</code></dt> -<dd><p>This option will set the compiler debug/optimisation levels (if the user -hasn't already set them via the CFLAGS/CXXFLAGS) and macros to aid in -debugging the Mesa libraries.</p> -<p>Note that enabling this option can lead to noticeable loss of performance.</p> +``--prefix=PREFIX`` + This is the root directory where files will be installed by + ``make install``. The default is ``/usr/local``. + +``--exec-prefix=EPREFIX`` + This is the root directory where architecture-dependent files will + be installed. In Mesa, this is only used to derive the directory for + the libraries. The default is ``${prefix}``. + +``--libdir=LIBDIR`` + This option specifies the directory where the GL libraries will be + installed. The default is ``${exec_prefix}/lib``. It also serves as + the name of the library staging area in the source tree. For + instance, if the option ``--libdir=/usr/local/lib64`` is used, the + libraries will be created in a ``lib64`` directory at the top of the + Mesa source tree. + +``--sysconfdir=DIR`` + This option specifies the directory where the configuration files + will be installed. The default is ``${prefix}/etc``. Currently + there's only one config file provided when dri drivers are enabled - + it's ``drirc``. + +``--enable-static, --disable-shared`` + By default, Mesa will build shared libraries. Either of these + options will force static libraries to be built. It is not currently + possible to build static and shared libraries in a single pass. + +``CC, CFLAGS, CXX, CXXFLAGS`` + These environment variables control the C and C++ compilers used + during the build. By default, ``gcc`` and ``g++`` are used and the + debug/optimisation level is left unchanged. + +``LDFLAGS`` + An environment variable specifying flags to pass when linking + programs. These should be empty and ``PKG_CONFIG_PATH`` is + recommended to be used instead. If needed it can be used to direct + the linker to use libraries in nonstandard directories. For example, + ``LDFLAGS="-L/usr/X11R6/lib"``. + +``PKG_CONFIG_PATH`` + The ``pkg-config`` utility is a hard requirement for configuring and + building mesa. It is used to search for external libraries on the + system. This environment variable is used to control the search path + for ``pkg-config``. For instance, setting + ``PKG_CONFIG_PATH=/usr/X11R6/lib/pkgconfig`` will search for package + metadata in ``/usr/X11R6`` before the standard directories. -</dd><dt><code>--disable-asm</code></dt> -<dd><p>There are assembly routines -available for a few architectures. These will be used by default if -one of these architectures is detected. This option ensures that -assembly will not be used.</p> -</dd> +There are also a few general options for altering the Mesa build: + +``--enable-debug`` + This option will set the compiler debug/optimisation levels (if the + user hasn't already set them via the CFLAGS/CXXFLAGS) and macros to + aid in debugging the Mesa libraries. -<dt><code>--build=</code></dt> -<dt><code>--host=</code></dt> -<dd><p>By default, the build will compile code for the architecture that -it's running on. In order to build cross-compile Mesa on a x86-64 machine -that is to run on a i686, one would need to set the options to:</p> + Note that enabling this option can lead to noticeable loss of + performance. -<p><code>--build=x86_64-pc-linux-gnu --host=i686-pc-linux-gnu</code></p> +``--disable-asm`` + There are assembly routines available for a few architectures. These + will be used by default if one of these architectures is detected. + This option ensures that assembly will not be used. -Note that these can vary from distribution to distribution. For more -information check with the -<a href="https://www.gnu.org/savannah-checkouts/gnu/autoconf/manual/autoconf-2.69/html_node/Specifying-Target-Triplets.html";> -autoconf manual</a>. -Note that you will need to correctly set <code>PKG_CONFIG_PATH</code> as well. +``--build=`` +``--host=`` + By default, the build will compile code for the architecture that + it's running on. In order to build cross-compile Mesa on a x86-64 + machine that is to run on a i686, one would need to set the options + to: + ``--build=x86_64-pc-linux-gnu --host=i686-pc-linux-gnu`` -<p>In some cases a single compiler is capable of handling both architectures -(multilib) in that case one would need to set the <code>CC,CXX</code> variables -appending the correct machine options. Seek your compiler documentation for -further information - -<a href="https://gcc.gnu.org/onlinedocs/gcc/Submodel-Options.html";> gcc -machine dependent options</a></p> + Note that these can vary from distribution to distribution. For more + information check with the `autoconf + manual <https://www.gnu.org/savannah-checkouts/gnu/autoconf/manual/autoconf-2.69/html_node/Specifying-Target-Triplets.html>`__. + Note that you will need to correctly set ``PKG_CONFIG_PATH`` as + well. -<p>In addition to specifying correct <code>PKG_CONFIG_PATH</code> for the target -architecture, the following should be sufficient to configure multilib Mesa</p> + In some cases a single compiler is capable of handling both + architectures (multilib) in that case one would need to set the + ``CC,CXX`` variables appending the correct machine options. Seek + your compiler documentation for further information - `gcc machine + dependent + options <https://gcc.gnu.org/onlinedocs/gcc/Submodel-Options.html>`__ -<code>./configure CC="gcc -m32" CXX="g++ -m32" --build=x86_64-pc-linux-gnu --host=i686-pc-linux-gnu ...</code> -</dd> -</dl> + In addition to specifying correct ``PKG_CONFIG_PATH`` for the target + architecture, the following should be sufficient to configure + multilib Mesa + ``./configure CC="gcc -m32" CXX="g++ -m32" --build=x86_64-pc-linux-gnu --host=i686-pc-linux-gnu ...`` -<h2 id="driver">2. GL Driver Options</h2> +2. GL Driver Options +-------------------- -<p> There are several different driver modes that Mesa can use. These are -described in more detail in the <a href="install.html">basic -installation instructions</a>. The Mesa driver is controlled through the -configure options <code>--enable-glx</code> and <code>--enable-osmesa</code> -</p> +described in more detail in the `basic installation +instructions <install.html>`__. The Mesa driver is controlled through +the configure options ``--enable-glx`` and ``--enable-osmesa`` + +Xlib +~~~~ -<h3 id="xlib">Xlib</h3><p> It uses Xlib as a software renderer to do all rendering. It corresponds -to the option <code>--enable-glx=xlib</code> or <code>--enable-glx=gallium-xlib</code>. - -</p><h3 id="dri">DRI</h3><p>This mode uses the DRI hardware drivers for -accelerated OpenGL rendering. To enable use <code>--enable-glx=dri ---enable-dri</code>. - -<!-- DRI specific options --> -</p><dl> -<dt><code>--with-dri-driverdir=DIR</code> -</dt><dd><p> This option specifies the -location the DRI drivers will be installed to and the location libGL -will search for DRI drivers. The default is <code>${libdir}/dri</code>. -</p></dd><dt><code>--with-dri-drivers=DRIVER,DRIVER,...</code> -</dt><dd><p> This option -allows a specific set of DRI drivers to be built. For example, -<code>--with-dri-drivers="swrast,i965,radeon,nouveau"</code>. By -default, the drivers will be chosen depending on the target platform. -See the directory <code>src/mesa/drivers/dri</code> in the source tree -for available drivers. Beware that the swrast DRI driver is used by both -libGL and the X.Org xserver GLX module to do software rendering, so you -may run into problems if it is not available. -<!-- This explanation might be totally bogus. Kristian? --> -</p></dd><dt><code>--disable-driglx-direct</code> -</dt><dd><p> Disable direct rendering in -GLX. Normally, direct hardware rendering through the DRI drivers and -indirect software rendering are enabled in GLX. This option disables -direct rendering entirely. It can be useful on architectures where -kernel DRM modules are not available. -</p></dd><dt><code>--enable-glx-tls</code> </dt><dd><p> -Enable Thread Local Storage (TLS) in -GLX. -</p></dd><dt><code>--with-expat=DIR</code> -</dt><dd><p><strong>DEPRECATED</strong>, use <code>PKG_CONFIG_PATH</code> instead.</p> -<p>The DRI-enabled libGL uses expat to -parse the DRI configuration files in <code>${sysconfdir}/drirc</code> and -<code>~/.drirc</code>. This option allows a specific expat installation -to be used. For example, <code>--with-expat=/usr/local</code> will -search for expat headers and libraries in <code>/usr/local/include</code> -and <code>/usr/local/lib</code>, respectively. -</p></dd></dl> - -<h3 id="osmesa">OSMesa </h3><p> No libGL is built in this -mode. Instead, the driver code is built into the Off-Screen Mesa -(OSMesa) library. See the <a href="osmesa.html">Off-Screen Rendering</a> -page for more details. It corresponds to the option -<code>--enable-osmesa</code>. - -<!-- OSMesa specific options --> -</p><dl> -<dt><code>--with-osmesa-bits=BITS</code> -</dt><dd><p> This option allows the size -of the color channel in bits to be specified. By default, an 8-bit -channel will be used, and the driver will be named libOSMesa. Other -options are 16- and 32-bit color channels, which will add the bit size -to the library name. For example, <code>--with-osmesa-bits=16</code> -will create the libOSMesa16 library with a 16-bit color channel. -</p></dd></dl> - - -<h2 id="library">3. Library Options</h2> - -<p> -The configure script provides more fine grained control over the libraries -that will be built. - -</p> - - -</body></html> \ No newline at end of file +to the option ``--enable-glx=xlib`` or ``--enable-glx=gallium-xlib``. + +DRI +~~~ + +This mode uses the DRI hardware drivers for accelerated OpenGL +rendering. To enable use ``--enable-glx=dri --enable-dri``. + +``--with-dri-driverdir=DIR`` + This option specifies the location the DRI drivers will be installed + to and the location libGL will search for DRI drivers. The default + is ``${libdir}/dri``. + +``--with-dri-drivers=DRIVER,DRIVER,...`` + This option allows a specific set of DRI drivers to be built. For + example, ``--with-dri-drivers="swrast,i965,radeon,nouveau"``. By + default, the drivers will be chosen depending on the target + platform. See the directory ``src/mesa/drivers/dri`` in the source + tree for available drivers. Beware that the swrast DRI driver is + used by both libGL and the X.Org xserver GLX module to do software + rendering, so you may run into problems if it is not available. + +``--disable-driglx-direct`` + Disable direct rendering in GLX. Normally, direct hardware rendering + through the DRI drivers and indirect software rendering are enabled + in GLX. This option disables direct rendering entirely. It can be + useful on architectures where kernel DRM modules are not available. + +``--enable-glx-tls`` + Enable Thread Local Storage (TLS) in GLX. + +``--with-expat=DIR`` + **DEPRECATED**, use ``PKG_CONFIG_PATH`` instead. + + The DRI-enabled libGL uses expat to parse the DRI configuration + files in ``${sysconfdir}/drirc`` and ``~/.drirc``. This option + allows a specific expat installation to be used. For example, + ``--with-expat=/usr/local`` will search for expat headers and + libraries in ``/usr/local/include`` and ``/usr/local/lib``, + respectively. + +OSMesa +~~~~~~ + +No libGL is built in this mode. Instead, the driver code is built into +the Off-Screen Mesa (OSMesa) library. See the `Off-Screen +Rendering <osmesa.html>`__ page for more details. It corresponds to the +option ``--enable-osmesa``. + +``--with-osmesa-bits=BITS`` + This option allows the size of the color channel in bits to be + specified. By default, an 8-bit channel will be used, and the driver + will be named libOSMesa. Other options are 16- and 32-bit color + channels, which will add the bit size to the library name. For + example, ``--with-osmesa-bits=16`` will create the libOSMesa16 + library with a 16-bit color channel. + +3. Library Options +------------------ + +The configure script provides more fine grained control over the +libraries that will be built. diff --git a/docs/bugs.rst b/docs/bugs.rst index c3045cd81c..4ac64e8ef3 100644 --- a/docs/bugs.rst +++ b/docs/bugs.rst @@ -1,62 +1,33 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> -<html lang="en"><head> - <meta content="text/html; charset=utf-8" http-equiv="content-type"/> - <title>Mesa Bug Reporting</title> - <link href="mesa.css" rel="stylesheet" type="text/css"/> -</head> -<body> +Bug Database +============ - - - - - -<h1>Bug Database</h1> - -<p> The Mesa bug database is hosted on -<a href="https://freedesktop.org";>freedesktop.org</a>. -The old bug database on SourceForge is no longer used. -</p> +`freedesktop.org <https://freedesktop.org>`__. The old bug database on +SourceForge is no longer used. -<p> -To file a Mesa bug, go to -<a href="https://bugs.freedesktop.org/enter_bug.cgi?product=Mesa";> -Bugzilla on freedesktop.org</a> -</p> +To file a Mesa bug, go to `Bugzilla on +freedesktop.org <https://bugs.freedesktop.org/enter_bug.cgi?product=Mesa>`__ -<p> Please follow these bug reporting guidelines: -</p> -<ul> -<li>Check if a new version of Mesa is available which might have fixed -the problem. -</li><li>Check if your bug is already reported in the database. -</li><li>Monitor your bug report for requests for additional information, etc. -</li><li>Attach the output of running glxinfo or wglinfo. -This will tell us the Mesa version, which device driver you're using, etc. -</li><li>If you're reporting a crash, try to use your debugger (gdb) to get a stack -trace. Also, recompile Mesa in debug mode to get more detailed information. -</li><li>Describe in detail how to reproduce the bug, especially with games -and applications that the Mesa developers might not be familiar with. -</li><li>Provide an <a href="https://github.com/apitrace/apitrace";>apitrace</a> -or simple GLUT-based test program if possible. -</li></ul> +- Check if a new version of Mesa is available which might have fixed + the problem. +- Check if your bug is already reported in the database. +- Monitor your bug report for requests for additional information, etc. +- Attach the output of running glxinfo or wglinfo. This will tell us + the Mesa version, which device driver you're using, etc. +- If you're reporting a crash, try to use your debugger (gdb) to get a + stack trace. Also, recompile Mesa in debug mode to get more detailed + information. +- Describe in detail how to reproduce the bug, especially with games + and applications that the Mesa developers might not be familiar with. +- Provide an `apitrace <https://github.com/apitrace/apitrace>`__ or + simple GLUT-based test program if possible. -<p> Bug reports will automatically be forwarded by bugzilla to the Mesa developer's mailing list. -</p> - -<p> -The easier a bug is to reproduce, the sooner it will be fixed. -Please do everything you can to facilitate quickly fixing bugs. -If your bug report is vague or your test program doesn't compile -easily, the problem may not be fixed very quickly. -</p> - - - -</body></html> \ No newline at end of file +The easier a bug is to reproduce, the sooner it will be fixed. Please do +everything you can to facilitate quickly fixing bugs. If your bug report +is vague or your test program doesn't compile easily, the problem may +not be fixed very quickly. diff --git a/docs/codingstyle.rst b/docs/codingstyle.rst index 3485e1d7f4..026652f0ca 100644 --- a/docs/codingstyle.rst +++ b/docs/codingstyle.rst @@ -1,132 +1,124 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> -<html lang="en"><head> - <meta content="text/html; charset=utf-8" http-equiv="content-type"/> - <title>Coding Style</title> - <link href="mesa.css" rel="stylesheet" type="text/css"/> -</head> -<body> +Coding Style +============ - - - - - -<h1>Coding Style</h1> - -<p> Mesa is over 20 years old and the coding style has evolved over time. -Some old parts use a style that's a bit out of date. +Some old parts use a style that's a bit out of date. Different sections +of mesa can use different coding style as set in the local EditorConfig +(.editorconfig) and/or Emacs (.dir-locals.el) file. Alternatively the +following is applicable. If the guidelines below don't cover something, +try following the format of existing, neighboring code. -Different sections of mesa can use different coding style as set in the local -EditorConfig (.editorconfig) and/or Emacs (.dir-locals.el) file. +Basic formatting guidelines -Alternatively the following is applicable. +- 3-space indentation, no tabs. +- Limit lines to 78 or fewer characters. The idea is to prevent line + wrapping in 80-column editors and terminals. There are exceptions, + such as if you're defining a large, static table of information. +- Opening braces go on the same line as the if/for/while statement. For + example: + + :: + + if (condition) { + foo; + } else { + bar; + } + +- Put a space before/after operators. For example, ``a = b + c;`` and + not ``a=b+c;`` +- This GNU indent command generally does the right thing for + formatting: + + :: + + indent -br -i3 -npcs --no-tabs infile.c -o outfile.c + +- | Use comments wherever you think it would be helpful for other + developers. Several specific cases and style examples follow. Note + that we roughly follow + `Doxygen <https://www.stack.nl/~dimitri/doxygen/>`__ conventions. + | Single-line comments: + + :: + + /* null-out pointer to prevent dangling reference below */ + bufferObj = NULL; + + Or, + + :: + + bufferObj = NULL; /* prevent dangling reference below */ + + Multi-line comment: + + :: + + /* If this is a new buffer object id, or one which was generated but + * never used before, allocate a buffer object now. + */ + + We try to quote the OpenGL specification where prudent: + + :: + + /* Page 38 of the PDF of the OpenGL ES 3.0 spec says: + * + * "An INVALID_OPERATION error is generated for any of the following + * conditions: + * + * * is zero." + * + * Additionally, page 94 of the PDF of the OpenGL 4.5 core spec + * (30.10.2014) also says this, so it's no longer allowed for desktop GL, + * either. + */ + + Function comment example: + + :: + + /** + * Create and initialize a new buffer object. Called via the + * ctx->Driver.CreateObject() driver callback function. + * \param name integer name of the object + * \param type one of GL_FOO, GL_BAR, etc. + * \return pointer to new object or NULL if error + */ + struct gl_object * + _mesa_create_object(GLuint name, GLenum type) + { + /* function body */ + } + +- Put the function return type and qualifiers on one line and the + function name and parameters on the next, as seen above. This makes + it easy to use ``grep ^function_name dir/*`` to find function + definitions. Also, the opening brace goes on the next line by itself + (see above.) +- Function names follow various conventions depending on the type of + function: + + :: + + glFooBar() - a public GL entry point (in glapi_dispatch.c) + _mesa_FooBar() - the internal immediate mode function + save_FooBar() - retained mode (display list) function in dlist.c + foo_bar() - a static (private) function + _mesa_foo_bar() - an internal non-static Mesa function + +- Constants, macros and enum names are ALL\_UPPERCASE, with \_ between + words. +- Mesa usually uses camel case for local variables (Ex: "localVarname") + while gallium typically uses underscores (Ex: "local\_var\_name"). +- Global variables are almost never used because Mesa should be + thread-safe. +- Booleans. Places that are not directly visible to the GL API should + prefer the use of ``bool``, ``true``, and ``false`` over + ``GLboolean``, ``GL_TRUE``, and ``GL_FALSE``. In C code, this may + mean that ``#include <stdbool.h>`` needs to be added. The + ``try_emit_``\ \* methods in src/mesa/program/ir\_to\_mesa.cpp and + src/mesa/state\_tracker/st\_glsl\_to\_tgsi.cpp can serve as examples. -If the guidelines below don't cover something, try following the format of -existing, neighboring code. -</p> -<p> -Basic formatting guidelines -</p> - -<ul> -<li>3-space indentation, no tabs. -</li><li>Limit lines to 78 or fewer characters. The idea is to prevent line -wrapping in 80-column editors and terminals. There are exceptions, such -as if you're defining a large, static table of information. -</li><li>Opening braces go on the same line as the if/for/while statement. -For example: -<pre> if (condition) { - foo; - } else { - bar; - } -</pre> - -</li><li>Put a space before/after operators. For example, <tt>a = b + c;</tt> -and not <tt>a=b+c;</tt> - -</li><li>This GNU indent command generally does the right thing for formatting: -<pre> indent -br -i3 -npcs --no-tabs infile.c -o outfile.c -</pre> - -</li><li>Use comments wherever you think it would be helpful for other developers. -Several specific cases and style examples follow. Note that we roughly -follow <a href="https://www.stack.nl/~dimitri/doxygen/";>Doxygen</a> conventions. -<br/> -<br/> -Single-line comments: -<pre> /* null-out pointer to prevent dangling reference below */ - bufferObj = NULL; -</pre> -Or, -<pre> bufferObj = NULL; /* prevent dangling reference below */ -</pre> -Multi-line comment: -<pre> /* If this is a new buffer object id, or one which was generated but - * never used before, allocate a buffer object now. - */ -</pre> -We try to quote the OpenGL specification where prudent: -<pre> /* Page 38 of the PDF of the OpenGL ES 3.0 spec says: - * - * "An INVALID_OPERATION error is generated for any of the following - * conditions: - * - * * <length> is zero." - * - * Additionally, page 94 of the PDF of the OpenGL 4.5 core spec - * (30.10.2014) also says this, so it's no longer allowed for desktop GL, - * either. - */ -</length></pre> -Function comment example: -<pre> /** - * Create and initialize a new buffer object. Called via the - * ctx->Driver.CreateObject() driver callback function. - * \param name integer name of the object - * \param type one of GL_FOO, GL_BAR, etc. - * \return pointer to new object or NULL if error - */ - struct gl_object * - _mesa_create_object(GLuint name, GLenum type) - { - /* function body */ - } -</pre> - -</li><li>Put the function return type and qualifiers on one line and the function -name and parameters on the next, as seen above. This makes it easy to use -<code>grep ^function_name dir/*</code> to find function definitions. Also, -the opening brace goes on the next line by itself (see above.) - -</li><li>Function names follow various conventions depending on the type of function: -<pre> glFooBar() - a public GL entry point (in glapi_dispatch.c) - _mesa_FooBar() - the internal immediate mode function - save_FooBar() - retained mode (display list) function in dlist.c - foo_bar() - a static (private) function - _mesa_foo_bar() - an internal non-static Mesa function -</pre> - -</li><li>Constants, macros and enum names are ALL_UPPERCASE, with _ between -words. -</li><li>Mesa usually uses camel case for local variables (Ex: "localVarname") -while gallium typically uses underscores (Ex: "local_var_name"). -</li><li>Global variables are almost never used because Mesa should be thread-safe. - -</li><li>Booleans. Places that are not directly visible to the GL API -should prefer the use of <tt>bool</tt>, <tt>true</tt>, and -<tt>false</tt> over <tt>GLboolean</tt>, <tt>GL_TRUE</tt>, and -<tt>GL_FALSE</tt>. In C code, this may mean that -<tt>#include <stdbool.h></tt> needs to be added. The -<tt>try_emit_</tt>* methods in src/mesa/program/ir_to_mesa.cpp and -src/mesa/state_tracker/st_glsl_to_tgsi.cpp can serve as examples. - -</li></ul> -<p></p> - - - - -</body></html> \ No newline at end of file diff --git a/docs/conform.rst b/docs/conform.rst index 84728f9ae2..fad50e68f9 100644 --- a/docs/conform.rst +++ b/docs/conform.rst @@ -1,700 +1,675 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> -<html lang="en"><head> - <meta content="text/html; charset=utf-8" http-equiv="content-type"/> - <title>Conformance</title> - <link href="mesa.css" rel="stylesheet" type="text/css"/> -</head> -<body> - - +Conformance +=========== +The SGI OpenGL conformance tests verify correct operation of OpenGL +implementations. I, Brian Paul, have been given a copy of the tests for +testing Mesa. The tests are not publicly available. +This file has the latest results of testing Mesa with the OpenGL 1.2 +conformance tests. Testing with the preliminary OpenGL 1.3 tests has +also been done. Mesa passes all the 1.3 tests. +The tests were run using the software X11 device driver on 24-bpp and +16-bpp displays. -<h1>Conformance</h1> +Mesa 4.0 and later pass all conformance tests at all path levels. Note +that this says nothing about the conformance of hardware drivers based +upon Mesa. -<p> -The SGI OpenGL conformance tests verify correct operation of OpenGL -implementations. I, Brian Paul, have been given a copy of the tests -for testing Mesa. The tests are not publicly available. -</p> -<p> -This file has the latest results of testing Mesa with the OpenGL 1.2 -conformance tests. Testing with the preliminary OpenGL 1.3 tests has -also been done. Mesa passes all the 1.3 tests. -</p> -<p> -The tests were run using the software X11 device driver on 24-bpp -and 16-bpp displays. -</p> -<p> -Mesa 4.0 and later pass all conformance tests at all path levels. -Note that this says nothing about the conformance of hardware drivers -based upon Mesa. -</p> +:: + COVERAGE TESTS + -------------- -<pre> -COVERAGE TESTS --------------- + Test that all API functions accept the legal parameters and reject + illegal parameters. The result of each test is either pass or fail. -Test that all API functions accept the legal parameters and reject -illegal parameters. The result of each test is either pass or fail. + % covgl + OpenGL Coverage Test. + Version 1.2 -% covgl -OpenGL Coverage Test. -Version 1.2 + covgl passed. -covgl passed. + covgl passed at 1.1 level. -covgl passed at 1.1 level. - -covgl passed at 1.2 level. - -covgl passed for ARB_multitexture. - - -% covglu -OpenGL GLU Coverage Test. -Version 1.3 - -covglu passed. - -covglu passed at 1.1 level. - - -% covglx -OpenGL X Coverage Test. -Version 1.1.1 - -covglx passed. - - -% primtest -v -Open GL Primitives Test. -Version 1.2 - -[lots of output deleted] - -292159 Combinations. -primtest passed. - - - - -GL CONFORMANCE TEST -=================== - -Render test images, read them back, then test for expected results. - - ----------------------------------------------------------------------- -% conform -v 2 - -OpenGL Conformance Test -Version 1.2 - -Setup Report. - Verbose level = 2. - Random number seed = 1. - Path inactive. - -Visual Report. - Display ID = 35. Indirect Rendering. - Double Buffered. - RGBA (5, 6, 5, 0). - Stencil (8). - Depth (16). - Accumulation (16, 16, 16, 16). - -Epsilon Report. - zero error epsilon = 0.000122. - RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. - Depth buffer error epsilon = 0.000137. - Stencil plane error epsilon = 0.00404. - Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. - -Default State test passed. -Must Pass test passed. -Divide By Zero test passed. -Viewport Clamp test passed. -Matrix Stack test passed. -Matrix Stack Mixing test passed. -Vertex Order test passed. -Transformations test passed. -Transformation Normal test passed. -Viewport Transformation test passed. -Buffer Clear test passed. -Buffer Corners test passed. -Buffer Color test passed. -Color Ramp test passed. -Mask test passed. -Buffer Invariance test passed. -Accumulation Buffer test passed. -Select test passed. -Feedback test passed. -Scissor test passed. -Alpha Plane Function test passed. -Stencil Plane Clear test passed. -Stencil Plane Corners test passed. -Stencil Plane Operation test passed. -Stencil Plane Function test passed. -Depth Buffer Clear test passed. -Depth Buffer Function test passed. -Blend test passed. -Dither test passed. -LogicOp Function test does not exist for an RGB visual. -DrawPixels test passed. -CopyPixels test passed. -Bitmap Rasterization test passed. -Point Rasterization test passed. -Anti-aliased Point test passed. -Line Rasterization test passed. -Line Stipple test passed. -Anti-aliased Line test passed. -Horizontal and Vertical Line test passed. -Triangle Rasterization test passed. -Triangle Tile test passed. -Triangle Stipple test passed. -Anti-aliased Triangles test passed. -Quad Rasterization test passed. -Polygon Face test passed. -Polygon Cull test passed. -Polygon Stipple test passed. -Polygon Edge test passed. -Ambient Material test passed. -Ambient Scene test passed. -Attenuation Position test passed. -Diffuse Light test passed. -Diffuse Material test passed. -Diffuse Material Normal test passed. -Diffuse Material Positioning test passed. -Emissive Material test passed. -Specular Exponent test passed. -Specular Exponent Normal test passed. -Specular Local Eye Half Angle test passed. -Specular Light test passed. -Specular Material test passed. -Specular Normal test passed. -Spot Positioning test passed. -Spot Exponent and Positioning test passed. -Spot Exponent and Direction test passed. -Fog Exponential test passed. -Fog Linear test passed. -Texture Decal test passed. -Texture Border test passed. -Mipmaps Selection test passed. -Mipmaps Interpolation test passed. -Display Lists test passed. -Evaluator test passed. -Evaluator Color test passed. -Texture Edge Clamp test passed. -Packed Pixels test passed. -Texture LOD test passed. -Rescale Normal test passed. -Color Table test passed. -Convolution test passed. -Convolution Border test passed. -Histogram test passed. -MinMax test passed. -MultiTexture test passed. - -Conform passed. - ----------------------------------------------------------------------- -% conform -v 2 -p 1 - -OpenGL Conformance Test -Version 1.2 - -Setup Report. - Verbose level = 2. - Random number seed = 1. - Path level = 1. - -Visual Report. - Display ID = 35. Indirect Rendering. - Double Buffered. - RGBA (5, 6, 5, 0). - Stencil (8). - Depth (16). - Accumulation (16, 16, 16, 16). - -Epsilon Report. - zero error epsilon = 0.000122. - RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. - Depth buffer error epsilon = 0.000137. - Stencil plane error epsilon = 0.00404. - Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. - -Default State test passed. -Must Pass test passed. -Divide By Zero test passed. -Viewport Clamp test passed. -Matrix Stack test passed. -Matrix Stack Mixing test passed. -Vertex Order test passed. -Transformations test passed. -Transformation Normal test passed. -Viewport Transformation test passed. -Buffer Clear test passed. -Buffer Corners test passed. -Buffer Color test passed. -Color Ramp test passed. -Mask test passed. -Buffer Invariance test passed. -Accumulation Buffer test passed. -Select test passed. -Feedback test passed. -Scissor test passed. -Alpha Plane Function test passed. -Stencil Plane Clear test passed. -Stencil Plane Corners test passed. -Stencil Plane Operation test passed. -Stencil Plane Function test passed. -Depth Buffer Clear test passed. -Depth Buffer Function test passed. -Blend test passed. -Dither test passed. -LogicOp Function test does not exist for an RGB visual. -DrawPixels test passed. -CopyPixels test passed. -Bitmap Rasterization test passed. -Point Rasterization test passed. -Anti-aliased Point test passed. -Line Rasterization test passed. -Line Stipple test passed. -Anti-aliased Line test passed. -Horizontal and Vertical Line test passed. -Triangle Rasterization test passed. -Triangle Tile test passed. -Triangle Stipple test passed. -Anti-aliased Triangles test passed. -Quad Rasterization test passed. -Polygon Face test passed. -Polygon Cull test passed. -Polygon Stipple test passed. -Polygon Edge test passed. -Ambient Material test passed. -Ambient Scene test passed. -Attenuation Position test passed. -Diffuse Light test passed. -Diffuse Material test passed. -Diffuse Material Normal test passed. -Diffuse Material Positioning test passed. -Emissive Material test passed. -Specular Exponent test passed. -Specular Exponent Normal test passed. -Specular Local Eye Half Angle test passed. -Specular Light test passed. -Specular Material test passed. -Specular Normal test passed. -Spot Positioning test passed. -Spot Exponent and Positioning test passed. -Spot Exponent and Direction test passed. -Fog Exponential test passed. -Fog Linear test passed. -Texture Decal test passed. -Texture Border test passed. -Mipmaps Selection test passed. -Mipmaps Interpolation test passed. -Display Lists test passed. -Evaluator test passed. -Evaluator Color test passed. -Texture Edge Clamp test passed. -Packed Pixels test passed. -Texture LOD test passed. -Rescale Normal test passed. -Color Table test passed. -Convolution test passed. -Convolution Border test passed. -Histogram test passed. -MinMax test passed. -MultiTexture test passed. - -Conform passed. - ----------------------------------------------------------------------- -% conform -v 2 -p 2 - -OpenGL Conformance Test -Version 1.2 - -Setup Report. - Verbose level = 2. - Random number seed = 1. - Path level = 2. - -Visual Report. - Display ID = 35. Indirect Rendering. - Double Buffered. - RGBA (5, 6, 5, 0). - Stencil (8). - Depth (16). - Accumulation (16, 16, 16, 16). - -Epsilon Report. - zero error epsilon = 0.000122. - RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. - Depth buffer error epsilon = 0.000137. - Stencil plane error epsilon = 0.00404. - Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. - -Default State test passed. -Must Pass test passed. -Divide By Zero test passed. -Viewport Clamp test passed. -Matrix Stack test passed. -Matrix Stack Mixing test passed. -Vertex Order test passed. -Transformations test passed. -Transformation Normal test passed. -Viewport Transformation test passed. -Buffer Clear test passed. -Buffer Corners test passed. -Buffer Color test passed. -Color Ramp test passed. -Mask test passed. -Buffer Invariance test passed. -Accumulation Buffer test passed. -Select test passed. -Feedback test passed. -Scissor test passed. -Alpha Plane Function test passed. -Stencil Plane Clear test passed. -Stencil Plane Corners test passed. -Stencil Plane Operation test passed. -Stencil Plane Function test passed. -Depth Buffer Clear test passed. -Depth Buffer Function test passed. -Blend test passed. -Dither test passed. -LogicOp Function test does not exist for an RGB visual. -DrawPixels test passed. -CopyPixels test passed. -Bitmap Rasterization test passed. -Point Rasterization test passed. -Anti-aliased Point test passed. -Line Rasterization test passed. -Line Stipple test passed. -Anti-aliased Line test passed. -Horizontal and Vertical Line test passed. -Triangle Rasterization test passed. -Triangle Tile test passed. -Triangle Stipple test passed. -Anti-aliased Triangles test passed. -Quad Rasterization test passed. -Polygon Face test passed. -Polygon Cull test passed. -Polygon Stipple test passed. -Polygon Edge test passed. -Ambient Material test passed. -Ambient Scene test passed. -Attenuation Position test passed. -Diffuse Light test passed. -Diffuse Material test passed. -Diffuse Material Normal test passed. -Diffuse Material Positioning test passed. -Emissive Material test passed. -Specular Exponent test passed. -Specular Exponent Normal test passed. -Specular Local Eye Half Angle test passed. -Specular Light test passed. -Specular Material test passed. -Specular Normal test passed. -Spot Positioning test passed. -Spot Exponent and Positioning test passed. -Spot Exponent and Direction test passed. -Fog Exponential test passed. -Fog Linear test passed. -Texture Decal test passed. -Texture Border test passed. -Mipmaps Selection test passed. -Mipmaps Interpolation test passed. -Display Lists test passed. -Evaluator test passed. -Evaluator Color test passed. -Texture Edge Clamp test passed. -Packed Pixels test passed. -Texture LOD test passed. -Rescale Normal test passed. -Color Table test passed. -Convolution test passed. -Convolution Border test passed. -Histogram test passed. -MinMax test passed. -MultiTexture test passed. - -Conform passed. - ----------------------------------------------------------------------- -% conform -v 2 -p 3 - -OpenGL Conformance Test -Version 1.2 - -Setup Report. - Verbose level = 2. - Random number seed = 1. - Path level = 3. - -Visual Report. - Display ID = 35. Indirect Rendering. - Double Buffered. - RGBA (5, 6, 5, 0). - Stencil (8). - Depth (16). - Accumulation (16, 16, 16, 16). - -Epsilon Report. - zero error epsilon = 0.000122. - RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. - Depth buffer error epsilon = 0.000137. - Stencil plane error epsilon = 0.00404. - Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. - -Default State test passed. -Must Pass test passed. -Divide By Zero test passed. -Viewport Clamp test passed. -Matrix Stack test passed. -Matrix Stack Mixing test passed. -Vertex Order test passed. -Transformations test passed. -Transformation Normal test passed. -Viewport Transformation test passed. -Buffer Clear test passed. -Buffer Corners test passed. -Buffer Color test passed. -Color Ramp test passed. -Mask test passed. -Buffer Invariance test passed. -Accumulation Buffer test passed. -Select test passed. -Feedback test passed. -Scissor test passed. -Alpha Plane Function test passed. -Stencil Plane Clear test passed. -Stencil Plane Corners test passed. -Stencil Plane Operation test passed. -Stencil Plane Function test passed. -Depth Buffer Clear test passed. -Depth Buffer Function test passed. -Blend test passed. -Dither test passed. -LogicOp Function test does not exist for an RGB visual. -DrawPixels test passed. -CopyPixels test passed. -Bitmap Rasterization test passed. -Point Rasterization test passed. -Anti-aliased Point test passed. -Line Rasterization test passed. -Line Stipple test passed. -Anti-aliased Line test passed. -Horizontal and Vertical Line test passed. -Triangle Rasterization test passed. -Triangle Tile test passed. -Triangle Stipple test passed. -Anti-aliased Triangles test passed. -Quad Rasterization test passed. -Polygon Face test passed. -Polygon Cull test passed. -Polygon Stipple test passed. -Polygon Edge test passed. -Ambient Material test passed. -Ambient Scene test passed. -Attenuation Position test passed. -Diffuse Light test passed. -Diffuse Material test passed. -Diffuse Material Normal test passed. -Diffuse Material Positioning test passed. -Emissive Material test passed. -Specular Exponent test passed. -Specular Exponent Normal test passed. -Specular Local Eye Half Angle test passed. -Specular Light test passed. -Specular Material test passed. -Specular Normal test passed. -Spot Positioning test passed. -Spot Exponent and Positioning test passed. -Spot Exponent and Direction test passed. -Fog Exponential test passed. -Fog Linear test passed. -Texture Decal test passed. -Texture Border test passed. -Mipmaps Selection test passed. -Mipmaps Interpolation test passed. -Display Lists test passed. -Evaluator test passed. -Evaluator Color test passed. -Texture Edge Clamp test passed. -Packed Pixels test passed. -Texture LOD test passed. -Rescale Normal test passed. -Color Table test passed. -Convolution test passed. -Convolution Border test passed. -Histogram test passed. -MinMax test passed. -MultiTexture test passed. - -Conform passed. - ----------------------------------------------------------------------- -% conform -v 2 -p 4 - -OpenGL Conformance Test -Version 1.2 - -Setup Report. - Verbose level = 2. - Random number seed = 1. - Path level = 4. - -Visual Report. - Display ID = 35. Indirect Rendering. - Double Buffered. - RGBA (5, 6, 5, 0). - Stencil (8). - Depth (16). - Accumulation (16, 16, 16, 16). - -Epsilon Report. - zero error epsilon = 0.000122. - RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. - Depth buffer error epsilon = 0.000137. - Stencil plane error epsilon = 0.00404. - Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. - -Default State test passed. -Must Pass test passed. -Divide By Zero test passed. -Viewport Clamp test passed. -Matrix Stack test passed. -Matrix Stack Mixing test passed. -Vertex Order test passed. -Transformations test passed. -Transformation Normal test passed. -Viewport Transformation test passed. -Buffer Clear test passed. -Buffer Corners test passed. -Buffer Color test passed. -Color Ramp test passed. -Mask test passed. -Buffer Invariance test passed. -Accumulation Buffer test passed. -Select test passed. -Feedback test passed. -Scissor test passed. -Alpha Plane Function test passed. -Stencil Plane Clear test passed. -Stencil Plane Corners test passed. -Stencil Plane Operation test passed. -Stencil Plane Function test passed. -Depth Buffer Clear test passed. -Depth Buffer Function test passed. -Blend test passed. -Dither test passed. -LogicOp Function test does not exist for an RGB visual. -DrawPixels test passed. -CopyPixels test passed. -Bitmap Rasterization test passed. -Point Rasterization test passed. -Anti-aliased Point test passed. -Line Rasterization test passed. -Line Stipple test passed. -Anti-aliased Line test passed. -Horizontal and Vertical Line test passed. -Triangle Rasterization test passed. -Triangle Tile test passed. -Triangle Stipple test passed. -Anti-aliased Triangles test passed. -Quad Rasterization test passed. -Polygon Face test passed. -Polygon Cull test passed. -Polygon Stipple test passed. -Polygon Edge test passed. -Ambient Material test passed. -Ambient Scene test passed. -Attenuation Position test passed. -Diffuse Light test passed. -Diffuse Material test passed. -Diffuse Material Normal test passed. -Diffuse Material Positioning test passed. -Emissive Material test passed. -Specular Exponent test passed. -Specular Exponent Normal test passed. -Specular Local Eye Half Angle test passed. -Specular Light test passed. -Specular Material test passed. -Specular Normal test passed. -Spot Positioning test passed. -Spot Exponent and Positioning test passed. -Spot Exponent and Direction test passed. -Fog Exponential test passed. -Fog Linear test passed. -Texture Decal test passed. -Texture Border test passed. -Mipmaps Selection test passed. -Mipmaps Interpolation test passed. -Display Lists test passed. -Evaluator test passed. -Evaluator Color test passed. -Texture Edge Clamp test passed. -Packed Pixels test passed. -Texture LOD test passed. -Rescale Normal test passed. -Color Table test passed. -Convolution test passed. -Convolution Border test passed. -Histogram test passed. -MinMax test passed. -MultiTexture test passed. - -Conform passed. - - - -GLX CONFORMANCE TEST -==================== - -% conformx -v 2 - -OpenGL X Conformance Test -Version 1.1.1 - -Setup Report. - Verbose level = 2. - Random number seed = 1. - Path inactive. - -Visual Report. - Display ID = 34. Direct Rendering. - Double Buffered. - RGBA (8, 8, 8, 0). - Stencil (8). - Depth (16). - Accumulation (16, 16, 16, 16). - -Epsilon Report. - zero error epsilon = 0.000122. - RGBA error epsilon = 0.00404, 0.00404, 0.00404, 0.000122. - Depth buffer error epsilon = 0.000137. - Stencil plane error epsilon = 0.00404. - Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. - -Default State test passed. -glReadPixels() test passed. -Font test passed. - -Conformx passed. - - -</pre> + covgl passed at 1.2 level. -NOTE: conformx passes for all machine path levels (-p option). + covgl passed for ARB_multitexture. + % covglu + OpenGL GLU Coverage Test. + Version 1.3 + covglu passed. + + covglu passed at 1.1 level. + + + % covglx + OpenGL X Coverage Test. + Version 1.1.1 + + covglx passed. + + + % primtest -v + Open GL Primitives Test. + Version 1.2 + + [lots of output deleted] + + 292159 Combinations. + primtest passed. + + + + + GL CONFORMANCE TEST + =================== + + Render test images, read them back, then test for expected results. + + + ---------------------------------------------------------------------- + % conform -v 2 + + OpenGL Conformance Test + Version 1.2 + + Setup Report. + Verbose level = 2. + Random number seed = 1. + Path inactive. + + Visual Report. + Display ID = 35. Indirect Rendering. + Double Buffered. + RGBA (5, 6, 5, 0). + Stencil (8). + Depth (16). + Accumulation (16, 16, 16, 16). + + Epsilon Report. + zero error epsilon = 0.000122. + RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. + Depth buffer error epsilon = 0.000137. + Stencil plane error epsilon = 0.00404. + Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. + + Default State test passed. + Must Pass test passed. + Divide By Zero test passed. + Viewport Clamp test passed. + Matrix Stack test passed. + Matrix Stack Mixing test passed. + Vertex Order test passed. + Transformations test passed. + Transformation Normal test passed. + Viewport Transformation test passed. + Buffer Clear test passed. + Buffer Corners test passed. + Buffer Color test passed. + Color Ramp test passed. + Mask test passed. + Buffer Invariance test passed. + Accumulation Buffer test passed. + Select test passed. + Feedback test passed. + Scissor test passed. + Alpha Plane Function test passed. + Stencil Plane Clear test passed. + Stencil Plane Corners test passed. + Stencil Plane Operation test passed. + Stencil Plane Function test passed. + Depth Buffer Clear test passed. + Depth Buffer Function test passed. + Blend test passed. + Dither test passed. + LogicOp Function test does not exist for an RGB visual. + DrawPixels test passed. + CopyPixels test passed. + Bitmap Rasterization test passed. + Point Rasterization test passed. + Anti-aliased Point test passed. + Line Rasterization test passed. + Line Stipple test passed. + Anti-aliased Line test passed. + Horizontal and Vertical Line test passed. + Triangle Rasterization test passed. + Triangle Tile test passed. + Triangle Stipple test passed. + Anti-aliased Triangles test passed. + Quad Rasterization test passed. + Polygon Face test passed. + Polygon Cull test passed. + Polygon Stipple test passed. + Polygon Edge test passed. + Ambient Material test passed. + Ambient Scene test passed. + Attenuation Position test passed. + Diffuse Light test passed. + Diffuse Material test passed. + Diffuse Material Normal test passed. + Diffuse Material Positioning test passed. + Emissive Material test passed. + Specular Exponent test passed. + Specular Exponent Normal test passed. + Specular Local Eye Half Angle test passed. + Specular Light test passed. + Specular Material test passed. + Specular Normal test passed. + Spot Positioning test passed. + Spot Exponent and Positioning test passed. + Spot Exponent and Direction test passed. + Fog Exponential test passed. + Fog Linear test passed. + Texture Decal test passed. + Texture Border test passed. + Mipmaps Selection test passed. + Mipmaps Interpolation test passed. + Display Lists test passed. + Evaluator test passed. + Evaluator Color test passed. + Texture Edge Clamp test passed. + Packed Pixels test passed. + Texture LOD test passed. + Rescale Normal test passed. + Color Table test passed. + Convolution test passed. + Convolution Border test passed. + Histogram test passed. + MinMax test passed. + MultiTexture test passed. + + Conform passed. + + ---------------------------------------------------------------------- + % conform -v 2 -p 1 + + OpenGL Conformance Test + Version 1.2 + + Setup Report. + Verbose level = 2. + Random number seed = 1. + Path level = 1. + + Visual Report. + Display ID = 35. Indirect Rendering. + Double Buffered. + RGBA (5, 6, 5, 0). + Stencil (8). + Depth (16). + Accumulation (16, 16, 16, 16). + + Epsilon Report. + zero error epsilon = 0.000122. + RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. + Depth buffer error epsilon = 0.000137. + Stencil plane error epsilon = 0.00404. + Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. + + Default State test passed. + Must Pass test passed. + Divide By Zero test passed. + Viewport Clamp test passed. + Matrix Stack test passed. + Matrix Stack Mixing test passed. + Vertex Order test passed. + Transformations test passed. + Transformation Normal test passed. + Viewport Transformation test passed. + Buffer Clear test passed. + Buffer Corners test passed. + Buffer Color test passed. + Color Ramp test passed. + Mask test passed. + Buffer Invariance test passed. + Accumulation Buffer test passed. + Select test passed. + Feedback test passed. + Scissor test passed. + Alpha Plane Function test passed. + Stencil Plane Clear test passed. + Stencil Plane Corners test passed. + Stencil Plane Operation test passed. + Stencil Plane Function test passed. + Depth Buffer Clear test passed. + Depth Buffer Function test passed. + Blend test passed. + Dither test passed. + LogicOp Function test does not exist for an RGB visual. + DrawPixels test passed. + CopyPixels test passed. + Bitmap Rasterization test passed. + Point Rasterization test passed. + Anti-aliased Point test passed. + Line Rasterization test passed. + Line Stipple test passed. + Anti-aliased Line test passed. + Horizontal and Vertical Line test passed. + Triangle Rasterization test passed. + Triangle Tile test passed. + Triangle Stipple test passed. + Anti-aliased Triangles test passed. + Quad Rasterization test passed. + Polygon Face test passed. + Polygon Cull test passed. + Polygon Stipple test passed. + Polygon Edge test passed. + Ambient Material test passed. + Ambient Scene test passed. + Attenuation Position test passed. + Diffuse Light test passed. + Diffuse Material test passed. + Diffuse Material Normal test passed. + Diffuse Material Positioning test passed. + Emissive Material test passed. + Specular Exponent test passed. + Specular Exponent Normal test passed. + Specular Local Eye Half Angle test passed. + Specular Light test passed. + Specular Material test passed. + Specular Normal test passed. + Spot Positioning test passed. + Spot Exponent and Positioning test passed. + Spot Exponent and Direction test passed. + Fog Exponential test passed. + Fog Linear test passed. + Texture Decal test passed. + Texture Border test passed. + Mipmaps Selection test passed. + Mipmaps Interpolation test passed. + Display Lists test passed. + Evaluator test passed. + Evaluator Color test passed. + Texture Edge Clamp test passed. + Packed Pixels test passed. + Texture LOD test passed. + Rescale Normal test passed. + Color Table test passed. + Convolution test passed. + Convolution Border test passed. + Histogram test passed. + MinMax test passed. + MultiTexture test passed. + + Conform passed. + + ---------------------------------------------------------------------- + % conform -v 2 -p 2 + + OpenGL Conformance Test + Version 1.2 + + Setup Report. + Verbose level = 2. + Random number seed = 1. + Path level = 2. + + Visual Report. + Display ID = 35. Indirect Rendering. + Double Buffered. + RGBA (5, 6, 5, 0). + Stencil (8). + Depth (16). + Accumulation (16, 16, 16, 16). + + Epsilon Report. + zero error epsilon = 0.000122. + RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. + Depth buffer error epsilon = 0.000137. + Stencil plane error epsilon = 0.00404. + Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. + + Default State test passed. + Must Pass test passed. + Divide By Zero test passed. + Viewport Clamp test passed. + Matrix Stack test passed. + Matrix Stack Mixing test passed. + Vertex Order test passed. + Transformations test passed. + Transformation Normal test passed. + Viewport Transformation test passed. + Buffer Clear test passed. + Buffer Corners test passed. + Buffer Color test passed. + Color Ramp test passed. + Mask test passed. + Buffer Invariance test passed. + Accumulation Buffer test passed. + Select test passed. + Feedback test passed. + Scissor test passed. + Alpha Plane Function test passed. + Stencil Plane Clear test passed. + Stencil Plane Corners test passed. + Stencil Plane Operation test passed. + Stencil Plane Function test passed. + Depth Buffer Clear test passed. + Depth Buffer Function test passed. + Blend test passed. + Dither test passed. + LogicOp Function test does not exist for an RGB visual. + DrawPixels test passed. + CopyPixels test passed. + Bitmap Rasterization test passed. + Point Rasterization test passed. + Anti-aliased Point test passed. + Line Rasterization test passed. + Line Stipple test passed. + Anti-aliased Line test passed. + Horizontal and Vertical Line test passed. + Triangle Rasterization test passed. + Triangle Tile test passed. + Triangle Stipple test passed. + Anti-aliased Triangles test passed. + Quad Rasterization test passed. + Polygon Face test passed. + Polygon Cull test passed. + Polygon Stipple test passed. + Polygon Edge test passed. + Ambient Material test passed. + Ambient Scene test passed. + Attenuation Position test passed. + Diffuse Light test passed. + Diffuse Material test passed. + Diffuse Material Normal test passed. + Diffuse Material Positioning test passed. + Emissive Material test passed. + Specular Exponent test passed. + Specular Exponent Normal test passed. + Specular Local Eye Half Angle test passed. + Specular Light test passed. + Specular Material test passed. + Specular Normal test passed. + Spot Positioning test passed. + Spot Exponent and Positioning test passed. + Spot Exponent and Direction test passed. + Fog Exponential test passed. + Fog Linear test passed. + Texture Decal test passed. + Texture Border test passed. + Mipmaps Selection test passed. + Mipmaps Interpolation test passed. + Display Lists test passed. + Evaluator test passed. + Evaluator Color test passed. + Texture Edge Clamp test passed. + Packed Pixels test passed. + Texture LOD test passed. + Rescale Normal test passed. + Color Table test passed. + Convolution test passed. + Convolution Border test passed. + Histogram test passed. + MinMax test passed. + MultiTexture test passed. + + Conform passed. + + ---------------------------------------------------------------------- + % conform -v 2 -p 3 + + OpenGL Conformance Test + Version 1.2 + + Setup Report. + Verbose level = 2. + Random number seed = 1. + Path level = 3. + + Visual Report. + Display ID = 35. Indirect Rendering. + Double Buffered. + RGBA (5, 6, 5, 0). + Stencil (8). + Depth (16). + Accumulation (16, 16, 16, 16). + + Epsilon Report. + zero error epsilon = 0.000122. + RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. + Depth buffer error epsilon = 0.000137. + Stencil plane error epsilon = 0.00404. + Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. + + Default State test passed. + Must Pass test passed. + Divide By Zero test passed. + Viewport Clamp test passed. + Matrix Stack test passed. + Matrix Stack Mixing test passed. + Vertex Order test passed. + Transformations test passed. + Transformation Normal test passed. + Viewport Transformation test passed. + Buffer Clear test passed. + Buffer Corners test passed. + Buffer Color test passed. + Color Ramp test passed. + Mask test passed. + Buffer Invariance test passed. + Accumulation Buffer test passed. + Select test passed. + Feedback test passed. + Scissor test passed. + Alpha Plane Function test passed. + Stencil Plane Clear test passed. + Stencil Plane Corners test passed. + Stencil Plane Operation test passed. + Stencil Plane Function test passed. + Depth Buffer Clear test passed. + Depth Buffer Function test passed. + Blend test passed. + Dither test passed. + LogicOp Function test does not exist for an RGB visual. + DrawPixels test passed. + CopyPixels test passed. + Bitmap Rasterization test passed. + Point Rasterization test passed. + Anti-aliased Point test passed. + Line Rasterization test passed. + Line Stipple test passed. + Anti-aliased Line test passed. + Horizontal and Vertical Line test passed. + Triangle Rasterization test passed. + Triangle Tile test passed. + Triangle Stipple test passed. + Anti-aliased Triangles test passed. + Quad Rasterization test passed. + Polygon Face test passed. + Polygon Cull test passed. + Polygon Stipple test passed. + Polygon Edge test passed. + Ambient Material test passed. + Ambient Scene test passed. + Attenuation Position test passed. + Diffuse Light test passed. + Diffuse Material test passed. + Diffuse Material Normal test passed. + Diffuse Material Positioning test passed. + Emissive Material test passed. + Specular Exponent test passed. + Specular Exponent Normal test passed. + Specular Local Eye Half Angle test passed. + Specular Light test passed. + Specular Material test passed. + Specular Normal test passed. + Spot Positioning test passed. + Spot Exponent and Positioning test passed. + Spot Exponent and Direction test passed. + Fog Exponential test passed. + Fog Linear test passed. + Texture Decal test passed. + Texture Border test passed. + Mipmaps Selection test passed. + Mipmaps Interpolation test passed. + Display Lists test passed. + Evaluator test passed. + Evaluator Color test passed. + Texture Edge Clamp test passed. + Packed Pixels test passed. + Texture LOD test passed. + Rescale Normal test passed. + Color Table test passed. + Convolution test passed. + Convolution Border test passed. + Histogram test passed. + MinMax test passed. + MultiTexture test passed. + + Conform passed. + + ---------------------------------------------------------------------- + % conform -v 2 -p 4 + + OpenGL Conformance Test + Version 1.2 + + Setup Report. + Verbose level = 2. + Random number seed = 1. + Path level = 4. + + Visual Report. + Display ID = 35. Indirect Rendering. + Double Buffered. + RGBA (5, 6, 5, 0). + Stencil (8). + Depth (16). + Accumulation (16, 16, 16, 16). + + Epsilon Report. + zero error epsilon = 0.000122. + RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. + Depth buffer error epsilon = 0.000137. + Stencil plane error epsilon = 0.00404. + Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. + + Default State test passed. + Must Pass test passed. + Divide By Zero test passed. + Viewport Clamp test passed. + Matrix Stack test passed. + Matrix Stack Mixing test passed. + Vertex Order test passed. + Transformations test passed. + Transformation Normal test passed. + Viewport Transformation test passed. + Buffer Clear test passed. + Buffer Corners test passed. + Buffer Color test passed. + Color Ramp test passed. + Mask test passed. + Buffer Invariance test passed. + Accumulation Buffer test passed. + Select test passed. + Feedback test passed. + Scissor test passed. + Alpha Plane Function test passed. + Stencil Plane Clear test passed. + Stencil Plane Corners test passed. + Stencil Plane Operation test passed. + Stencil Plane Function test passed. + Depth Buffer Clear test passed. + Depth Buffer Function test passed. + Blend test passed. + Dither test passed. + LogicOp Function test does not exist for an RGB visual. + DrawPixels test passed. + CopyPixels test passed. + Bitmap Rasterization test passed. + Point Rasterization test passed. + Anti-aliased Point test passed. + Line Rasterization test passed. + Line Stipple test passed. + Anti-aliased Line test passed. + Horizontal and Vertical Line test passed. + Triangle Rasterization test passed. + Triangle Tile test passed. + Triangle Stipple test passed. + Anti-aliased Triangles test passed. + Quad Rasterization test passed. + Polygon Face test passed. + Polygon Cull test passed. + Polygon Stipple test passed. + Polygon Edge test passed. + Ambient Material test passed. + Ambient Scene test passed. + Attenuation Position test passed. + Diffuse Light test passed. + Diffuse Material test passed. + Diffuse Material Normal test passed. + Diffuse Material Positioning test passed. + Emissive Material test passed. + Specular Exponent test passed. + Specular Exponent Normal test passed. + Specular Local Eye Half Angle test passed. + Specular Light test passed. + Specular Material test passed. + Specular Normal test passed. + Spot Positioning test passed. + Spot Exponent and Positioning test passed. + Spot Exponent and Direction test passed. + Fog Exponential test passed. + Fog Linear test passed. + Texture Decal test passed. + Texture Border test passed. + Mipmaps Selection test passed. + Mipmaps Interpolation test passed. + Display Lists test passed. + Evaluator test passed. + Evaluator Color test passed. + Texture Edge Clamp test passed. + Packed Pixels test passed. + Texture LOD test passed. + Rescale Normal test passed. + Color Table test passed. + Convolution test passed. + Convolution Border test passed. + Histogram test passed. + MinMax test passed. + MultiTexture test passed. + + Conform passed. + + + + GLX CONFORMANCE TEST + ==================== + + % conformx -v 2 + + OpenGL X Conformance Test + Version 1.1.1 + + Setup Report. + Verbose level = 2. + Random number seed = 1. + Path inactive. + + Visual Report. + Display ID = 34. Direct Rendering. + Double Buffered. + RGBA (8, 8, 8, 0). + Stencil (8). + Depth (16). + Accumulation (16, 16, 16, 16). + + Epsilon Report. + zero error epsilon = 0.000122. + RGBA error epsilon = 0.00404, 0.00404, 0.00404, 0.000122. + Depth buffer error epsilon = 0.000137. + Stencil plane error epsilon = 0.00404. + Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. + + Default State test passed. + glReadPixels() test passed. + Font test passed. + + Conformx passed. -</body></html> \ No newline at end of file +NOTE: conformx passes for all machine path levels (-p option). diff --git a/docs/debugging.rst b/docs/debugging.rst index ca5f8e6c2b..e70a70fa6b 100644 --- a/docs/debugging.rst +++ b/docs/debugging.rst @@ -1,45 +1,21 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> -<html lang="en"><head> - <meta content="text/html; charset=utf-8" http-equiv="content-type"/> - <title>Debugging Tips</title> - <link href="mesa.css" rel="stylesheet" type="text/css"/> -</head> -<body> - - - - - - -<h1>Debugging Tips</h1> - -<p> - Normally Mesa (and OpenGL) records but does not notify the user of - errors. It is up to the application to call - <code>glGetError</code> to check for errors. Mesa supports an - environment variable, MESA_DEBUG, to help with debugging. If - MESA_DEBUG is defined, a message will be printed to stdout whenever - an error occurs. -</p> - -<p> - More extensive error checking is done when Mesa is compiled with the - DEBUG symbol defined. You'll have to edit the Make-config file and - add -DDEBUG to the CFLAGS line for your system configuration. You may - also want to replace any optimization flags with the -g flag so you can - use your debugger. After you've edited Make-config type 'make clean' - before recompiling. -</p> -<p> - In your debugger you can set a breakpoint in _mesa_error() to trap Mesa - errors. -</p> -<p> - There is a display list printing/debugging facility. See the end of - src/dlist.c for details. -</p> - - - - -</body></html> \ No newline at end of file +Debugging Tips +============== + +Normally Mesa (and OpenGL) records but does not notify the user of +errors. It is up to the application to call ``glGetError`` to check for +errors. Mesa supports an environment variable, MESA\_DEBUG, to help with +debugging. If MESA\_DEBUG is defined, a message will be printed to +stdout whenever an error occurs. + +More extensive error checking is done when Mesa is compiled with the +DEBUG symbol defined. You'll have to edit the Make-config file and add +-DDEBUG to the CFLAGS line for your system configuration. You may also +want to replace any optimization flags with the -g flag so you can use +your debugger. After you've edited Make-config type 'make clean' before +recompiling. + +In your debugger you can set a breakpoint in \_mesa\_error() to trap +Mesa errors. + +There is a display list printing/debugging facility. See the end of +src/dlist.c for details. -- Truncated -- please see branch -- _______________________________________________ mesa-dev mailing list mesa-dev@lists.freedesktop.org https://lists.freedesktop.org/mailman/listinfo/mesa-dev
