ImageGear Professional for Unix
IG_IP_color_combine_ex
| ImageGear Professional v18.2 > 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().
|
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
);
|
|
| 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. |
Returns the number of ImageGear errors that occurred during this function call.
All pixel formats supported by ImageGear Professional.
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.