docs/debugging.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <html lang="en">
   3 <head>
   4   <meta http-equiv="content-type" content="text/html; charset=utf-8">
   5   <title>Debugging Tips</title>
   6   <link rel="stylesheet" type="text/css" href="mesa.css">
   7 </head>
   8 <body>
   9
  10 <div class="header">
  11   The Mesa 3D Graphics Library
  12 </div>
  13
  14 <iframe src="contents.html"></iframe>
  15 <div class="content">
  16
  17 <h1>Debugging Tips</h1>
  18
  19 <p>
  20    Normally Mesa (and OpenGL) records but does not notify the user of
  21    errors.  It is up to the application to call
  22    <code>glGetError</code> to check for errors.  Mesa supports an
  23    environment variable, <code>MESA_DEBUG</code>, to help with debugging.  If
  24    <code>MESA_DEBUG</code> is defined, a message will be printed to stdout
  25    whenever an error occurs.
  26 </p>
  27
  28 <p>
  29    More extensive error checking is done in DEBUG builds
  30    (<code>--buildtype debug</code> for meson, <code>build=debug</code> for scons).
  31 </p>
  32 <p>
  33    In your debugger you can set a breakpoint in <code>_mesa_error()</code> to trap
  34    Mesa errors.
  35 </p>
  36 <p>
  37    There is a display list printing/debugging facility.  See the end of
  38    <code>src/dlist.c</code> for details.
  39 </p>
  40
  41 </div>
  42 </body>
  43 </html>