Manual Pages for UNIX Operating System command usage for man XcupStoreColors

X FUNCTIONS                                XcupStoreColors(3xext)



NAME
     XcupStoreColors - initialize shareable colormap  entries  at
     specific locations

SYNOPSIS
     cc [ flag... ] file... -lXext [ library... ]

     cc [ flag ... ] file ... -lXext [ library ... ]
     #include 

     Status XcupStoreColors(Display *display, Colormap colormap,
          XColor *colors_in_out, int ncolors);

ARGUMENTS
     display   Specifies the connection to the X server

     colormap  Specifies the colormap

     colors_in_out
               Specifies and returns the values actually used  in
               the colormap

     ncolors   Specifies the number of items in colors_in_out

DESCRIPTION
     The XcupStoreColors function changes the colormap entries of
     the  pixel  values in the pixel members of the XColor struc-
     tures. The colormap entries are allocated as  if  an  Alloc-
     Color  has  been used instead, i.e. the colors are read-only
     (shareable).  XcupStoreColors returns the number  of  colors
     that were successfully allocated in the colormap.

     A Value error is generated if a pixel is not a  valid  index
     into  the  colormap.  A  BadMatch  error is generated if the
     colormap does not belong to  a  GrayScale,  PseudoColor,  or
     DirectColor visual.

     Applications  which  allocate  many  colors  in  a  screen's
     default  colormap, e.g.  a color-cube or a gray-ramp, should
     allocate    them    with    XCupStoreColors.     By    using
     XCupStoreColors   the  colors  will  be  allocated  sharable
     (read-only) and any other application  which  allocates  the
     same color will share that color cell.

SEE ALSO
     XcupQueryVersion(3Xext),
     XcupGetReservedColormapEntries(3Xext),
     Colormap Utilization Policy and Extension


ATTRIBUTES
     See  attributes(5)  for  descriptions   of   the   following



X Version 11       Last change: libXext 1.1.2                   1






X FUNCTIONS                                XcupStoreColors(3xext)



     attributes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libxext         |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|












































X Version 11       Last change: libXext 1.1.2                   2