XCUP(3)                           X FUNCTIONS                          XCUP(3)

NAME
       XcupGetReservedColormapEntries - list colormap entries reserved by the
       system

SYNOPSIS
       cc [ flag ... ] file ... -lXext [ library ... ]
       #include <X11/extensions/Xcup.h>

       Status XcupGetReservedColormapEntries(Display *display,
              int screen, XColor **colors_out, int *ncolors);

ARGUMENTS
       display   Specifies the connection to the X server.

       screen    Screen number on the host server.

       colors_out
                 Returns the values reserved by the server.

       ncolors   Returns the number of items in colors_out.

DESCRIPTION
       The XcupGetReservedColormapEntries function returns a list of colormap
       entries (pixels) that are reserved by the system. This list will, at a
       minimum, contain entries for the BlackPixel and WhitePixel of the
       specified screen. Use XFree to free colors_out.

       To minimize colormap flash, an application which installs its own
       private colormap should query the special colors by calling
       XCupGetReservedColormapEntries, and can then store those entries (in
       the proper location) in its private colormap using XCupStoreColors.

SEE ALSO
       XcupQueryVersion(3Xext), XcupStoreColors(3Xext), XFree(3X11),
       Colormap Utilization Policy and Extension

X Version 11                     libXext 1.3.6                         XCUP(3)