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()