1
.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1994, 1996 X Consortium
3
.\" Permission is hereby granted, free of charge, to any person obtaining
4
.\" a copy of this software and associated documentation files (the
5
.\" "Software"), to deal in the Software without restriction, including
6
.\" without limitation the rights to use, copy, modify, merge, publish,
7
.\" distribute, sublicense, and/or sell copies of the Software, and to
8
.\" permit persons to whom the Software is furnished to do so, subject to
9
.\" the following conditions:
11
.\" The above copyright notice and this permission notice shall be included
12
.\" in all copies or substantial portions of the Software.
14
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17
.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
18
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20
.\" OTHER DEALINGS IN THE SOFTWARE.
22
.\" Except as contained in this notice, the name of the X Consortium shall
23
.\" not be used in advertising or otherwise to promote the sale, use or
24
.\" other dealings in this Software without prior written authorization
25
.\" from the X Consortium.
27
.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991 by
28
.\" Digital Equipment Corporation
30
.\" Portions Copyright \(co 1990, 1991 by
33
.\" Permission to use, copy, modify and distribute this documentation for
34
.\" any purpose and without fee is hereby granted, provided that the above
35
.\" copyright notice appears in all copies and that both that copyright notice
36
.\" and this permission notice appear in all copies, and that the names of
37
.\" Digital and Tektronix not be used in in advertising or publicity pertaining
38
.\" to this documentation without specific, written prior permission.
39
.\" Digital and Tektronix makes no representations about the suitability
40
.\" of this documentation for any purpose.
41
.\" It is provided ``as is'' without express or implied warranty.
43
.\" $XFree86: xc/doc/man/X11/XcmsLaQMC.man,v 1.3 2001/02/09 03:47:47 tsi Exp $
45
.ds xT X Toolkit Intrinsics \- C Language Interface
46
.ds xW Athena X Widgets \- C Language X Toolkit Interface
47
.ds xL Xlib \- C Language X Interface
48
.ds xC Inter-Client Communication Conventions Manual
55
.\".if \\n(VS>=40 .vs \\n(VSu
56
.\".if \\n(VS<=39 .vs \\n(VSp
79
.de IN \" send an index entry to the stderr
86
.\" choose appropriate monospace font
87
.\" the imagen conditional, 480,
88
.\" may be changed to L if LB is too
89
.\" heavy for your eyes...
91
.ie "\\*(.T"480" .ft L
92
.el .ie "\\*(.T"300" .ft L
93
.el .ie "\\*(.T"202" .ft PO
94
.el .ie "\\*(.T"aps" .ft CW
97
.ie \\n(VS>40 .vs \\n(VSu
105
.ie t \\$1\fB\^\\$2\^\fR\\$3
106
.el \\$1\fI\^\\$2\^\fP\\$3
109
.ie t \fB\^\\$1\^\fR\\$2
110
.el \fI\^\\$1\^\fP\\$2
113
.ie t <\fB\\$1\fR>\\$2
119
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
120
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
134
. \" Note End -- doug kraft 3/85
143
.TH XcmsCIELabQueryMax 3X11 __xorgversion__ "XLIB FUNCTIONS"
145
XcmsCIELabQueryMaxC, XcmsCIELabQueryMaxL, XcmsCIELabQueryMaxLC, XcmsCIELabQueryMinL \- obtain the CIE L*a*b* coordinates
147
Status XcmsCIELabQueryMaxC\^(\^\fIccc\fP\^, \fIhue_angle\fP\^, \fIL_star\fP\^, \fIcolor_return\fP\^)
151
XcmsFloat \fIhue_angle\fP\^;
153
XcmsFloat \fIL_star\fP\^;
155
XcmsColor *\fIcolor_return\fP\^;
157
Status XcmsCIELabQueryMaxL\^(\^\fIccc\fP\^, \fIhue_angle\fP\^, \fIchroma\fP\^, \fIcolor_return\fP\^)
161
XcmsFloat \fIhue_angle\fP\^;
163
XcmsFloat \fIchroma\fP\^;
165
XcmsColor *\fIcolor_return\fP\^;
167
Status XcmsCIELabQueryMaxLC\^(\^\fIccc\fP\^, \fIhue_angle\fP\^, \fIcolor_return\fP\^)
171
XcmsFloat \fIhue_angle\fP\^;
173
XcmsColor *\fIcolor_return\fP\^;
175
Status XcmsCIELabQueryMinL\^(\^\fIccc\fP\^, \fIhue_angle\fP\^, \fIchroma\fP\^, \fIcolor_return\fP\^)
179
XcmsFloat \fIhue_angle\fP\^;
181
XcmsFloat \fIchroma\fP\^;
183
XcmsColor *\fIcolor_return\fP\^;
187
Note that the CCC's Client White Point and White Point Adjustment procedures
189
.ds Ch maximum lightness (MaxL) or minimum lightness (MinL)
191
Specifies the chroma at which to find \*(Ch.
192
.ds Lc maximum chroma (MaxC and MaxLC), maximum lightnes (MaxL),
193
or minimum lightness (MinL)
194
.ds lC hue angle and lightness (MaxC), hue angle and chroma (MaxL and MinL),
196
.IP \fIcolor_return\fP 1i
197
Returns the CIE L*a*b* coordinates of \*(Lc
198
displayable by the screen for the given \*(lC.
199
The white point associated with the returned
200
color specification is the Screen White Point.
201
The value returned in the pixel member is undefined.
202
.ds Ha maximum chroma (MaxC and MaxLC), maximum lightness (MaxL),
203
or minimum lightness (MinL)
204
.IP \fIhue_angle\fP 1i
205
Specifies the hue angle (in degrees) at which to find \*(Ha.
206
.ds Ls maximum chroma (MaxC)
208
Specifies the lightness (L*) at which to find \*(Ls.
211
.ZN XcmsCIELabQueryMaxC
212
function, given a hue angle and lightness,
213
finds the point of maximum chroma displayable by the screen.
214
It returns this point in CIE L*a*b* coordinates.
217
.ZN XcmsCIELabQueryMaxL
218
function, given a hue angle and chroma,
219
finds the point in CIE L*a*b* color space of maximum
220
lightness (L*) displayable by the screen.
221
It returns this point in CIE L*a*b* coordinates.
224
return value usually indicates that the given chroma
225
is beyond maximum for the given hue angle.
228
.ZN XcmsCIELabQueryMaxLC
229
function, given a hue angle,
230
finds the point of maximum chroma displayable by the screen.
231
It returns this point in CIE L*a*b* coordinates.
234
.ZN XcmsCIELabQueryMinL
235
function, given a hue angle and chroma,
236
finds the point of minimum lightness (L*) displayable by the screen.
237
It returns this point in CIE L*a*b* coordinates.
240
return value usually indicates that the given chroma
241
is beyond maximum for the given hue angle.
243
XcmsCIELuvQueryMaxC(3X11),
244
XcmsTekHVCQueryMaxC(3X11),