mirror of
https://gitee.com/openharmony/third_party_mesa3d
synced 2024-11-23 23:41:13 +00:00
9be0e2dbf4
This time, let's use proper Sphinx roles for the referenes, so we can reference documents and inline refs. Reviewed-by: Eric Anholt <eric@anholt.net> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/5471>
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 :doc:`Viewperf issues <viewperf>` page for a detailed list of
|
|
Viewperf issues.
|