|
|
Call for a New OWASP Thailand Chapter Leader
|
|
XSetRGBColormaps() XSetRGBColormaps()
Name
XSetRGBColormaps - set an XStandardColormap structure.
Synopsis
void XSetRGBColormaps(display, w, std_colormap, count, property)
Display *display;
Window w;
XStandardColormap *std_colormap;
int count;
Atom property;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
w Specifies the window.
std_colormap
Specifies the XStandardColormap structure to be used.
count Specifies the number of colormaps.
property Specifies the property name.
Availability
Release 4 and later.
Description
XSetRGBColormaps() replaces the RGB colormap definition in the specified property on the named window. If the property does not already
exist, XSetRGBColormaps() sets the RGB colormap definition in the specified property on the window. The property is stored with a type of
RGB_COLOR_MAP and a format of 32. Note that it is the caller's responsibility to honor the ICCCM restriction that only RGB_DEFAULT_MAP
contain more than one definition.
To create a standard colormap, follow this procedure:
1. Open a new connection to the same server.
2. Grab the server.
3. See if property is on the property list of the root window for the display, using XGetStandardColormap(). If so, see if the colormap
field is non-zero. If it is, the colormap already exists.
4. If the desired property is not present, do the following:
o Determine the color capabilities of the display. Choose a visual.
o Create a colormap (not required for XA_RGB_DEFAULT_MAP).
o Call XAllocColorPlanes() or XAllocColorCells() to allocate cells in the colormap.
o Call XStoreColors() to store appropriate color values in the colormap.
o Fill in the descriptive fields in the structure.
o Call XSetRGBColormaps() to set the property on the root window.
o Use XSetCloseDownMode() to make the resource permanent.
o Close the new connection to the server.
5. Ungrab the server.
6. XSetRGBColormaps() supersedes XSetStandardColormap().
For more information, see Volume One, Chapter 7, Color.
Structures
typedef struct {
Colormap colormap;
unsigned long red_max;
unsigned long red_mult;
unsigned long green_max;
unsigned long green_mult;
unsigned long blue_max;
unsigned long blue_mult;
unsigned long base_pixel;
VisualID visualid; /* added by ICCCM version 1 */
XID killid; /* added by ICCCM version 1 */
} XStandardColormap;
Errors
BadAlloc
BadAtom
BadWindow
See Also
XAllocStandardColormap(), XGetRGBColormaps(), XVisualIDFromVisual().
Xlib - Window Manager Hints XSetRGBColormaps()