Clone of mesa.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

debugging.html 1.4KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
  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. <div class="header">
  10. <h1>The Mesa 3D Graphics Library</h1>
  11. </div>
  12. <iframe src="contents.html"></iframe>
  13. <div class="content">
  14. <h1>Debugging Tips</h1>
  15. <p>
  16. Normally Mesa (and OpenGL) records but does not notify the user of
  17. errors. It is up to the application to call
  18. <code>glGetError</code> to check for errors. Mesa supports an
  19. environment variable, MESA_DEBUG, to help with debugging. If
  20. MESA_DEBUG is defined, a message will be printed to stdout whenever
  21. an error occurs.
  22. </p>
  23. <p>
  24. More extensive error checking is done when Mesa is compiled with the
  25. DEBUG symbol defined. You'll have to edit the Make-config file and
  26. add -DDEBUG to the CFLAGS line for your system configuration. You may
  27. also want to replace any optimization flags with the -g flag so you can
  28. use your debugger. After you've edited Make-config type 'make clean'
  29. before recompiling.
  30. </p>
  31. <p>
  32. In your debugger you can set a breakpoint in _mesa_error() to trap Mesa
  33. errors.
  34. </p>
  35. <p>
  36. There is a display list printing/debugging facility. See the end of
  37. src/dlist.c for details.
  38. </p>
  39. </div>
  40. </body>
  41. </html>