9.3.2 Installing Colormaps

The following paragraphs describe the CLX functions to install and uninstall colormaps and to return the set of installed colormaps.

Initially, the default colormap for a screen is installed (but is not in the required list).



install-colormap colormap Function
        
colormap
A colormap.

Installs the colormap. All windows associated with this colormap immediately display with true colors. As a side-effect, additional colormaps might be implicitly uninstalled by the server.

If the specified colormap is not already installed, a :colormap-notify event is generated on every window associated with this colormap. In addition, for every other colormap that is implicitly uninstalled, a :colormap-notify event is generated on every associated window.



installed-colormaps window &key (:result-type 'list) Function
        
window
A window.
:result-type
A sub-type of sequence that indicates the type of sequence to return.

Returns a sequence containing the installed colormaps for the screen of the specified window. The order of the colormaps is not significant.

colormap
Type sequence of colormap.


uninstall-colormap colormap Function
        
colormap
A colormap.

Uninstalls the colormap. However, the colormap is not actually uninstalled if this would reduce the set of installed colormaps below the value of screen-min-installed-maps. If the colormap is actually uninstalled, a :colormap-notify event is generated on every associated window.