From 99811c344b830c2aa7910a6723be7e7ef0e8b327 Mon Sep 17 00:00:00 2001 From: Brian Paul Date: Mon, 25 Mar 2013 13:15:37 -0600 Subject: docs: add a new page documenting known application issues MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Let's try to update this when we find other broken applications... Reviewed-by: José Fonseca --- docs/application-issues.html | 83 ++++++++++++++++++++++++++++++++++++++++++++ docs/contents.html | 1 + 2 files changed, 84 insertions(+) create mode 100644 docs/application-issues.html diff --git a/docs/application-issues.html b/docs/application-issues.html new file mode 100644 index 00000000000..6db08658549 --- /dev/null +++ b/docs/application-issues.html @@ -0,0 +1,83 @@ + + + + + Application Issues + + + + +
+

The Mesa 3D Graphics Library

+
+ + +
+ +

Application Issues

+ +

+This page documents known issues with some OpenGL applications. +

+ + +

Topogun

+ +

+Topogun 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. +

+ +

+Mesa 9.1.2 and later (will) support a DRI configuration option to work around +this issue. +Using the 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. +

+ + +

Old OpenGL games

+ +

+Some old OpenGL games (approx. ten years or older) may crash during +start-up because of an extension string buffer-overflow problem. +

+ +

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

+ +

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

+ +

+For example, if the game was released in 2001, do +

+export MESA_EXTENSION_MAX_YEAR=2001
+
+before running the game. +

+ + + +

Viewperf

+ +

+See the Viewperf issues page for a detailed list +of Viewperf issues. +

+ + +
+ + diff --git a/docs/contents.html b/docs/contents.html index 57522992c48..50c0d591360 100644 --- a/docs/contents.html +++ b/docs/contents.html @@ -71,6 +71,7 @@
  • Gallium llvmpipe driver
  • VMware SVGA3D guest driver
  • Gallium post-processing +
  • Application Issues
  • Viewperf Issues -- cgit v1.2.3