unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Page:
Section:
Apropos / Subsearch:
optional field

XcmsConvertColors(3)            XLIB FUNCTIONS            XcmsConvertColors(3)



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), Xcms-
       DefaultCCC(3X11), XcmsSetWhitePoint(3X11)
       Xlib - C Language X Interface



X Version 11                     libX11 1.1.5             XcmsConvertColors(3)