IG_colorspace_conversion_result_channels

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 );

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 } */

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.