Brian Paul | 0b27ace | 2003-03-08 17:38:57 +0000 | [diff] [blame] | 1 | <HTML> |
| 2 | |
| 3 | <TITLE>Debugging Tips</TITLE> |
| 4 | |
Brian Paul | 36da045 | 2005-01-20 03:55:10 +0000 | [diff] [blame] | 5 | <link rel="stylesheet" type="text/css" href="mesa.css"></head> |
| 6 | |
| 7 | <BODY> |
Brian Paul | 0b27ace | 2003-03-08 17:38:57 +0000 | [diff] [blame] | 8 | |
| 9 | <H1>Debugging Tips</H1> |
| 10 | |
| 11 | <p> |
| 12 | Normally Mesa (and OpenGL) records but does not notify the user of |
| 13 | errors. It is up to the application to call |
| 14 | <code>glGetError</code> to check for errors. Mesa supports an |
| 15 | environment variable, MESA_DEBUG, to help with debugging. If |
| 16 | MESA_DEBUG is defined, a message will be printed to stdout whenever |
| 17 | an error occurs. |
| 18 | </p> |
| 19 | |
| 20 | <p> |
| 21 | More extensive error checking is done when Mesa is compiled with the |
| 22 | DEBUG symbol defined. You'll have to edit the Make-config file and |
| 23 | add -DDEBUG to the CFLAGS line for your system configuration. You may |
| 24 | also want to replace any optimization flags with the -g flag so you can |
| 25 | use your debugger. After you've edited Make-config type 'make clean' |
| 26 | before recompiling. |
| 27 | </p> |
| 28 | <p> |
| 29 | In your debugger you can set a breakpoint in _mesa_error() to trap Mesa |
| 30 | errors. |
| 31 | </p> |
| 32 | <p> |
| 33 | There is a display list printing/debugging facility. See the end of |
| 34 | src/dlist.c for details. |
| 35 | </p> |
| 36 | |
| 37 | </BODY> |
| 38 | </HTML> |