XcupGetReservedColormapEntries(3) X Version 11 XcupGetReservedColormapEntries(3)

# [NAME](#NAME)

XcupGetReservedColormapEntries - list colormap entries reserved by the system

# [SYNOPSIS](#SYNOPSIS)

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

Status XcupGetReservedColormapEntries(Display *display,


    int screen, XColor **colors_out, int *ncolors);
```

# [ARGUMENTS](#ARGUMENTS)

[*display*](#display)

Specifies the connection to the X server.

[*screen*](#screen)

Screen number on the host server.

[*colors\_out*](#colors_out)

Returns the values reserved by the server.

[*ncolors*](#ncolors)

Returns the number of items in *colors\_out*.

# [DESCRIPTION](#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](#SEE_ALSO)

[**XcupQueryVersion**(3Xext)](/man/os/libxext/XcupQueryVersion.3Xext), [**XcupStoreColors**(3Xext)](/man/os/libxext/XcupStoreColors.3Xext), **XFree**(3X11),  
*Colormap Utilization Policy and Extension*

2005-01-22 libXext 1.3.7

---

Document: XcupGetReservedColormapEntries(3) from libxext 1.3.7-r5 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libxext.git