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

XCopyColormapAndFree()					XCopyColormapAndFree()

Name
  XCopyColormapAndFree – copy a colormap and return a new colormap ID.

Synopsis
  Colormap XCopyColormapAndFree(display, colormap)
	Display *display;
	Colormap colormap;

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

  colormap  Specifies the colormap you are moving out of.

Returns
  The created colormap.

Description
  XCopyColormapAndFree() is used to obtain a new  virtual  colormap  when
  allocating  colorcells  out  of  a  previous colormap has failed due to
  resource exhaustion (that is, too many cells or planes were in  use  in
  the  original colormap).  The visual and screen for the new colormap is
  the same as for the old.

  XCopyColormapAndFree() moves all of the client's  existing  allocations
  from	colormap  to  the returned Colormap.  The read/write or read-only
  characteristics of each cell moved are preserved in the new colormap.

  If colormap was created by the client with the alloc	argument  set  to
  AllocAll,  the  new  colormap	 is also created with AllocAll, all color
  values for all entries are copied from colormap, and then  all  entries
  in colormap are freed.

  If colormap was created by the client with AllocNone, or not created by
  the client, the allocations to be moved are all those pixels and planes
  that	have been allocated by the client using XAllocColor, XAllocNamed‐
  Color(), XAllocColorCells(), or XAllocColorPlanes() and that	have  not
  been	freed  since they were allocated.  Values in other entries of the
  new Colormap are undefined.

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

Errors
  BadAlloc

  BadColor  colormap is invalid.

See Also
  XDefaultColormap(),	XDisplayCells(),   XCreateColormap(),	XFreeCol‐
  ormap(), XGetStandardColormap(), XInstallColormap(), XListInstalledCol‐
  ormaps(), XSetStandardColormap(), XSetWindowColormap(),  XUninstallCol‐
  ormap().

Xlib - Colormaps					XCopyColormapAndFree()

Vote for polarhome