ImageGear for C and C++ on Windows v19.1 - Updated
IG_colorspace_conversion_result_channels_build
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Color Space Conversion Functions > IG_colorspace_conversion_result_channels_build

This function builds the channels structure for the specified conversion.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_colorspace_conversion_result_channels_build(
        enumIGColorSpaceIDs sourceSpace,
        const AT_INT* sourceChannelDepths,
        AT_INT sourceChannelCount,
        enumIGColorSpaceIDs resultSpace,
        AT_INT* resultChannelDepths,
        AT_INT* resultChannelCount,
        LPCAT_COLORSPACE_CONVERSION_OPTIONS options
);

Arguments:

Name Type Description
sourceSpace enumIGColorSpaceIDs Color space from which to convert.
sourceChannelDepths const AT_INT* Array of channel depths for source color space.
sourceChannelCount AT_INT Number of channels in source color space.
resultSpace enumIGColorSpaceIDs Color space to which to convert.
resultChannelDepths AT_INT* Array of channel depths in resulting color space.
resultChannelCount AT_INT* Number of channels in resulting color space.
options LPCAT_COLORSPACE_CONVERSION_OPTIONS Conversion options.

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:

All pixel formats supported by ImageGear for C and C++.

Sample:

None

Example:

 
Copy Code
/* Calculate output channel depths for RGB to CMYK */
AT_ERRCOUNT nErrcount;  /* Number of errors on stack */
AT_INT depthsIn[] = { 8, 8, 8 }; /* Channel depths */
AT_INT depthsOut[4]; /* Output channel depths */
AT_INT nDepthsOut = 4; /* Number of output channel depths */
nErrcount = IG_colorspace_conversion_result_channels_build(
    IG_COLOR_SPACE_ID_RGB, depthsIn, 3, 
    IG_COLOR_SPACE_ID_CMYK, depthsOut, &nDepthsOut, NULL);
/* depthsOut[] is { 8, 8, 8, 8 } */

Remarks:

This function fills resultChannelDepths with the calculated depths. resultChannelCount contains the quantity of channels in the result raster. Options controls the conversion flow. You may pass NULL for Options if you don't want to specify any options.

For the detailed information about AT_COLORSPACE_CONVERSION_OPTIONS structure and the whole color conversion process please refer to the section Working with Color Space Conversion Engine.