XFreeColormap

Syntax

XFreeColormap(display, colormap)
      Display *display;
      Colormap colormap;

Arguments

display Specifies the connection to the X server.
colormap Specifies the colormap that you want to destroy.

Description

The XFreeColormap() function deletes the association between the colormap resource ID and the colormap and frees the colormap storage. However, this function has no effect on the default colormap for a screen. If the specified colormap is an installed map for a screen, it is uninstalled (see XUninstallColormap()). If the specified colormap is defined as the colormap for a window (by XCreateWindow(), XSetWindowColormap(), or XChangeWindowAttributes()), XFreeColormap() changes the colormap associated with the window to None and generates a ColormapNotify event. X does not define the colors displayed for a window with a colormap of None .

XFreeColormap() can generate a BadColor error.

Diagnostics

BadColor A value for a Colormap argument does not name a defined Colormap.

See also

XAllocColor(), XChangeWindowAttributes(), XCopyColormapAndFree(), XCreateColormap(), XCreateWindow(), XQueryColor(), XStoreColors(), "Creating, Copying, and Destroying Colormaps".
Christophe Tronche, ch@tronche.com