debian man page for xcupgetreservedcolormapentries

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	XCupGetRe-
       servedColormapEntries, 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.1							   XCUP(3)