2013-09-05 07:08:03 -06:00
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
|
|
<html lang="en">
|
|
|
|
<head>
|
|
|
|
<meta http-equiv="content-type" content="text/html; charset=utf-8">
|
|
|
|
<title>Debugging Tips</title>
|
|
|
|
<link rel="stylesheet" type="text/css" href="mesa.css">
|
|
|
|
</head>
|
|
|
|
<body>
|
2006-11-25 11:49:17 -07:00
|
|
|
|
2013-09-05 07:08:03 -06:00
|
|
|
<div class="header">
|
|
|
|
<h1>The Mesa 3D Graphics Library</h1>
|
|
|
|
</div>
|
2006-11-25 11:49:17 -07:00
|
|
|
|
2013-09-05 07:08:03 -06:00
|
|
|
<iframe src="contents.html"></iframe>
|
|
|
|
<div class="content">
|
2006-11-25 11:49:17 -07:00
|
|
|
|
2013-09-05 07:08:03 -06:00
|
|
|
<h1>Debugging Tips</h1>
|
2006-11-25 11:49:17 -07:00
|
|
|
|
|
|
|
<p>
|
|
|
|
Normally Mesa (and OpenGL) records but does not notify the user of
|
|
|
|
errors. It is up to the application to call
|
|
|
|
<code>glGetError</code> to check for errors. Mesa supports an
|
|
|
|
environment variable, MESA_DEBUG, to help with debugging. If
|
|
|
|
MESA_DEBUG is defined, a message will be printed to stdout whenever
|
|
|
|
an error occurs.
|
|
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
|
|
More extensive error checking is done when Mesa is compiled with the
|
|
|
|
DEBUG symbol defined. You'll have to edit the Make-config file and
|
|
|
|
add -DDEBUG to the CFLAGS line for your system configuration. You may
|
|
|
|
also want to replace any optimization flags with the -g flag so you can
|
|
|
|
use your debugger. After you've edited Make-config type 'make clean'
|
|
|
|
before recompiling.
|
|
|
|
</p>
|
|
|
|
<p>
|
|
|
|
In your debugger you can set a breakpoint in _mesa_error() to trap Mesa
|
|
|
|
errors.
|
|
|
|
</p>
|
|
|
|
<p>
|
|
|
|
There is a display list printing/debugging facility. See the end of
|
|
|
|
src/dlist.c for details.
|
|
|
|
</p>
|
|
|
|
|
2013-09-05 07:08:03 -06:00
|
|
|
</div>
|
|
|
|
</body>
|
|
|
|
</html>
|