IG_color_space_level

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.

Sample:

Color

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().