Commit 99811c34 authored by Brian Paul's avatar Brian Paul

docs: add a new page documenting known application issues

Let's try to update this when we find other broken applications...
Reviewed-by: Jose Fonseca's avatarJosé Fonseca <>
parent fe30fa9a
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "">
<html lang="en">
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>Application Issues</title>
<link rel="stylesheet" type="text/css" href="mesa.css">
<div class="header">
<h1>The Mesa 3D Graphics Library</h1>
<iframe src="contents.html"></iframe>
<div class="content">
<h1>Application Issues</h1>
This page documents known issues with some OpenGL applications.
<a href="">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.
Mesa 9.1.2 and later (will) support a DRI configuration option to work around
this issue.
Using the <a href="">driconf</a> 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.
<h2>Old OpenGL games</h2>
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
before running the game.
See the <a href="viewperf.html">Viewperf issues</a> page for a detailed list
of Viewperf issues.
......@@ -71,6 +71,7 @@
<li><a href="llvmpipe.html" target="_parent">Gallium llvmpipe driver</a>
<li><a href="vmware-guest.html" target="_parent">VMware SVGA3D guest driver</a>
<li><a href="postprocess.html" target="_parent">Gallium post-processing</a>
<li><a href="application-issues.html" target="_parent">Application Issues</a>
<li><a href="viewperf.html" target="_parent">Viewperf Issues</a>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment