ImageMagick: MagickCore, C API for ImageMagick: Dealing with Exceptions
Author: ImageMagick Studio LLC
Description: ImageMagick is a software suite to create, edit, compose, or convert bitmap images in a variety of formats. Use ImageMagick to scale, rotate, shear, distort and transform images.
Keywords: magickcore, c, api, for, imagemagick:, dealing, with, exceptions, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing

Unix
Mac OS X
Windows
Processing
Options
Usage
MagickWand
MagickCore
PerlMagick
Magick++
Unix
Windows
Links

# Module exception Methods

## AcquireExceptionInfo

AcquireExceptionInfo() allocates the ExceptionInfo structure.

The format of the AcquireExceptionInfo method is:

      ExceptionInfo *AcquireExceptionInfo(void)

## ClearMagickException

ClearMagickException() clears any exception that may not have been caught yet.

The format of the ClearMagickException method is:

      ClearMagickException(ExceptionInfo *exception)

A description of each parameter follows:

##### exception

the exception info.

## CatchException

CatchException() returns if no exceptions is found otherwise it reports the exception as a warning, error, or fatal depending on the severity.

The format of the CatchException method is:

      CatchException(ExceptionInfo *exception)

A description of each parameter follows:

##### exception

the exception info.

## DestroyExceptionInfo

DestroyExceptionInfo() deallocates memory associated with an exception.

The format of the DestroyExceptionInfo method is:

      ExceptionInfo *DestroyExceptionInfo(ExceptionInfo *exception)

A description of each parameter follows:

##### exception

the exception info.

## GetExceptionInfo

GetExceptionInfo() initializes an exception to default values.

The format of the GetExceptionInfo method is:

      GetExceptionInfo(ExceptionInfo *exception)

A description of each parameter follows:

##### exception

the exception info.

## GetExceptionMessage

GetExceptionMessage() returns the error message defined by the specified error code.

The format of the GetExceptionMessage method is:

      char *GetExceptionMessage(const int error)

A description of each parameter follows:

##### error

the error code.

## GetLocaleExceptionMessage

GetLocaleExceptionMessage() converts a enumerated exception severity and tag to a message in the current locale.

The format of the GetLocaleExceptionMessage method is:

      const char *GetLocaleExceptionMessage(const ExceptionType severity,
        const char *tag)

A description of each parameter follows:

##### severity

the severity of the exception.

##### tag

the message tag.

## InheritException

InheritException() inherits an exception from a related exception.

The format of the InheritException method is:

      InheritException(ExceptionInfo *exception,const ExceptionInfo *relative)

A description of each parameter follows:

##### exception

the exception info.

##### relative

the related exception info.

## MagickError

MagickError() calls the exception handler methods with an error reason.

The format of the MagickError method is:

      void MagickError(const ExceptionType error,const char *reason,
        const char *description)

A description of each parameter follows:

##### exception

Specifies the numeric error category.

##### reason

Specifies the reason to display before terminating the program.

##### description

Specifies any description to the reason.

## MagickFatalError

MagickFatalError() calls the fatal exception handler methods with an error reason.

The format of the MagickError method is:

      void MagickFatalError(const ExceptionType error,const char *reason,
        const char *description)

A description of each parameter follows:

##### exception

Specifies the numeric error category.

##### reason

Specifies the reason to display before terminating the program.

##### description

Specifies any description to the reason.

## MagickWarning

MagickWarning() calls the warning handler methods with a warning reason.

The format of the MagickWarning method is:

      void MagickWarning(const ExceptionType warning,const char *reason,
        const char *description)

A description of each parameter follows:

##### warning

the warning severity.

##### reason

Define the reason for the warning.

##### description

Describe the warning.

## SetErrorHandler

SetErrorHandler() sets the exception handler to the specified method and returns the previous exception handler.

The format of the SetErrorHandler method is:

      ErrorHandler SetErrorHandler(ErrorHandler handler)

A description of each parameter follows:

##### handler

the method to handle errors.

## SetFatalErrorHandler

SetFatalErrorHandler() sets the fatal exception handler to the specified method and returns the previous fatal exception handler.

The format of the SetErrorHandler method is:

      ErrorHandler SetErrorHandler(ErrorHandler handler)

A description of each parameter follows:

##### handler

the method to handle errors.

## SetWarningHandler

SetWarningHandler() sets the warning handler to the specified method and returns the previous warning handler.

The format of the SetWarningHandler method is:

      ErrorHandler SetWarningHandler(ErrorHandler handler)

A description of each parameter follows:

##### handler

the method to handle warnings.

## ThrowException

ThrowException() throws an exception with the specified severity code, reason, and optional description.

The format of the ThrowException method is:

      MagickBooleanType ThrowException(ExceptionInfo *exception,
        const ExceptionType severity,const char *reason,
        const char *description)

A description of each parameter follows:

##### exception

the exception info.

##### severity

the severity of the exception.

##### reason

the reason for the exception.

##### description

the exception description.

Discourse Server • Studio