Pair


NAME

monitor - Monitor the Progress of an Image Operation


SYNOPSIS

unsigned int MagickMonitor( const char *text, const ExtendedSignedIntegralType quantum, const ExtendedUnsignedIntegralType span, ExceptionInfo *exception );

MonitorHandler SetMonitorHandler( MonitorHandler handler );


FUNCTION DESCRIPTIONS

MagickMonitor

MagickMonitor() calls the monitor handler method with a text string that describes the task and a measure of completion. The method returns True on success otherwise False if an error is encountered, e.g. if there was a user interrupt.

The format of the MagickMonitor method is:

unsigned int MagickMonitor ( const char *text, const ExtendedSignedIntegralType quantum, const ExtendedUnsignedIntegralType span, ExceptionInfo *exception );

A description of each parameter follows:

quantum:
The position relative to the span parameter which represents how much progress has been made toward completing a task.

span:
The span relative to completing a task.

exception:
Return any errors or warnings in this structure.

SetMonitorHandler

SetMonitorHandler() sets the monitor handler to the specified method and returns the previous monitor handler.

The format of the SetMonitorHandler method is:

MonitorHandler SetMonitorHandler ( MonitorHandler handler );

A description of each parameter follows:

handler:
Specifies a pointer to a method to handle monitors.