XFreeColormap() XFreeColormap()
Name
XFreeColormap - delete a colormap and install the default colormap.
Synopsis
XFreeColormap(display, colormap)
Display *display;
Colormap colormap;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
colormap Specifies the colormap to delete.
Description
XFreeColormap() destroys the specified colormap, unless it is the default colormap for a screen. That is, it not only uninstalls colormap
from the hardware colormap if it is installed, but also frees the associated memory including the colormap ID.
XFreeColormap() performs the following processing:
o If colormap is an installed map for a screen, it uninstalls the colormap (see XUninstallColormap()).
o If colormap is defined as the colormap attribute for a window (by XCreateWindow() or XChangeWindowAttributes()), it changes the colormap
attribute for the window to the constant None, generates a ColormapNotify event, and frees the colormap. The colors displayed with a
colormap of None are server-dependent, since the default colormap is normally used.
For more information, see Volume One, Chapter 7, Color.
Errors
BadColor Invalid colormap.
See Also
XDefaultColormap(), XDisplayCells(), XCopyColormapAndFree(), XCreateColormap(), XGetStandardColormap(), XInstallColormap(), XListInstalled-
Colormaps(), XSetStandardColormap(), XSetWindowColormap(), XUninstallColormap().
Xlib - Colormaps XFreeColormap()
