XcmsConvers(3x) — HPUX 9.05

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

cccSpecifies the CCC.

white_point
Specifies the white point associated with the color specifications. Pixel member is ignored and the color specification is left unchanged upon return.

colorsSpecifies an array of color specifications. Pixel members are ignored and remain unchanged upon return.

ncolorsSpecifies 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 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 XcmsCIEXYZToRGBi.

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:

•XcmsCIELabToCIEXYZ - Converts color specifications from WXcmsCIELab 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 XcmsCIEuvY 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 XcmsRGBi.

•XcmsRGBiToCIEXYZ - Converts color specifications from XcmsRGBi to XcmsCIEXYZ.

•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.