plucky (3) XcmsCIELuvQueryMaxC.3.gz

NAME

       XcmsCIELuvQueryMaxC,  XcmsCIELuvQueryMaxL,  XcmsCIELuvQueryMaxLC,  XcmsCIELuvQueryMinL  -  obtain the CIE
       L*u*v* coordinates

SYNTAX

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

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

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

       Status XcmsCIELuvQueryMinL(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).

       color_return
                 Returns  the  CIE  L*u*v*  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.

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

       L_star    Specifies the lightness (L*) at which to  find  maximum  chroma  (MaxC)  or  maximum  lightness
                 (MaxL).

DESCRIPTION

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

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

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

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

SEE ALSO

       XcmsCIELabQueryMaxC(3), XcmsTekHVCQueryMaxC(3), XcmsQueryBlack(3)
       Xlib - C Language X Interface