


XInstallColormap(3X11)				       XInstallColormap(3X11)
X11R5									X11R5



NAME
  XInstallColormap, XUninstallColormap,	XListInstalledColormaps	- control
  colormaps

SYNTAX
  XInstallColormap(_d_i_s_p_l_a_y, _c_o_l_o_r_m_a_p)
	Display	*_d_i_s_p_l_a_y;
	Colormap _c_o_l_o_r_m_a_p;

  XUninstallColormap(_d_i_s_p_l_a_y, _c_o_l_o_r_m_a_p)
	Display	*_d_i_s_p_l_a_y;
	Colormap _c_o_l_o_r_m_a_p;

  Colormap *XListInstalledColormaps(_d_i_s_p_l_a_y, _w,	_n_u_m__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	Window _w;
	int *_n_u_m__r_e_t_u_r_n;

ARGUMENTS

  _c_o_l_o_r_m_a_p  Specifies the colormap.

  _d_i_s_p_l_a_y   Specifies the connection to	the X server.

  _n_u_m__r_e_t_u_r_n
	    Returns the	number of currently installed colormaps.

  _w	    Specifies the window that determines the screen.

DESCRIPTION
  The _X_I_n_s_t_a_l_l_C_o_l_o_r_m_a_p function	installs the specified colormap	for its	asso-
  ciated screen.  All windows associated with this colormap immediately
  display with true colors.  You associated the	windows	with this colormap
  when you created them	by calling _X_C_r_e_a_t_e_W_i_n_d_o_w, _X_C_r_e_a_t_e_S_i_m_p_l_e_W_i_n_d_o_w,
  _X_C_h_a_n_g_e_W_i_n_d_o_w_A_t_t_r_i_b_u_t_e_s, or _X_S_e_t_W_i_n_d_o_w_C_o_l_o_r_m_a_p.

  If the specified colormap is not already an installed	colormap, the X
  server generates a _C_o_l_o_r_m_a_p_N_o_t_i_f_y event on each window that has that color-
  map.	In addition, for every other colormap that is installed	as a result
  of a call to _X_I_n_s_t_a_l_l_C_o_l_o_r_m_a_p, the X server generates	a _C_o_l_o_r_m_a_p_N_o_t_i_f_y
  event	on each	window that has	that colormap.

  _X_I_n_s_t_a_l_l_C_o_l_o_r_m_a_p can generate	a _B_a_d_C_o_l_o_r error.

  The _X_U_n_i_n_s_t_a_l_l_C_o_l_o_r_m_a_p function removes the specified	colormap from the
  required list	for its	screen.	 As a result, the specified colormap might be
  uninstalled, and the X server	might implicitly install or uninstall addi-
  tional colormaps.  Which colormaps get installed or uninstalled is server-
  dependent except that	the required list must remain installed.

  If the specified colormap becomes uninstalled, the X server generates	a
  _C_o_l_o_r_m_a_p_N_o_t_i_f_y event on each window that has that colormap.  In addition,
  for every other colormap that	is installed or	uninstalled as a result	of a
  call to _X_U_n_i_n_s_t_a_l_l_C_o_l_o_r_m_a_p, the X server generates a _C_o_l_o_r_m_a_p_N_o_t_i_f_y event
  on each window that has that colormap.

  _X_U_n_i_n_s_t_a_l_l_C_o_l_o_r_m_a_p can generate a _B_a_d_C_o_l_o_r error.

  The _X_L_i_s_t_I_n_s_t_a_l_l_e_d_C_o_l_o_r_m_a_p_s function returns a list of the currently
  installed colormaps for the screen of	the specified window.  The order of
  the colormaps	in the list is not significant and is no explicit indication
  of the required list.	 When the allocated list is no longer needed, free it
  by using _X_F_r_e_e.

  _X_L_i_s_t_I_n_s_t_a_l_l_e_d_C_o_l_o_r_m_a_p_s can generate a _B_a_d_W_i_n_d_o_w error.

DIAGNOSTICS

  _B_a_d_C_o_l_o_r  A value for	a Colormap argument does not name a defined Colormap.

  _B_a_d_W_i_n_d_o_w A value for	a Window argument does not name	a defined Window.

SEE ALSO
  XChangeWindowAttributes(3X11), XCreateColormap(3X11),	XCreateWindow(3X11),
  XFree(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e	delim off
















































