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.