NAME

XFreeColormap − delete a colormap and install the default colormap. 

Synopsis

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

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

colormapSpecifies 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:

•If colormap is an installed map for a screen, it uninstalls the colormap (see XUninstallColormap()). 

•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

BadColorInvalid colormap. 

See Also

DefaultColormap(), DisplayCells(), XCopyColormapAndFree(), XCreateColormap(), XGetStandardColormap(), XInstallColormap(), XListInstalledColormaps(), XSetStandardColormap(), XSetWindowColormap(), XUninstallColormap(). 

Copyright O’Reilly & Assoc.  —