XcmsConvertColors

XcmsConvertColors(3X11)		XLIB FUNCTIONS	      XcmsConvertColors(3X11)



NAME
       XcmsConvertColors - convert CCC color specifications

SYNTAX
       Status XcmsConvertColors(XcmsCCC ccc, XcmsColor colors_in_out[],
	      unsigned int ncolors, XcmsColorFormat target_format, Bool com-
	      pression_flags_return[]);

ARGUMENTS
       ccc	 Specifies the CCC.  If Conversion is between device-indepen-
		 dent color spaces only (for example, 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 com-
		 pressed and False otherwise.  Pass NULL if the compression
		 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 specifications 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_format argument specifies a device-dependent format (for
       example, XcmsRGBiFormat, XcmsRGBFormat), all specifications are con-
       verted to CIE XYZ format and then to the target device-dependent for-
       mat.

SEE ALSO
       DisplayOfCCC(3X11), XcmsCCCOfColormap(3X11), XcmsCreateCCC(3X11),
       XcmsDefaultCCC(3X11), XcmsSetWhitePoint(3X11)
       Xlib - C Language X Interface



						      XcmsConvertColors(3X11)