FMudanyali/FreeGLUT-Vita
Archived
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

document glutInitErrorFunc, glutInitWarningFunc, as well as

Browse Source 
FREEGLUT_PRINT_ERRORS and FREEGLUT_PRINT_WARNINGS


git-svn-id: https://svn.code.sf.net/p/freeglut/code/trunk@1600 7f0cb862-5218-0410-a997-914c9d46530a
This commit is contained in:
dcnieho 2013-04-05 11:03:47 +00:00
parent 467a9d3995
commit 78385ffca4
1 changed files with 35 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
freeglut/web-src/docs/api.php
View File

@ -66,6 +66,7 @@ will thus not work with the currently available 2.8.1 release.
<li>glutInitWindowPosition, glutInitWindowSize</li>
<li>glutInitDisplayMode</li>
<li>glutInitDisplayString</li>
<li>glutInitErrorFunc, glutInitWarningFunc</li>
</ol>
</li>
<li><a href="#EventProcessing">Event Processing Functions</a>
@ -482,6 +483,40 @@ is ignored. Many of these values can however be set with glutSetOption
for now however...
</p>
<h2>4.5 glutInitErrorFunc, glutInitWarningFunc</h2>
<p>
The <tt>glutInitErrorFunc</tt> and <tt>glutInitWarningFunc</tt>
functions specify callbacks that will be called upon warnings and errors
issued from within <i>FreeGLUT</i> so that the user can deal with these.
Useful for rerouting to another output sink (e.g., logging) and also to
avoid exit(1) being called upon error. As with other glutInit*
functions, these can be set before glutInit is called, so any output
from the library can be handled by the user.
</p>
<p><b>Usage</b></p>
<p><tt>void glutInitErrorFunc ( void (* callback)( const char *fmt, va_list ap) );</tt> <br/>
<tt>void glutInitWarningFunc ( void (* callback)( const char *fmt, va_list ap) );</tt> </p>
<p><b>Description</b></p>
<p>
The users callback is passed a format string and a variable argument
list that can be passed to functions such as <tt>printf</tt>.<br />
Note that there are the preprocessor definitions
<tt>FREEGLUT_PRINT_ERRORS</tt> and <tt>FREEGLUT_PRINT_WARNINGS</tt>. If
defined at library (not client app!) compile time, which is default,
warnings and errors are printed to <tt>stderr</tt>. If not defined,
warnings and errors are muted (not printed to stderr), though errors
still trigger deinitialization and exit. Whether
<tt>FREEGLUT_PRINT_ERRORS</tt> and <tt>FREEGLUT_PRINT_WARNINGS</tt> is
defined does not affect whether the client callback is called, it only
affects whether warnings and errors are printed to <tt>stderr</tt> when
no callback is defined.
</p>
<p><b>Changes From GLUT</b></p>
<p>GLUT does not provide these functions.</p>
<h1>5. <a name="EventProcessing"></a>Event Processing Functions</h1>
<p>