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

This function is an upgrade to IG_IP_color_combine().

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_IP_color_combine_ex (
        LPHIGEAR lphIGear_result, 
        HIGEAR hIGear1, 
        HIGEAR hIGear2, 
        HIGEAR hIGear3, 
        HIGEAR hIGear4, 
        AT_MODE color_space, 
        AT_MODE dst_color_space
);

Arguments:

Name Type Description
lphIGear_result LPHIGEAR Far pointer to an object of type HIGEAR, to receive the HIGEAR handle of the created 24- bit image.
hIGear1 HIGEAR HIGEAR handle of input image to be treated as channel 1.
hIGear2 HIGEAR HIGEAR handle of input image to be treated as channel 2.
hIGear3 HIGEAR HIGEAR handle of input image to be treated as channel 3.
hIGear4 HIGEAR HIGEAR handle of input image to be treated as channel 4.
nColorSpace AT_MODE A constant such as IG_COLOR_SPACE_RGB describing how the channels are to be merged.
dst_color_space AT_MODE tells what color space output HIGEAR should have. There are 2 possible values now: RGB and CMYK.

Return Value:

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

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Sample:

Color

Remarks:

While support for IG_IP_color_combine() is being maintained, it is recommended that you use this newer function. The additional benefit of this function is that it allows you to choose a color space for the destination image. For example, you can choose to store your destination image using the CMYK color scheme. Currently, the dst_color_space parameter can take one of the following constants as its setting: IG_COLOR_SPACE_RGBand IG_COLOR_SPACE_CMYK. In order to set it to CMYK, you must be sure that you first call IG_color_space_level_set() function with settings of IG_COLOR_SPACE_CMYK and IG_FULL_SUPPORT.