IG_fltr_raster_plane_callback

This function allows you to register your raster plane callback LPFNIG_RASTER_PLANE_SET function.

Declaration:

	Copy Code
AT_ERRCOUNT LACCUAPI IG_fltr_raster_plane_callback_set( LPFNIG_RASTER_PLANE_SET lpfnRasterPlaneSetCB, AT_VOID* Reserved );

Arguments:

Name	Type	Description
lpfnRasterPlaneSetCB	LPFNIG_RASTER_PLANE_SET	Specifies the callback function which will receive raster planes of pixels.
Reserved	AT_VOID*	Reserved, should be NULL.

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

	Copy Code
// Handles merging of planes into a raster line AT_ERRCOUNT ACCUAPI RasterPlaneSet( AT_VOID lpPrivate, // Private data passed in const AT_VOID lpRast, // Raster line to set AT_PIXPOS cyPos, // Y position in the image AT_INT cRasterSize, // Size of the raster line AT_INT nBitPlane // Bit plane to merge in ) { // ... return 0; } void Example_IG_fltr_raster_plane_callback_set() { AT_ERRCOUNT nErrcount; // Count of returned errors on stack // Set raster plane callback functions nErrcount = IG_fltr_raster_plane_callback_set(RasterPlaneSet, NULL); }

Copy Code

// Handles merging of planes into a raster line
AT_ERRCOUNT ACCUAPI RasterPlaneSet( 
    AT_VOID               *lpPrivate,        // Private data passed in
    const AT_VOID*     lpRast,                // Raster line to set
    AT_PIXPOS            cyPos,            // Y position in the image
    AT_INT               cRasterSize,        // Size of the raster line
    AT_INT                nBitPlane        // Bit plane to merge in
    )
{
    // ...
    return 0;
}

void Example_IG_fltr_raster_plane_callback_set()
{
    AT_ERRCOUNT nErrcount;            // Count of returned errors on stack
    // Set raster plane callback functions
    nErrcount = IG_fltr_raster_plane_callback_set(RasterPlaneSet, NULL);
}

Remarks:

ImageGear calls lpfnRasterPlaneSetCB callback function to pass raster plane data that has been read from a file to the application. The callback is invoked when reading images where pixel data is stored in planar format. As of this writing, only TIF and DICOM format filters support this callback.