ImageGear for C and C++ on Windows v19.1 - Updated
IG_IP_DCRaw_white_point_calculate
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Image Processing Functions > IG_IP_DCRaw_white_point_calculate

Calculates white point corresponding to neutral color in camera color space based on two known color matrices corresponding to different light conditions.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_IP_DCRaw_white_point_calculate (
        AT_INT SrcChannelCount,
        HIGDoubleMatrix XYZToCam1,      
        enumIGIlluminant Illuminant1,   
        HIGDoubleMatrix XYZToCam2,  
        enumIGIlluminant Illuminant2,   
        const AT_DOUBLE* lpNeutralColor,
        AT_DPOINT* lpWhiteXY,
);

Arguments:

Name Type Description
SrcChannelCount AT_INT Number of channels in the camera color space.
XYZToCam1 HIGDoubleMatrix XYZ to camera matrix under Illuminant 1.
Illuminant1 enumIGIlluminant Illuminant 1.
XYZToCam2 HIGDoubleMatrix XYZ to camera matrix under Illuminant 2.
Illuminant2 enumIGIlluminant Illuminant 2.
lpNeutralColor const AT_DOUBLE* Normalized coordinates of a neutral color.
lpWhiteXY AT_DPOINT* Returns the calculated white point coordinates.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

If only one color matrix is known, pass null to XYZToCam2.

Dimensions of XYZToCam1 and XYZToCam2 must be equal to (n, 3), where n is channel count of native cameracolor space (3 or 4). Number of entries in the lpNeutralColor array must be equal to channel count of native camera colorspace.