0error - ImageMagick Error Methods9W




"NAME

(

error - ImageMagick Error Methods



2page index




&SYNOPSIS

<

CatchImageException( Image *image );

O

void DestroyExceptionInfo( ExceptionInfo *exception );

E

GetExceptionInfo( ExceptionInfo *exception );

T

GetImageException( Image *image, ExceptionInfo *exception );

s

void MagickError( const ExceptionType error, const char *message, const char *qualifier );

w

void MagickWarning( const ExceptionType warning, const char *message, const char *qualifier );

N

ErrorHandler SetErrorHandler( ErrorHandler handler );

P

ErrorHandler SetWarningHandler( ErrorHandler handler );



2page index


$

FUNCTION *DESCRIPTIONS



>

CatchImageException

Í

Method CatchImageException returns if no exceptions are found in the image sequence, otherwise it determines the most severe exception and reports it as a warning or error depending on the severity.

7

The format of the CatchImageException method is:

a
CatchImageException ( Image *image );

AA description of each parameter follows:


@

image:

4Specifies a pointer to a list of one or more images.



@

DestroyExceptionInfo

a

Method DestroyExceptionInfo deallocates memory associated with an ExceptionInfo structure.

8

The format of the DestroyExceptionInfo method is:

{
void DestroyExceptionInfo ( ExceptionInfo *exception );

AA description of each parameter follows:


H

exception:

2Specifies a pointer to an ExceptionInfo structure.



8

GetExceptionInfo

G

Method GetExceptionInfo initializes the ExceptionInfo structure.

4

The format of the GetExceptionInfo method is:

r
GetExceptionInfo ( ExceptionInfo *exception );

AA description of each parameter follows:


J

error_info:

1Specifies a pointer to a ExceptionInfo structure.



:

GetImageException

Method GetImageException traverses an image sequence and returns any error more severe than noted by the exception parameter.

5

The format of the GetImageException method is:

 
GetImageException ( Image *image, ExceptionInfo *exception );

AA description of each parameter follows:


"

image:

4Specifies a pointer to a list of one or more images.

&

exception:

&return the highest severity exception.



.

MagickError

P

Method MagickError calls the error handler methods with an error message.

/

The format of the MagickError method is:

¬
void MagickError ( const ExceptionType error, const char *message, const char *qualifier );

AA description of each parameter follows:


&

exception:

%Specifies the numeric error category.

D

message:

@Specifies the message to display before terminating the program.

H

qualifier:

'Specifies any qualifier to the message.



2

MagickWarning

U

Method MagickWarning calls the warning handler methods with a warning message.

1

The format of the MagickWarning method is:

°
void MagickWarning ( const ExceptionType warning, const char *message, const char *qualifier );

AA description of each parameter follows:


D

warning:

'Specifies the numeric warning category.

$

message:

@Specifies the message to display before terminating the program.

&

qualifier:

'Specifies any qualifier to the message.



6

SetErrorHandler

t

Method SetErrorHandler sets the error handler to the specified method and returns the previous error handler.

3

The format of the SetErrorHandler method is:

S
ErrorHandler SetErrorHandler ( ErrorHandler handler );

AA description of each parameter follows:


D

handler:

1Specifies a pointer to a method to handle errors.



:

SetWarningHandler

z

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

5

The format of the SetWarningHandler method is:

U
ErrorHandler SetWarningHandler ( ErrorHandler handler );

AA description of each parameter follows:


$

handler:

3Specifies a pointer to a method to handle warnings.
9

page index