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


NAME
       XcmsConvertColors - convert CCC color specifications

SYNTAX
       Status XcmsConvertColors(ccc, colorsinout, ncolors,
       targetformat, compressionflagsreturn)
             XcmsCCC ccc;
             XcmsColor colorsinout[];
             unsigned int ncolors;
             XcmsColorFormat targetformat;
             Bool compressionflagsreturn[];

ARGUMENTS
       ccc       Specifies the CCC.  If Conversion is between
                 device-independent color spaces only (for exam-
                 ple, TekHVC to CIELuv), the CCC is necessary
                 only to specify the Client White Point.

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

       compressionflagsreturn
                 Specifies an array of Boolean values for return-
                 ing compression status.  If a non-NULL pointer
                 is supplied, each element of the array is set to
                 True if the corresponding color was compressed,
                 and False otherwise.  Pass NULL if the compres-
                 sion status is not useful.

       ncolors   Specifies the number of XcmsColor structures in
                 the color specification array.

       targetformat
                 Specifies the target color specification format.

DESCRIPTION
       The XcmsConvertColors function converts the color specifi-
       cations 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, ...).  Note
       that when the array contains both device-independent and
       device-dependent color specifications, and the tar-
       get_format argument specifies a device-dependent format
       (for example, XcmsRGBiFormat, XcmsRGBFormat) all specifi-
       cations are converted to CIE XYZ format then to the target
       device-dependent format.




X Version 11                Release 5                           1

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


SEE ALSO
       DisplayOfCCC(3X11), XcmsCCCofColormap(3X11), XcmsCreate-
       CCC(3X11), XcmsDefaultCCC(3X11), XcmsSetWhitePoint(3X11)
       Xlib - C Language X Interface





















































X Version 11                Release 5                           2