XmuLookupStandardColormap(Xmu) X Version 11 (Release 5)
6 January 1993
Name
XmuLookupStandardColormap - create standard colormap
Syntax
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 deter-
mines 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.
See also
XmuAllStandardColormaps(Xmu), XmuVisualStandardColormaps(Xmu),
XmuGetColormapAllocation(Xmu), XmuStandardColormap(Xmu), XmuCre-
ateColormap(Xmu), XmuDeleteStandardColormap(Xmu)
Xlib - C Language X Interface