FreeBSD manual
download PDF document: XcupGetReservedColormapEntries.3.pdf
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.4 XCUP(3)