| 12
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
 100
 101
 102
 103
 104
 105
 106
 107
 108
 109
 110
 111
 112
 113
 114
 115
 116
 117
 118
 119
 120
 121
 122
 123
 124
 125
 126
 127
 128
 129
 130
 131
 132
 133
 134
 135
 136
 137
 138
 139
 140
 141
 142
 143
 144
 
 | 
<!--  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>
 |