XcmsConvertColors.3X11.z(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-



     Licensed material--property of copyright holder(s)         Page 1



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



          dependent format.

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
















































     Licensed material--property of copyright holder(s)         Page 2

Museum