Almost every function in the Intel® Image Processing Library checks the parameters you pass to it. If the parameters are incorrect (for example, an input array pointer is NULL), the library sets an error status code. The program behavior in such cases depends on the current error-handling mode. The following modes are supported:

IPL_ErrModeLeaf (the default mode). In this mode, if an error occurs, the library stops the function execution and brings up a dialog with an error message. Then the user decides whether to terminate the application or continue running it.

IPL_ErrModeSilent. In this mode, the library does not generate error messages. The application itself has to check if there are error conditions. To retrieve the current error status code, call the function iplGetErrStatus().

IPL_ErrModeParent. In this mode, error messages are generated, but errors must be processed in the "parents" of the function call tree (similar to IPL_ErrModeSilent).

To set or change the error handling mode, call the function iplSetErrMode() with the parameter specifying the new mode: IPL_ErrModeSilent, IPL_ErrModeLeaf, or IPL_ErrModeParent.

* Legal Information © 1998-2000, Intel Corporation