[Mesa-dev] [PATCH] docs: add a new page documenting known application issues
kenneth at whitecape.org
Fri Mar 29 11:49:09 PDT 2013
On 03/29/2013 07:30 AM, Brian Paul wrote:
> On 03/29/2013 04:50 AM, Jose Fonseca wrote:
>> Looks good to me Brian.
>> Just a couple of comments.
>> ----- Original Message -----
>>> Let's try to update this when we find other broken applications...
>> docs/ is growing a lot of stuff, with disparate target audiences.
>> Maybe we could establish some sort of directory hierachary there:
>> So that target readers can more easily find stuff that's most relevant
>> for them.
> Yeah, we could do that, but it would also involve updating a bunch of
> links in the documents too. Someday.
>>> docs/application-issues.html | 83
>>> docs/contents.html | 1 +
>>> 2 files changed, 84 insertions(+), 0 deletions(-)
>>> create mode 100644 docs/application-issues.html
>>> diff --git a/docs/application-issues.html b/docs/application-issues.html
>>> new file mode 100644
>>> index 0000000..6db0865
>>> --- /dev/null
>>> +++ b/docs/application-issues.html
>>> @@ -0,0 +1,83 @@
>>> +<!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="http://www.topogun.com/">Topogun</a> for Linux (version 2, at
>>> +creates a GLX visual without requesting a depth buffer.
>>> +This causes bad rendering if the OpenGL driver happens to choose a
>>> +without a depth buffer.
>>> +Mesa 9.1.2 and later (will) support a DRI configuration option to work
>>> +this issue.
>>> +Using the<a href="http://dri.freedesktop.org/wiki/DriConf">driconf</a>
>>> +set the "Create all visuals with a depth buffer" option before running
>>> +Then, all GLX visuals will be created with a depth buffer.
>> BTW, do users need to manually configure this, or will it be
>> automatically set based on process name?
> Manually. Though the DRI conf tool can be used to set it
> per-application, I believe.
We actually ship a default drirc already in
src/mesa/drivers/common/drirc, which we expect will get installed by
distro packages. You might want to add the workaround for Topogun there
so it happens automatically...
More information about the mesa-dev