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

This function has been deprecated and will be removed from the public API in a future release. Please use IG_image_colorspace_convert instead.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_IP_color_convert(
        [IN] HIGEAR hIGear,
        [IN] AT_MODE nColorSpace
);

Arguments:

Name Type Description
hIGear HIGEAR The ImageGear handle of an image.
nColorSpace AT_MODE The identifier of destination color space where to convert.

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

Example:

 
Copy Code
HIGEAR hIGear;    /* HIGEAR handle of image  */
. . .
IG_IP_color_convert( hIGear, IG_COLOR_SPACE_CMYK );
. . .

Remarks:

This function converts an image from one internal format to another depending on the parameter, nColorSpace.

The nColorSpace parameter must be a color space listed in enumIGColorSpaces, which is defined in accucnst.h.

Commonly used values for nColorSpace are: