ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / Core Component API Reference / Core Component Functions Reference / Image Processing Functions / IG_IP_color_convert
In This Topic
    IG_IP_color_convert
    In This Topic

    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: