1. NAME

XcmsCIELabQueryMaxC, XcmsCIELabQueryMaxL, XcmsCIELabQueryMaxLC, XcmsCIELabQueryMinL - obtain the CIE L*a*b* coordinates

2. SYNTAX

Status XcmsCIELabQueryMaxC(XcmsCCC ccc, XcmsFloat hue_angle, XcmsFloat L_star, XcmsColor *color_return); Status XcmsCIELabQueryMaxL(XcmsCCC ccc, XcmsFloat hue_angle, XcmsFloat chroma, XcmsColor *color_return); Status XcmsCIELabQueryMaxLC(XcmsCCC ccc, XcmsFloat hue_angle, XcmsColor *color_return); Status XcmsCIELabQueryMinL(XcmsCCC ccc, XcmsFloat hue_angle, XcmsFloat chroma, XcmsColor *color_return);

3. ARGUMENTS

ccc 1i Specifies the CCC. Note that the CCC's Client White Point and White Point Adjustment procedures are ignored.

chroma 1i Specifies the chroma at which to find \*(Ch.

color_return 1i Returns the CIE L*a*b* coordinates of \*(Lc displayable by the screen for the given \*(lC. The white point associated with the returned color specification is the Screen White Point. The value returned in the pixel member is undefined.

hue_angle 1i Specifies the hue angle (in degrees) at which to find \*(Ha.

L_star 1i Specifies the lightness (L*) at which to find \*(Ls.

4. DESCRIPTION

The .ZN XcmsCIELabQueryMaxC function, given a hue angle and lightness, finds the point of maximum chroma displayable by the screen. It returns this point in CIE L*a*b* coordinates.

The .ZN XcmsCIELabQueryMaxL function, given a hue angle and chroma, finds the point in CIE L*a*b* color space of maximum lightness (L*) displayable by the screen. It returns this point in CIE L*a*b* coordinates. An .ZN XcmsFailure return value usually indicates that the given chroma is beyond maximum for the given hue angle.

The .ZN XcmsCIELabQueryMaxLC function, given a hue angle, finds the point of maximum chroma displayable by the screen. It returns this point in CIE L*a*b* coordinates.

The .ZN XcmsCIELabQueryMinL function, given a hue angle and chroma, finds the point of minimum lightness (L*) displayable by the screen. It returns this point in CIE L*a*b* coordinates. An .ZN XcmsFailure return value usually indicates that the given chroma is beyond maximum for the given hue angle.

5. SEE ALSO