IABSD.fr/xenocara/lib/mesa/docs/application-issues.rst

Branch : - branch - master - tag -

• Show log

  Commit

• Author : jsg
  Date : 2025-06-05 11:23:11
  Hash : 67d6f117
  Message : Import Mesa 25.0.7

• lib/mesa/docs/application-issues.rst

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