Title Banner

Previous Book Contents Book Index Next

Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /
Chapter 19 - Error Manager


About the Error Manager

QuickDraw 3D defines several levels of exceptional conditions that can occur during the execution of QuickDraw 3D routines. An exceptional condition can be an error, a warning, or a notice, depending on the severity of the exceptional condition.

QuickDraw 3D notifies your application of errors, warnings, and notices by executing application-defined callback routines you have previously registered with the Error Manager. Once a callback routine is registered, QuickDraw 3D calls it whenever the appropriate condition occurs.

IMPORTANT
Notices are generated only by debugging versions
of the QuickDraw 3D shared library.
You register a callback routine by passing its address to the Q3Error_Register, Q3Warning_Register, or Q3Notice_Register function, depending on whether the callback routine is to handle errors, warnings, or notices. If you do not register a callback routine for errors, the Error Manager calls an internal error handler that attempts to handle the exception. The manner in which the exception handler handles that error can vary, depending on the operating system. For example, on the Macintosh Operating System, the internal exception handler of the debugging version calls the DebugStr function.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
11 JUL 1996




Navigation graphic, see text links

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help