---
name: "XcmsConvertColors"
section: "3"
platform: "linux"
package: "libx11"
version: "1.8.14-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XcmsConvertColors"
---

# XcmsConvertColors(3)

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**(3)](/DisplayOfCCC/3.md), [**XcmsCCCOfColormap**(3)](/XcmsCCCOfColormap/3.md), [**XcmsCreateCCC**(3)](/XcmsCreateCCC/3.md), [**XcmsDefaultCCC**(3)](/XcmsDefaultCCC/3.md), [**XcmsSetWhitePoint**(3)](/XcmsSetWhitePoint/3.md)\
 *Xlib - C Language X Interface*