XcmsCIELabQueryMaxC(XS)  X Version 11 (Release 5)    XcmsCIELabQueryMaxC(XS)
                                6 January 1993


 Name

    XcmsCIELabQueryMaxC - obtain the CIE L*a*b* coordinates

 Syntax


    Status XcmsCIELabQueryMaxC(ccc, hue_angle, L_star, color_return)
          XcmsCCC ccc;
          XcmsFloat hue_angle;
          XcmsFloat L_star;
          XcmsColor *color_return;

    Status XcmsCIELabQueryMaxL(ccc, hue_angle, chroma, color_return)
          XcmsCCC ccc;
          XcmsFloat hue_angle;
          XcmsFloat chroma;
          XcmsColor *color_return;

    Status XcmsCIELabQueryMaxLC(ccc, hue_angle, color_return)
          XcmsCCC ccc;
          XcmsFloat hue_angle;
          XcmsColor *color_return;

    Status XcmsCIELabQueryMinL(ccc, hue_angle, chroma, color_return)
          XcmsCCC ccc;
          XcmsFloat hue_angle;
          XcmsFloat chroma;
          XcmsColor *color_return;


 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 lightness (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 mini-
                 mum 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 usu-
    ally indicates that the given chroma is beyond maximum for the given hue
    angle.

 See also

    XcmsCIELuvQueryMaxC(XS), XcmsTekHVCQueryMaxC(XS), XcmsQueryBlack(XS)
    Xlib - C Language X Interface