X Version 11 (Release 6.1)

XmuLookupStandardColormap(X3xmu)

XmuLookupStandardColormap -- create standard colormap

Synopsis

cc . . . -lXmu

#include <X11/Xmu/StdCmap.h>

Status XmuLookupStandardColormap(dpy, screen, visualid, depth, property,
				 replace, retain)
      Display *dpy;
      int screen;
      VisualID visualid;
      unsigned int depth;
      Atom property;
      Bool replace;
      Bool retain;

Arguments

dpy: Specifies the connection to the X server.
screen: Specifies the screen of the display.
visualid: Specifies the visual type.
depth: Specifies the visual depth.
property: Specifies the standard colormap property.
replace: Specifies whether or not to replace.
retain: Specifies whether or not to retain.

Description

To create a standard colormap if one does not currently exist, or replace the currently existing standard colormap, use XmuLookupStandardColormap.

Given a screen, a visual, and a property, this function determines the best allocation for the property under the specified visual, and determines whether to create a new colormap or to use the default colormap of the screen.

If replace is True, any previous definition of the property is replaced. If retain is True, the property and the colormap will be made permanent for the duration of the server session. However, pre-existing property definitions that are not replaced cannot be made permanent by a call to this function; a request to retain resources pertains to newly created resources.

This function returns 0 on failure, non-zero on success. A request to create a standard colormap upon a visual which cannot support such a map is considered a failure. An example of this would be requesting any standard colormap property on a monochrome visual, or requesting an RGB_BEST_MAP on a display whose colormap size is 16.

References

XmuAllStandardColormaps(X3xmu), XmuVisualStandardColormaps(X3xmu), XmuGetColormapAllocation(X3xmu), XmuStandardColormap(X3xmu), XmuCreateColormap(X3xmu), XmuDeleteStandardColormap(X3xmu)
Xlib - C Language X Interface