XcmsConvertColors(3X11)     X Version 11(Release 5)     XcmsConvertColors(3X11)


NAME
      XcmsConvertColors - convert CCC color specifications

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

ARGUMENTS
      ccc       Specifies the CCC.  If Conversion is between device-independent
                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
                Specifies an array of Boolean values for returning 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 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, ...).  Note that 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 converted
      to CIE XYZ format then to the target device-dependent format.

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


10/89                                                                    Page 1