XFreeColormap()XFreeColormap()NameXFreeColormap – 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.
DescriptionXFreeColormap() destroys the specified colormap, unless it is the
default colormap for a screen. That is, it not only uninstalls col‐
ormap 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 col‐
ormap (see XUninstallColormap()).
· If colormap is defined as the colormap attribute for a window (by
XCreateWindow() or XChangeWindowAttributes()), it changes the col‐
ormap 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 col‐
ormap is normally used.
For more information, see Volume One, Chapter 7, Color.
Errors
BadColor Invalid colormap.
See AlsoXDefaultColormap(), XDisplayCells(), XCopyColormapAndFree(), XCreate‐
Colormap(), XGetStandardColormap(), XInstallColormap(), XListInstalled‐
Colormaps(), XSetStandardColormap(), XSetWindowColormap(), XUninstall‐
Colormap().
Xlib - Colormaps XFreeColormap()