XcmsCIELabQueryMax(3X11)      SDK X11 R4.11MU05     XcmsCIELabQueryMax(3X11)


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

SYNTAX
       Status XcmsCIELabQueryMaxC(ccc, hueangle, Lstar, colorreturn)
             XcmsCCC ccc;
             XcmsFloat hueangle;
             XcmsFloat Lstar;
             XcmsColor *colorreturn;

       Status XcmsCIELabQueryMaxL(ccc, hueangle, chroma, colorreturn)
             XcmsCCC ccc;
             XcmsFloat hueangle;
             XcmsFloat chroma;
             XcmsColor *colorreturn;

       Status XcmsCIELabQueryMaxLC(ccc, hueangle, colorreturn)
             XcmsCCC ccc;
             XcmsFloat hueangle;
             XcmsColor *colorreturn;

       Status XcmsCIELabQueryMinL(ccc, hueangle, chroma, colorreturn)
             XcmsCCC ccc;
             XcmsFloat hueangle;
             XcmsFloat chroma;
             XcmsColor *colorreturn;

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

       chroma    Specifies the chroma at which to find maximum lightness
                 (MaxL) or minimum lightness (MinL).

       colorreturn
                 Returns the CIE L*a*b* coordinates of maximum chroma (MaxC
                 and MaxLC), maximum lightnes (MaxL), or minimum lightness
                 (MinL) displayable by the screen for the given hue angle
                 and lightness (MaxC), hue angle and chroma (MaxL and MinL),
                 or hue angle (MaxLC).  The white point associated with the
                 returned color specification is the Screen White Point.
                 The value returned in the pixel member is undefined.

       hueangle Specifies the hue angle in degrees at which to find maximum
                 chroma (MaxC and MaxLC), maximum lightness (MaxL), or
                 minimum lightness (MinL).

       Lstar    Specifies the lightness (L*) at which to find maximum
                 chroma (MaxC).

DESCRIPTION
       The 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 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 XcmsFailure return value usually indicates that the
       given chroma is beyond maximum for the given hue angle.

       The 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 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 XcmsFailure return
       value usually indicates that the given chroma is beyond maximum for
       the given hue angle.

SEE ALSO
       XcmsCIELuvQueryMaxC(3X11), XcmsTekHVCQueryMaxC(3X11),
       XcmsQueryBlack(3X11)
       Xlib - C Language X Interface


Licensed material--property of copyright holder(s)