XcupGetReservedColormapEntries(3) X Version 11 XcupGetReservedColormapEntries(3)

NAME
     XcupGetReservedColormapEntries - list colormap entries reserved by the sys-
     tem

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_outReturns the values reserved by the server.

     ncolors   Returns the number of items in colors_out.

DESCRIPTION
     The  XcupGetReservedColormapEntries function returns a list of colormap en-
     tries (pixels) that are reserved by the system.  This list will, at a mini-
     mum, 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  XCupGetReservedCol-
     ormapEntries,  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

libXext 1.3.7			   2005-01-22  XcupGetReservedColormapEntries(3)