NAME

XmuAllStandardColormaps — create all supported standard colormaps and set standard colormap properties. 

SYNOPSIS

#include <X11/Xmu/StdCmap.h>

Status XmuAllStandardColormaps(display)
      Display ∗display;

ARGUMENTS

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

DESCRIPTION

XmuAllStandardColormaps creates all of the appropriate standard colormaps for every visual of every screen on a given display. 

XmuAllStandardColormaps defines and retains as permanent resources all these standard colormaps.  It returns zero on failure, non-zero on success.  If the property of any standard colormap is already defined, this function will redefine it. 

This function is intended to be used by window managers or a special client at the start of a session. 

The standard colormaps of a screen are defined by properties associated with the screen’s root window.  The property names of standard colormaps are predefined, and each property name except RGB_DEFAULT_MAP may describe at most one colormap. 

The standard colormaps are: RGB_BEST_MAP, RGB_RED_MAP, RGB_GREEN_MAP, RGB_BLUE_MAP, RGB_DEFAULT_MAP, and RGB_GRAY_MAP.  Therefore a screen may have at most 6 standard colormap properties defined. 

A standard colormap is associated with a particular visual of the screen.  A screen may have multiple visuals defined, including visuals of the same class at different depths.  Note that a visual ID might be repeated for more than one depth, so the visual ID and the depth of a visual identify the visual.  The characteristics of the visual will determine which standard colormaps are meaningful under that visual, and will determine how the standard colormap is defined.  Because a standard colormap is associated with a specific visual, there must be a method of determining which visuals take precedence in defining standard colormaps. 

The method used here is: for the visual of greatest depth, define all standard colormaps meaningful to that visual class, according to this order of (descending) precedence: DirectColor; PseudoColor; TrueColor; and GrayScale; and finally StaticColor and StaticGray. 

This function allows success on a per screen basis.  For example, if a map on screen 1 fails, the maps on screen 0, created earlier, will remain.  However, none on screen 1 will remain.  If a map on screen 0 fails, none will remain. 

SEE ALSO

XmuCreateColormap, XmuDeleteStandardColormap, XmuGetColormapAllocation, XmuLookupStdCmp, XmuStandardColormap, XmuVisualStandardColormaps. 

Xlib Reference Manual