[Mesa-dev] [PATCH] docs: add a new page documenting known application issues

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:
>>
>>   docs/apps/index.html
>>   docs/apps/viewperf.html
>>   docs/relnotes/1.2.3.4.5.html
>>   docs/specs/
>>   docs/devel/
>>
>> 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"
>>> "http://www.w3.org/TR/html4/loose.dtd">
>>> +<html lang="en">
>>> +<head>
>>> +<meta http-equiv="content-type" content="text/html; charset=utf-8">
>>> +<title>Application Issues</title>
>>> +<link rel="stylesheet" type="text/css" href="mesa.css">
>>> +</head>
>>> +<body>
>>> +
>>> +<div class="header">
>>> +<h1>The Mesa 3D Graphics Library</h1>
>>> +</div>
>>> +
>>> +<iframe src="contents.html"></iframe>
>>> +<div class="content">
>>> +
>>> +<h1>Application Issues</h1>
>>> +
>>> +<p>
>>> +This page documents known issues with some OpenGL applications.
>>> +</p>
>>> +
>>> +
>>> +<h2>Topogun</h2>
>>> +
>>> +<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>
>>> +
>>> +<p>
>>> +Mesa 9.1.2 and later (will) support a DRI configuration option to work
>>> around
>>> +this issue.
>>> +Using the<a href="http://dri.freedesktop.org/wiki/DriConf">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.
>>> +</p>
>>> +
>>
>> 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.
>
> -Brian

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

--Ken