XcmsConversionProc() XcmsConversionProc()
Name
XcmsConversionProc - 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, CIcompression_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 specifications. 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. During con-
version, 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 XcmsCIEXYZToRGBi.
Returns
Zero on failure, non-zero on success.
Availability
Release 5 and later.
Description
An XcmsConversionProc procedure converts XcmsColor between device-independent color space encodings.
Procedures provided and accessible in Xlib for conversion between device-independent color spaces are:
o XcmsCIELabToCIEXYZ - Converts color specifications from XcmsCIELab to XcmsCIELab.
o XcmsCIELuvToCIEuvY - Converts color specifications from XcmsCIELuv to XcmsCIEuvY.
o XcmsCIEXYZToCIELab - Converts color specifications from XcmsCIEXYZ to XcmsCIELab.
o XcmsCIEXYZToCIEuvY - Converts color specifications from XcmsCIEXYZ to XcmsCIEuvY.
o XcmsCIEXYZToCIExyY - Converts color specifications from XcmsCIEXYZ to XcmsCIExyY.
o XcmsCIEuvYToCIELuv - Converts color specifications from XcmsCIEuvY to XcmsCIELuv.
o XcmsCIEuvYToCIEXYZ - Converts color specifications from XcmsCIEuvY to XcmsCIEXYZ.
o XcmsCIEuvYToCIETekHVC - Converts color specifications from XcmsCIEuvY to XcmsCIETekHVC.
o XcmsCIExyYToCIEXYZ - Converts color specifications from XcmsCIExyY to XcmsCIEXYZ.
o XcmsTekHVCToCIEuvY - Converts color specifications from XcmsTekHVC to XcmsCIEuvY.
Procedures provided and accessible in Xlib for conversion between CIEXYZ and device-dependent color spaces are:
o XcmsCIEXYZToRGBi - Converts color specifications from XcmsCIEXYZ to XcmsRGBi.
o XcmsRGBToRGBi - Converts color specifications from XcmsRGB to XcmsRGBi.
o XcmsRGBiToCIEXYZ - Converts color specifications from XcmsRGBi to XcmsCIEXYZ.
o XcmsRGBiToRGB - Converts color specifications from XcmsRGBi to XcmsRGB.
Structures
The XcmsColor structure and XcmsColorFormat type are shown on the XcmsColor reference page. Refer also to the XcmsColorSpace reference
page.
See Also
XcmsColorSpace.
Xlib - Device-independent Color XcmsConversionProc()
