This function computes the best-fit plane for an image, and then subtracts that plane from the image to produce the output.

Declaration:

AT_ERRCOUNT ACCUAPI IG_IP_remove_tilt(
        HIGEAR hIGear, 
        const LPAT_RECT lpRect, 
        AT_BOOL bRemoveMean
);

Arguments:

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

Grayscale - 8, 16, 32 bpp.

Example:

HIGEAR hIGear; /* HIGEAR handle of image */
AT_BOOL         bRemoveMean;    /* TRUE = remove mean */
AT_RECT         lpRect; /* rectangle to process */
...
IG_IP_remove_tilt( hIGear, lpRect, bRemoveMean);
...

Remarks:

This function is very handy for correcting illumination gradients in a poorly digitized image.

If bRemoveMean argument is set to TRUE, then remove mean from image.

This function, like other ImageGear Image Processing and Clipboard API calls, takes an AT_RECT structure as an argument, so that you can process a rectangular sub-region of an image. However, before ImageGear performs the operation specified by this function, it will check to see if an internal flag has been set to TRUE, indicating that a mask HIGEAR should be used with the image. If the flag is set to TRUE, and a valid pointer to a mask image has been assigned, ImageGear will override the settings passed to the AT_RECT structure and use the non-rectangular ROI defined by the mask HIGEAR. To create a non-rectangular region of interest, call IG_IP_NR_ROI_to_HIGEAR_mask().