ImageGear for C and C++ on Windows v19.7 - Updated
IG_IP_transform_with_LUTs
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Image Processing Functions > IG_IP_transform_with_LUTs

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

Declaration:

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

Arguments:

Name Type Description
hImage HIGEAR Number of channels for the Multi-channel LUT.
lpRect const LPAT_RECT New Multi-channel LUT object.
LUTCount AT_INT Number of LUTs in the array.
lpLUTs const HIGLUT* Array of LUTs.

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

Please see the descriptions of IG_IP_NR_ROI_mask_associate() and IG_IP_NR_ROI_to_HIGEAR_mask() functions for more details.