pixel_iterator - Pixel iterator pattern support functions
MagickPassFail PixelIterateDualModify( PixelIteratorDualModifyCallback call_back, const char *description, void *user_data, const unsigned long columns, const unsigned long rows, const Image *source_image, const long source_x, const long source_y, Image *update_image, const long update_x, const long update_y, ExceptionInfo *exception );
MagickPassFail PixelIterateDualRead( PixelIteratorDualReadCallback call_back, const char *description, void *user_data, const unsigned long columns, const unsigned long rows, const Image *first_image, const long first_x, const long first_y, const Image *second_image, const long second_x, const long second_y, ExceptionInfo *exception );;
MagickPassFail PixelIterateMonoModify( PixelIteratorMonoModifyCallback call_back, const char *description, void *user_data, const long x, const long y, const unsigned long columns, const unsigned long rows, Image *image, ExceptionInfo *exception );
MagickPassFail PixelIterateMonoRead( PixelIteratorMonoReadCallback call_back, const char *description, void *user_data, const long x, const long y, const unsigned long columns, const unsigned long rows, const Image *image, ExceptionInfo *exception );
PixelIterateMonoRead() iterates through a region of an image and invokes a user-provided callback function ( of type PixelIteratorMonoReadCallback ) for each pixel. This is useful to support simple operations such as statistics computation.
The format of the PixelIterateMonoRead method is:
MagickPassFail PixelIterateMonoRead ( PixelIteratorMonoReadCallback call_back, const char *description, void *user_data, const long x, const long y, const unsigned long columns, const unsigned long rows, const Image *image, ExceptionInfo *exception );
A description of each parameter follows:
A user-provided C callback function which is passed the address of a pixel from each image.
textual description of operation being performed.
User-provided context data.
The horizontal ordinate of the top left corner of the region.
The vertical ordinate of the top left corner of the region.
Width of pixel region
Height of pixel region
The address of the Image.
If an error is reported, this argument is updated with the reason.
PixelIterateMonoModify() iterates through a region of an image and invokes a user-provided callback function ( of type PixelIteratorMonoReadCallback ) for each pixel. This is useful to support simple operations such as level shifting, colorspace translation, or thresholding.
The format of the PixelIterateMonoModify method is:
MagickPassFail PixelIterateMonoModify ( PixelIteratorMonoModifyCallback call_back, const char *description, void *user_data, const long x, const long y, const unsigned long columns, const unsigned long rows, Image *image, ExceptionInfo *exception );
A description of each parameter follows:
A user-provided C callback function which is passed the address of a pixel from each image.
textual description of operation being performed.
User-provided context data.
The horizontal ordinate of the top left corner of the region.
The vertical ordinate of the top left corner of the region.
Width of pixel region
Height of pixel region
The address of the Image.
If an error is reported, this argument is updated with the reason.
PixelIterateDualRead() iterates through pixel regions of two images and invokes a user-provided callback function ( of type PixelIteratorDualReadCallback ) for each pixel. This is useful to support operations such as image comparison.
The format of the PixelIterateDualModify method is:
MagickPassFail PixelIterateDualRead ( PixelIteratorDualReadCallback call_back, const char *description, void *user_data, const unsigned long columns, const unsigned long rows, const Image *first_image, const long first_x, const long first_y, const Image *second_image, const long second_x, const long second_y, ExceptionInfo *exception );;
A description of each parameter follows:
A user-provided C callback function which is passed the address of a pixel from each image.
textual description of operation being performed.
User-provided context data.
Width of pixel region
Height of pixel region
The address of the first Image.
The horizontal ordinate of the top left corner of the first region.
The vertical ordinate of the top left corner of the first region.
The address of the second Image.
The horizontal ordinate of the top left corner of the second region.
The vertical ordinate of the top left corner of the second region.
If an error is reported, this argument is updated with the reason.
PixelIterateDualModify() iterates through pixel regions of two images and invokes a user-provided callback function ( of type PixelIteratorDualModifyCallback ) for each pixel. This is useful to support operations such as composition.
The format of the PixelIterateDualModify method is:
MagickPassFail PixelIterateDualModify ( PixelIteratorDualModifyCallback call_back, const char *description, void *user_data, const unsigned long columns, const unsigned long rows, const Image *source_image, const long source_x, const long source_y, Image *update_image, const long update_x, const long update_y, ExceptionInfo *exception );
A description of each parameter follows:
A user-provided C callback function which reads from a source pixel and updates a destination pixel.
textual description of operation being performed.
User-provided context data.
Width of pixel region
Height of pixel region
The address of the constant source Image.
The horizontal ordinate of the top left corner of the source region.
The vertical ordinate of the top left corner of the source region.
The address of the update Image.
The horizontal ordinate of the top left corner of the update region.
The vertical ordinate of the top left corner of the update region.
If an error is reported, this argument is updated with the reason.