ImageGear for C and C++ on Linux v18.8 - Updated
IG_color_space_level_get
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Color Space Options Functions > IG_color_space_level_get

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_color_space_level_get(
        AT_MODE nColorSpaceID, 
        LPAT_MODE lpnSupportLevel
);

Arguments:

Name Type Description
nColorSpaceID AT_MODE Set this to an AT_MODE constant for the type of color space of which you would like to get the support level setting. The names of the appropriate constants begin with IG_COLOR_SPACE_ prefix.
lpnSupportLevel LPAT_MODE A far pointer that returns the current setting level for the color space specified in the first argument. See IG_color_space_level_set().

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

 
Copy Code
AT_ERRCOUNT                      nErrcount;
HIGEAR                  hIGear;
AT_MODE                 nSupportLevel;
nErrcount = IG_color_space_level_get(IG_COLOR_SPACE_CMYK, &nSupporLevel);

Remarks:

This function queries the current option level setting for the color space that you specify.

You must supply nColorSpaceID with a constant of type AT_MODE from accucnst.h that specifies the color space you wish to query. The second argument will return an ImageGear constant that tells you the current option level setting for the color space.

ImageGear fully supports the loading and saving of TIFF-CMYK images. A CMYK image will only be converted to RGB for the purpose of display. CMYK is a color scheme designed for printing and cannot be used for screen display.
For more details see the description for IG_color_space_level_set().