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

XFreeColors()							 XFreeColors()

Name
  XFreeColors – free colormap cells or planes.

Synopsis
  XFreeColors(display, colormap, pixels, npixels, planes)
	Display *display;
	Colormap colormap;
	unsigned long pixels[];
	int npixels;
	unsigned long planes;

Arguments
  display   Specifies	a  connection  to  an  X  server;  returned  from
	    XOpenDisplay().

  colormap  Specifies the colormap.

  pixels    Specifies an array of pixel values.

  npixels   Specifies the number of pixels.

  planes    Specifies the planes you want to free.

Description
  XFreeColors() frees the  cells  whose	 values	 are  computed	by  ORing
  together  subsets  of	 the planes argument with each pixel value in the
  pixels array.

  If the cells are read/write, they become available  for  reuse,  unless
  they	were  allocated	 with  XAllocColorPlanes(), in which case all the
  related pixels may need to be freed before any become available.

  If the cells were read-only, they become available only if this is  the
  last client to have allocated those shared cells.

  For more information, see Volume One, Chapter 7, Color.

Errors
  BadAccess Attempt  to	 free  a  colorcell  not allocated by this client
	    (either unallocated or allocated by another client).

  BadColor  colormap is invalid.

  BadValue  A pixel value is not a valid index into colormap.

  Note:	 if more than one pixel value is in error, the	one  reported  is
  arbitrary.

See Also
  XBlackPixel(),  XWhitePixel(),  XAllocColor(), XAllocColorCells(), XAl‐
  locColorPlanes(),  XAllocNamedColor(),  XLookupColor(),  XParseColor(),
  XQueryColor(),  XQueryColors(),  XStoreColor(), XStoreColors(), XStore‐
  NamedColor().

Xlib - Color Cells						 XFreeColors()

Vote for polarhome