Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

XcmsConvertColors()					   XcmsConvertColors()

Name
  XcmsConvertColors  –	convert	 color specifications in XcmsColor struc‐
  tures to another color space specific encoding.

Synopsis
  Status XcmsConvertColors(ccc, colors_in_out, ncolors, target_format,
  compression_flags_return)
	XcmsCCC ccc;
	XcmsColor colors_in_out[];
	unsigned int ncolors;
	XcmsColorFormat target_format;
	Bool compression_flags_return[];

Arguments
  ccc	     Specifies the color conversion context.   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.

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

  target_format
	     Specifies the target color specification format.

  compression_flags_return
	     Specifies	an  array of ncolors Boolean values for returning
	     compression status of each color conversion.  If a	 non-NULL
	     pointer  is  supplied,  each  element in the array is set to
	     True if the corresponding color in the  color  specification
	     array was compressed, and False otherwise.	 Pass NULL if the
	     compression status is not useful.

Returns
  Zero on failure, non-zero on success.

Availability
  Release 5 and later.

Description
  The XcmsConvertColors() function converts the color  specifications  in
  the  specified  array of XcmsColor structures from their current format
  (which may vary from element to element of the array) to a single  tar‐
  get  format  using  the  specified CCC.  If all the conversions succeed
  without gamut compression, XcmsConvertColors() returns XcmsSuccess.  If
  one or more of the conversions required gamut compression, the function
  returns XcmsSuccessWithCompression, and sets the appropriate	flags  in
  compression_flags_return  array.   If	 any of the conversions fail, the
  function returns XcmsFailure and the contents of the	color  specifica‐
  tion array are left unchanged.

Structures
  The XcmsColor and XcmsColorFormat structures are shown on the XcmsColor
  reference page.

See Also
  XcmsCCCOfColormap(),	 XcmsCreateCCC(),    XcmsClientWhitePointOfCCC(),
  XcmsDefaultCCC(),    XcmsScreenWhitePointOfCCC(),   XcmsSetCompression‐
  Proc(), XcmsSetWhiteAdjustProc(), XcmsSetWhitePoint().

Xlib - Device-independent Color				   XcmsConvertColors()

Vote for polarhome