File: application-issues.rst

package info (click to toggle)
mesa 24.3.4-3
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 279,568 kB
  • sloc: ansic: 2,122,763; xml: 1,010,303; cpp: 513,137; python: 70,351; asm: 38,315; lisp: 20,211; yacc: 12,036; lex: 3,372; sh: 841; makefile: 256
file content (48 lines) | stat: -rw-r--r-- 1,538 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
Application Issues
==================

This page documents known issues with some OpenGL applications.

Topogun
-------

`Topogun <https://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.

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.

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

.. code-block:: sh

   export MESA_EXTENSION_MAX_YEAR=2001

before running the game.

Viewperf
--------

See the :doc:`Viewperf issues <viewperf>` page for a detailed list of
Viewperf issues.