Copyright \(co 1986-1997 The Open Group All Rights Reserved
Copyright (c) 1999, 2005, Oracle and/or its affiliates.

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice (including the next
paragraph) shall be included in all copies or substantial portions of the
Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

X Window System is a trademark of The Open Group.

..
XCUP __libmansuffix__ __xorgversion__ "X FUNCTIONS"
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 1i
Specifies the connection to the X server.
screen 1i
Screen number on the host server.
colors_out 1i
Returns the values reserved by the server.
ncolors 1i
Returns the number of items in colors_out.
DESCRIPTION

The .ZN 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 .ZN XFree to free colors_out.

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

"SEE ALSO"
XcupQueryVersion (3Xext), XcupStoreColors (3Xext), XFree (3X11),

Colormap Utilization Policy and Extension