XcmsTekHVCQueryMaxVSamples() XcmsTekHVCQueryMaxVSamples()
Name
XcmsTekHVCQueryMaxVSamples - return the boundaries of the TekHVC gamut for a
given Hue.
Synopsis
Status XcmsTekHVCQueryMaxVSamples(ccc, hue, colors_return, nsamples)
XcmsCCC ccc;
XcmsFloat hue;
XcmsColor colors_return[];
unsigned int nsamples;
Arguments
ccc Specifies the color conversion context. Note that the CCC's Client White Point and White Point Adjustment procedures are
ignored.
hue Specifies the Hue at which to find the maximum Chroma/Value samples.
colors_return
Specifies an array of nsamples XcmsColor structures into which the returned color specifications will be stored.
nsamples Specifies the number of samples.
Returns
Zero on failure, non-zero on success.
Availability
Release 5 and later.
Description
For the specified Hue, XcmsTekHVCQueryMaxVSamples() partitions the legal values of Chroma into nsamples samples, and queries the maximum
Value for the Hue and each Chroma sample. The resulting values are stored into the elements of the colors_return array. This function can
be used to plot the upper boundary of the TekHVC device gamut for a given Hue.
Structures
The XcmsColor structure and XcmsColorFormat type are shown on the XcmsColor reference page.
See Also
XcmsTekHVCQueryMaxC(), XcmsTekHVCQueryMaxV(), XcmsTekHVCQueryMaxVC(), XcmsTekHVCQueryMinV().
Xlib - Device-independent Color XcmsTekHVCQueryMaxVSamples()
Check Out this Related Man Page
XcmsTekHVCQueryMaxC(3X11) XLIB FUNCTIONS XcmsTekHVCQueryMaxC(3X11)NAME
XcmsTekHVCQueryMaxC, XcmsTekHVCQueryMaxV, XcmsTekHVCQueryMaxVC, XcmsTekHVCQueryMaxVSamples, XcmsTekHVCQueryMinV - obtain the TekHVC coordi-
nates
SYNTAX
Status XcmsTekHVCQueryMaxC(ccc, hue, value, color_return)
XcmsCCC ccc;
XcmsFloat hue;
XcmsFloat value;
XcmsColor *color_return;
Status XcmsTekHVCQueryMaxV(ccc, hue, chroma, color_return)
XcmsCCC ccc;
XcmsFloat hue;
XcmsFloat chroma;
XcmsColor *color_return;
Status XcmsTekHVCQueryMaxVC(ccc, hue, color_return)
XcmsCCC ccc;
XcmsFloat hue;
XcmsColor *color_return;
Status XcmsTekHVCQueryMaxVSamples(ccc, hue, colors_return, nsamples)
XcmsCCC ccc;
XcmsFloat hue;
XcmsColor colors_return[];
unsigned int nsamples;
Status XcmsTekHVCQueryMinV(ccc, hue, chroma, color_return)
XcmsCCC ccc;
XcmsFloat hue;
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 Value (MaxV).
colors_return
Returns nsamples of color specifications in XcmsTekHVC such that the Chroma is the maximum attainable for the Value and Hue. The
white point associated with the returned color specification is the Screen White Point. The value returned in the pixel member
is undefined. maximum Value along with the Hue and Chroma (MaxV), color specification in XcmsTekHVC for the maximum Chroma, the
Value at which that maximum Chroma is reached and actual Hue (MaxVC) or minimum Value and the actual Hue and Chroma (MinL) mini-
mum Value (MinL)
color_return
Returns the maximum Chroma along with the actual Hue and Value (MaxC), at which the maximum Chroma (MaxC and MaxVC), maximum
Value (MaxV), or was found. The white point associated with the returned color specification is the Screen White Point. The
value returned in the pixel member is undefined. maximum Value (MaxV), the maximum Chroma/Value samples (MaxVSamples), or the
minimum Value (MinL)
hue Specifies the Hue in which to find the maximum Chroma (MaxC and MaxVC),.
nsamples Specifies the number of samples.
value Specifies the Value in which to find the maximum Chroma (MaxC) or minimum Value (MinL).
DESCRIPTION
The XcmsTekHVCQueryMaxC function, given a Hue and Value, determines the maximum Chroma in TekHVC color space displayable by the screen. It
returns the maximum Chroma along with the actual Hue and Value at which the maximum Chroma was found.
The XcmsTekHVCQueryMaxV function, given a Hue and Chroma, determines the maximum Value in TekHVC color space displayable by the screen. It
returns the maximum Value and the actual Hue and Chroma at which the maximum Value was found.
The XcmsTekHVCQueryMaxVC function, given a Hue, determines the maximum Chroma in TekHVC color space displayable by the screen and the Value
at which that maximum Chroma is reached. It returns the maximum Chroma, the Value at which that maximum Chroma is reached, and the actual
Hue for which the maximum Chroma was found.
The XcmsTekHVCQueryMaxVSamples returns nsamples of maximum Value, the Chroma at which that maximum Value is reached, and the actual Hue for
which the maximum Chroma was found. These sample points may then be used to plot the maximum Value/Chroma boundary of the screen's color
gamut for the specified Hue in TekHVC color space.
The XcmsTekHVCQueryMinV function, given a Hue and Chroma, determines the minimum Value in TekHVC color space displayable by the screen. It
returns the minimum Value and the actual Hue and Chroma at which the minimum Value was found.
SEE ALSO XcmsCIELabQueryMaxC(3X11), XcmsCIELuvQueryMaxC(3X11), XcmsQueryBlack(3X11)
Xlib - C Language X Interface
X Version 11 Release 6.6 XcmsTekHVCQueryMaxC(3X11)