Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xcmsconvertcolors(3) [centos man page]

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 compres- sion_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), XcmsCCCOfColormap(3), XcmsCreateCCC(3), XcmsDefaultCCC(3), XcmsSetWhitePoint(3) Xlib - C Language X Interface X Version 11 libX11 1.6.0 XcmsConvertColors(3)

Check Out this Related Man Page

XcmsCompressionProc()													     XcmsCompressionProc()

Name
  XcmsCompressionProc - interface definition for gamut compression procedure.

Synopsis
  typedef Status (*XcmsCompressionProc)(ccc, colors_in_out, ncolors, index, compression_flags_return)
	   XcmsCCC ccc;
	   XcmsColor colors_in_out[];
	   unsigned int ncolors;
	   unsigned int index;
	   Bool compression_flags_return[];

Arguments
  ccc	    Specifies the color conversion context.

  colors_in_out
	    Specifies an array of color specifications.  Pixel members are ignored and remain unchanged upon return.

  ncolors   Specifies the number of XcmsColor structures in the color specification array.

  index     Specifies the index into the array of XcmsColor structures for the encountered color specification that lies outside the Screen's
	    color gamut.  Valid values are 0 (for the first element) to ncolors-1.

  compression_flags_return
	    Specifies an array of Boolean values (or NULL) for returned information that indicates if the color was compressed.  For example,
	    if		 this	       routine		returns 	 XcmsSuccessWithCompression,	      and	   compression_flags_
	    return[3] is True, this indicates that the fourth color specified in the color specification array was compressed.	 If  you  are
	    not interested in knowing which color was compressed when the return value is XcmsSuccessWithCompression, then pass a NULL.  Oth-
	    erwise, allocate an array of Boolean values for each element in the color definition array and pass its address.

Returns
  Zero on failure, non-zero on success.

Availability
  Release 5 and later.

Description
  A gamut compression procedure maps a range of colors in a device-independent color space into a range of colors displayable on  a  physical
  device.

  When implementing a gamut compression procedure, consider the following rules and assumptions:

  o  The gamut compression procedure can attempt to compress one or multiple specifications at a time.

  o  When called, elements 0 to index-1 in the array of color specification array can be assumed to fall within the screen's color gamut.  In
     addition these color specifications are already in some device-dependent format (typically XcmsRGBi).  If any modifications are made  to
     these color specifications, they must upon return be in their initial device-dependent format.

  o  When  called,  the element in the color specification array specified by the index argument contains the color specification outside the
     screen's color gamut encountered by the calling routine.  In addition this color specification can be assumed to be in XcmsCIEXYZ.  Upon
     return, this color specification must be in XcmsCIEXYZ.

  o  When  called, elements from index to ncolors-1 in the color specification array may or may not fall within the screen's color gamut.  In
     addition these color specifications can be assumed to be in XcmsCIEXYZ.  If any modifications are made to	these  color  specifications,
     they must upon return be in XcmsCIEXYZ.

  o  The  color  specifications  passed  to the gamut compression procedure have already been adjusted to the Screen White Point.  This means
     that at this point the color specification's white point is the Screen White Point.

  o  If the gamut compression procedure uses a device-independent color space not initially accessible for use in the color  management  sys-
     tem, use XcmsAddColorSpace() to insure that it is added.

See Also
  XcmsCCCOfColormap(),	XcmsCreateCCC(),  XcmsClientWhitePointOfCCC(),	XcmsDefaultCCC(),  XcmsSetCCCOfColormap(),  XcmsSetCompressionProc(),
  XcmsSetWhiteAdjustProc(), XcmsSetWhitePoint().

Xlib - Device-independent Color 											     XcmsCompressionProc()
Man Page

Featured Tech Videos