---
name: "XcmsConvertColors"
section: "3x"
platform: "linux"
package: "libx11-dev"
version: "4.3.0.dfsg.1-14sarge7"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/XcmsConvertColors/3x"
---

# XcmsConvertColors(3x)

convert CCC color specifications

## NAME

XcmsConvertColors - convert CCC color specifications

## SYNTAX

Status XcmsConvertColors(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*

  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 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, 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 converted to CIE XYZ format and then to the target device-dependent format.

## SEE ALSO

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