mirror of
https://gitlab.freedesktop.org/mesa/mesa.git
synced 2024-12-12 03:34:34 +08:00
d6be994ef8
Sphinx can syntax-highlight a block if we use the right syntax. Reviewed-by: Eric Engestrom <eric@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630>
49 lines
1.5 KiB
ReStructuredText
49 lines
1.5 KiB
ReStructuredText
Application Issues
|
|
==================
|
|
|
|
This page documents known issues with some OpenGL applications.
|
|
|
|
Topogun
|
|
-------
|
|
|
|
`Topogun <http://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:: console
|
|
|
|
export MESA_EXTENSION_MAX_YEAR=2001
|
|
|
|
before running the game.
|
|
|
|
Viewperf
|
|
--------
|
|
|
|
See the `Viewperf issues <viewperf.html>`__ page for a detailed list of
|
|
Viewperf issues.
|