XcmsConversionProc()XcmsConversionProc()NameXcmsConversionProc – interface definition for the procedure for color
conversion between device-independent color spaces.
Synopsis
For conversion between device-independent color spaces: typedef Status
(*XcmsConversionProc)(ccc, white_point, colors, ncolors)
XcmsCCC ccc;
XcmsColor *white_point[];
XcmsColor colors[];
unsigned int ncolors;
For conversion between CIEXYZ and device-dependent color spaces:
typedef Status (*XcmsConversionProc)(ccc, colors, ncolors, CIcompres‐
sion_flags_return)
XcmsCCC ccc;
XcmsColor colors[];
unsigned int ncolors;
Bool compression_flags_return[];
Arguments
ccc Specifies the color conversion context.
white_point
Specifies the white point associated with the color specifi‐
cations. Pixel member is ignored and the color specification
is left unchanged upon return.
colors Specifies an array of color specifications. Pixel members
are ignored and remain unchanged upon return.
ncolors Specifies the number of XcmsColor structures in the color
specification array.
compression_flags_return
Specifies an array of Boolean values (or NULL) for returned
information that indicates if the color was compressed. Dur‐
ing conversion, when a color is found to out of gamut, this
argument is passed in the gamut compression function call.
For an example, refer to the source code for XcmsCIEXYZ‐
ToRGBi.
Returns
Zero on failure, non-zero on success.
Availability
Release 5 and later.
Description
An XcmsConversionProc procedure converts XcmsColor between device-inde‐
pendent color space encodings.
Procedures provided and accessible in Xlib for conversion between
device-independent color spaces are:
· XcmsCIELabToCIEXYZ – Converts color specifications from XcmsCIELab
to XcmsCIELab.
· XcmsCIELuvToCIEuvY – Converts color specifications from XcmsCIELuv
to XcmsCIEuvY.
· XcmsCIEXYZToCIELab – Converts color specifications from XcmsCIEXYZ
to XcmsCIELab.
· XcmsCIEXYZToCIEuvY – Converts color specifications from XcmsCIEXYZ
to XcmsCIEuvY.
· XcmsCIEXYZToCIExyY – Converts color specifications from XcmsCIEXYZ
to XcmsCIExyY.
· XcmsCIEuvYToCIELuv – Converts color specifications from XcmsCIEuvY
to XcmsCIELuv.
· XcmsCIEuvYToCIEXYZ – Converts color specifications from XcmsCIEuvY
to XcmsCIEXYZ.
· XcmsCIEuvYToCIETekHVC – Converts color specifications from Xcm‐
sCIEuvY to XcmsCIETekHVC.
· XcmsCIExyYToCIEXYZ – Converts color specifications from XcmsCIExyY
to XcmsCIEXYZ.
· XcmsTekHVCToCIEuvY – Converts color specifications from XcmsTekHVC
to XcmsCIEuvY.
Procedures provided and accessible in Xlib for conversion between
CIEXYZ and device–dependent color spaces are:
· XcmsCIEXYZToRGBi – Converts color specifications from XcmsCIEXYZ to
XcmsRGBi.
· XcmsRGBToRGBi – Converts color specifications from XcmsRGB to Xcm‐
sRGBi.
· XcmsRGBiToCIEXYZ – Converts color specifications from XcmsRGBi to
XcmsCIEXYZ.
· XcmsRGBiToRGB – Converts color specifications from XcmsRGBi to Xcm‐
sRGB.
Structures
The XcmsColor structure and XcmsColorFormat type are shown on the Xcms‐
Color reference page. Refer also to the XcmsColorSpace reference page.
See Also
XcmsColorSpace.
Xlib - Device-independent Color XcmsConversionProc()