XcmsConvertColors (3) Linux Manual Page
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
Trueif the corresponding color was compressed andFalseotherwise. Pass NULL if the compression status is not useful. - ncolors
- Specifies the number of
XcmsColorstructures 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), XcmsCCCOfColormap(3), XcmsCreateCCC(3), XcmsDefaultCCC(3), XcmsSetWhitePoint(3)
Xlib – C Language X Interface