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

XcmsAllocColor()					      XcmsAllocColor()

Name
  XcmsAllocColor  –  allocate  a color specified in device-independent or
  device-dependent form.

Synopsis
  Status XcmsAllocColor(display, colormap, color_in_out, result_format)
	Display *display;
	Colormap colormap;
	XcmsColor *color_in_out;
	XcmsColorFormat result_format;

Arguments
  display   Specifies the connection to the X server.

  colormap  Specifies the colormap.

  color_in_out
	    Specifies the color to allocate and	 returns  the  pixel  and
	    color that is actually used in the colormap.

  result_format
	    Specifies  the  desired  color  format for the returned color
	    specification.

Returns
  Zero on failure, non-zero on success.

Availability
  Release 5 and later.

Description
  The XcmsAllocColor() function is similar to  XAllocColor()  except  the
  color	 can be specified in any format supported by the color management
  system (e.g., CIEXYZ,	 CIELUV,  RGB).	  The  XcmsAllocColor()	 function
  ultimately calls XAllocColor() to allocate a read-only color cell (col‐
  ormap entry) with the specified color.  XcmsAllocColor() first converts
  the  color  specified	 to  an RGB value and then passes this to XAlloc‐
  Color.  XcmsAllocColor() returns the pixel value of the color cell  and
  the color specification actually allocated.  This returned color speci‐
  fication is the result of converting the RGB value returned by  XAlloc‐
  Color()  into	 the  format specified by the result_format argument.  If
  there is no interest in a  returned  color  specification,  unnecessary
  computation  can  be bypassed if result_format is set to XcmsRGBFormat.
  If this routine returns XcmsFailure, the color_in_out color  specifica‐
  tion is left unchanged.

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

Errors
  BadColor  The colormap argument does not name a defined Colormap.

See Also
  XcmsAllocNamedColor(), XcmsLookupColor(), XcmsQueryColor(),  XcmsQuery‐
  Colors(), XcmsStoreNamedColor.

Xlib - Device-independent Color				      XcmsAllocColor()

Vote for polarhome