NAME

XcupGetReservedColormapEntries - list colormap entries reserved by the system

SYNOPSIS


cccc [ _f_l_a_g ... ] _f_i_l_e ... -llXXeexxtt [ _l_i_b_r_a_r_y ... ]
#include 
Status XXccuuppGGeettRReesseerrvveeddCCoolloorrmmaappEEnnttrriieess(Display *_d_i_s_p_l_a_y,
int _s_c_r_e_e_n, XColor **_c_o_l_o_r_s___o_u_t, int *_n_c_o_l_o_r_s);
     

ARGUMENTS

_d_i_s_p_l_a_y Specifies the connection to the X server.
_s_c_r_e_e_n Screen number on the host server.
_c_o_l_o_r_s___o_u_t Returns the values reserved by the server.
_n_c_o_l_o_r_s Returns the number of items in _c_o_l_o_r_s___o_u_t.

DESCRIPTION

The _X_c_u_p_G_e_t_R_e_s_e_r_v_e_d_C_o_l_o_r_m_a_p_E_n_t_r_i_e_s 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 _X_F_r_e_e to free colors_out.

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

SEE ALSO

XcupQueryVersion(3Xext), XcupStoreColors(3Xext), XFree(3X11),
_C_o_l_o_r_m_a_p _U_t_i_l_i_z_a_t_i_o_n _P_o_l_i_c_y _a_n_d _E_x_t_e_n_s_i_o_n