<!-- This file copyright Persistence of Vision Raytracer Pty. Ltd. 2003-2004 -->
<html>
<head>
<!-- NOTE: In order to users to help find information about POV-Ray using -->
<!-- web search engines, we ask you to *not* let them index documentation -->
<!-- mirrors because effectively, when searching, users will get hundreds -->
<!-- of results containing the same information! For this reason, the two -->
<!-- meta tags below disable archiving and indexing of this page by all -->
<!-- search engines that support these meta tags. -->
<meta content="noarchive" name="robots">
<meta content="noindex" name="robots">
<meta content="no-cache" http-equiv="Pragma">
<meta content="0" http-equiv="expires">
<title>3.7.5 debug.inc</title>
<link href="povray35.css" rel="stylesheet" type="text/css">
</head>
<body>
<table class="NavBar" width="100%">
<tr>
<td align="left" nowrap="" valign="middle" width="32">
<a href="s_135.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_135.html">3.7.4 consts.inc</a>
</td>
<td align="center" valign="middle">
<strong class="NavBar">POV-Ray 3.6 for UNIX documentation</strong><br> <strong>3.7.5
debug.inc</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_137.html">3.7.6 finish.inc</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_137.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
<h3><a name="s03_07_05">3.7.5 </a>debug.inc</h3>
<p>
This file contains a set of macros designed to make debugging easier. It also functions like the old debug.inc,
with the exception that you have to call the Debug_Inc_Stack() macro to get the include stack output.
</p>
<p>
<code>Debug_Inc_Stack()</code>. Activates include file tracking, each included file will send a debug message when
it is included.<br> Parameters: None.
</p>
<p>
<code>Set_Debug(Bool)</code>. Activate or deactivate the debugging macros.<br> Parameters:
</p>
<ul>
<li>
<code>Bool</code> = A boolean (true/false) value.
</li>
</ul>
<p>
<code>Debug_Message(Str)</code>. If debugging, sends the message to the debug stream.<br> Parameters:
</p>
<ul>
<li>
<code>Str</code> = The desired message.
</li>
</ul>
<a name="s03_07_05_i1"><a name="debug, debug.inc"></a><a name="s03_07_05_i2"><a name="warning, debug.inc"></a><a name="s03_07_05_i3"><a name="error, debug.inc"></a>
<p>
<code>Debug(Condition, Message)<br> Warning(Condition, Message)<br> Error(Condition, Message)</code><br> These
macros send a message to the #debug, #warning, and #error streams depending on a given condition. They are just a
shortcut for an <code>#if()...#end</code> block, intended to make scenes easier to read.<br> Parameters:
</p>
<ul>
<li>
<code>Condition</code> = Any boolean expression.
</li>
<li>
<code>Message</code> = The message to be sent if Condition evaluates as "true".
</li>
</ul>
<br>
<table class="NavBar" width="100%">
<tr>
<td align="left" nowrap="" valign="middle" width="32">
<a href="s_135.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_135.html">3.7.4 consts.inc</a>
</td>
<td align="center" valign="middle">
<strong>3.7.5 debug.inc</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_137.html">3.7.6 finish.inc</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_137.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
</body> </html>
