| Andreas Boll | ecd5c7c | 2012-06-12 09:05:03 +0200 | [diff] [blame] | 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> |
| Brian Paul | 0b27ace | 2003-03-08 17:38:57 +0000 | [diff] [blame] | 9 | |
| Andreas Boll | b5da52a | 2012-09-18 18:57:02 +0200 | [diff] [blame] | 10 | <div class="header"> |
| Erik Faye-Lund | ecdab0d | 2019-05-06 13:26:47 +0200 | [diff] [blame] | 11 | The Mesa 3D Graphics Library |
| Andreas Boll | b5da52a | 2012-09-18 18:57:02 +0200 | [diff] [blame] | 12 | </div> |
| 13 | |
| 14 | <iframe src="contents.html"></iframe> |
| 15 | <div class="content"> |
| 16 | |
| Andreas Boll | ecd5c7c | 2012-06-12 09:05:03 +0200 | [diff] [blame] | 17 | <h1>Debugging Tips</h1> |
| Brian Paul | 0b27ace | 2003-03-08 17:38:57 +0000 | [diff] [blame] | 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 |
| Erik Faye-Lund | 392c083 | 2019-05-28 13:14:03 +0200 | [diff] [blame] | 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. |
| Brian Paul | 0b27ace | 2003-03-08 17:38:57 +0000 | [diff] [blame] | 26 | </p> |
| 27 | |
| 28 | <p> |
| Eric Engestrom | 46d6883 | 2019-04-24 13:16:57 +0100 | [diff] [blame] | 29 | More extensive error checking is done in DEBUG builds |
| 30 | (<code>--buildtype debug</code> for meson, <code>build=debug</code> for scons). |
| Brian Paul | 0b27ace | 2003-03-08 17:38:57 +0000 | [diff] [blame] | 31 | </p> |
| 32 | <p> |
| Erik Faye-Lund | 392c083 | 2019-05-28 13:14:03 +0200 | [diff] [blame] | 33 | In your debugger you can set a breakpoint in <code>_mesa_error()</code> to trap |
| 34 | Mesa errors. |
| Brian Paul | 0b27ace | 2003-03-08 17:38:57 +0000 | [diff] [blame] | 35 | </p> |
| 36 | <p> |
| 37 | There is a display list printing/debugging facility. See the end of |
| Erik Faye-Lund | 392c083 | 2019-05-28 13:14:03 +0200 | [diff] [blame] | 38 | <code>src/dlist.c</code> for details. |
| Brian Paul | 0b27ace | 2003-03-08 17:38:57 +0000 | [diff] [blame] | 39 | </p> |
| 40 | |
| Andreas Boll | b5da52a | 2012-09-18 18:57:02 +0200 | [diff] [blame] | 41 | </div> |
| Andreas Boll | ecd5c7c | 2012-06-12 09:05:03 +0200 | [diff] [blame] | 42 | </body> |
| 43 | </html> |