Transforms the pixel values of the image referenced by hIGear, using an array of look-up tables.

Declaration:

AT_ERRCOUNT ACCUAPI IG_IP_transform_with_LUTs(
        HIGEAR hImage,
        const LPAT_RECT lpRect,
        AT_INT LUTCount,
        const HIGLUT* lpLUTs
);

Arguments:

Return Value:

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

Supported Raster Image Formats:

RGB - 48 bpp.

Remarks:

The pixels from hIGear are used as indices into the LUTs. The entry in the LUT at this position is placed into the corresponding channel of the new image.

Number of LUTs must correspond to the number of channels in the image. Input depths of all LUTs must be equal to corresponding channel depths of the image. Channel depths of result image will be equal to output depths of the corresponding LUTs. All items of the LUTs array can point to the same LUT object. This will process all three channels the same.

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. (See above.) 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().