XcmsConvertColors(3X11) XLIB FUNCTIONS XcmsConvertColors(3X11)NAMEXcmsConvertColors - convert CCC color specifications
SYNTAX
Status XcmsConvertColors(ccc, colors_in_out, ncolors,
target_format, compression_flags_return)
XcmsCCC ccc;
XcmsColor colors_in_out[];
unsigned int ncolors;
XcmsColorFormat target_format;
Bool compression_flags_return[];
ARGUMENTS
ccc Specifies the CCC. If Conversion is between
device-independent color spaces only (for exam-
ple, TekHVC to CIELuv), the CCC is necessary
only to specify the Client White Point.
colors_in_out
Specifies an array of color specifications.
Pixel members are ignored and remain unchanged
upon return.
compression_flags_return
Returns an array of Boolean values indicating
compression status. If a non-NULL pointer is
supplied, each element of the array is set to
True if the corresponding color was compressed
and False otherwise. Pass NULL if the compres-
sion status is not useful.
ncolors Specifies the number of XcmsColor structures in
the color-specification array.
target_format
Specifies the target color specification format.
DESCRIPTION
The XcmsConvertColors function converts the color specifi-
cations in the specified array of XcmsColor structures
from their current format to a single target format, using
the specified CCC. When the return value is XcmsFailure,
the contents of the color specification array are left
unchanged.
The array may contain a mixture of color specification
formats (for example, 3 CIE XYZ, 2 CIE Luv, and so on).
When the array contains both device-independent and
device-dependent color specifications and the target_for-
mat argument specifies a device-dependent format (for
example, XcmsRGBiFormat, XcmsRGBFormat), all specifica-
tions are converted to CIE XYZ format and then to the tar-
get device-dependent format.
X Version 11 Release 6.4 1
XcmsConvertColors(3X11) XLIB FUNCTIONS XcmsConvertColors(3X11)SEE ALSODisplayOfCCC(3X11), XcmsCCCOfColormap(3X11), XcmsCreate-
CCC(3X11), XcmsDefaultCCC(3X11), XcmsSetWhitePoint(3X11)
Xlib - C Language X Interface
X Version 11 Release 6.4 2