1XcupStoreColors(3)                X FUNCTIONS               XcupStoreColors(3)
2
3
4

NAME

6       XcupStoreColors  -  initialize  shareable  colormap entries at specific
7       locations
8

SYNOPSIS

10       cc [ flag ... ] file ... -lXext [ library ... ]
11       #include <X11/extensions/Xcup.h>
12
13       Status XcupStoreColors(Display *display, Colormap colormap,
14              XColor *colors_in_out, int ncolors);
15

ARGUMENTS

17       display   Specifies the connection to the X server
18
19       colormap  Specifies the colormap
20
21       colors_in_out
22                 Specifies and returns the values actually used  in  the  col‐
23                 ormap
24
25       ncolors   Specifies the number of items in colors_in_out
26

DESCRIPTION

28       The  XcupStoreColors function changes the colormap entries of the pixel
29       values in the pixel members of  the  XColor  structures.  The  colormap
30       entries  are  allocated as if an AllocColor has been used instead, i.e.
31       the colors are read-only (shareable).  XcupStoreColors returns the num‐
32       ber of colors that were successfully allocated in the colormap.
33
34       A  Value  error  is  generated if a pixel is not a valid index into the
35       colormap. A BadMatch error is generated if the colormap does not belong
36       to a GrayScale, PseudoColor, or DirectColor visual.
37
38       Applications which allocate many colors in a screen's default colormap,
39       e.g.  a color-cube or a gray-ramp, should allocate them with XCupStore‐
40       Colors.  By using XCupStoreColors the colors will be allocated sharable
41       (read-only) and any other application which allocates  the  same  color
42       will share that color cell.
43

SEE ALSO

45       XcupQueryVersion(3Xext), XcupGetReservedColormapEntries(3Xext),
46       Colormap Utilization Policy and Extension
47
48
49
50X Version 11                     libXext 1.3.4              XcupStoreColors(3)
Impressum