


XRecolorCursor(3X11)					 XRecolorCursor(3X11)
X11R5									X11R5



NAME
  XRecolorCursor, XFreeCursor, XQueryBestCursor	- manipulate cursors

SYNTAX
  XRecolorCursor(_d_i_s_p_l_a_y, _c_u_r_s_o_r, _f_o_r_e_g_r_o_u_n_d__c_o_l_o_r, _b_a_c_k_g_r_o_u_n_d__c_o_l_o_r)
	Display	*_d_i_s_p_l_a_y;
	Cursor _c_u_r_s_o_r;
	XColor *_f_o_r_e_g_r_o_u_n_d__c_o_l_o_r, *_b_a_c_k_g_r_o_u_n_d__c_o_l_o_r;

  XFreeCursor(_d_i_s_p_l_a_y, _c_u_r_s_o_r)
	Display	*_d_i_s_p_l_a_y;
	Cursor _c_u_r_s_o_r;

  Status XQueryBestCursor(_d_i_s_p_l_a_y, _d, _w_i_d_t_h, _h_e_i_g_h_t, _w_i_d_t_h__r_e_t_u_r_n,
  _h_e_i_g_h_t__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	Drawable _d;
	unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
	unsigned int *_w_i_d_t_h__r_e_t_u_r_n, *_h_e_i_g_h_t__r_e_t_u_r_n;

ARGUMENTS

  _b_a_c_k_g_r_o_u_n_d__c_o_l_o_r
	    Specifies the RGB values for the background	of the source.

  _c_u_r_s_o_r    Specifies the cursor.

  _d	    Specifies the drawable, which indicates the	screen.

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

  _f_o_r_e_g_r_o_u_n_d__c_o_l_o_r
	    Specifies the RGB values for the foreground	of the source.

  _w_i_d_t_h
  _h_e_i_g_h_t    Specify the	width and heightof the cursor that you want the	size
	    information	for.

  _w_i_d_t_h__r_e_t_u_r_n
  _h_e_i_g_h_t__r_e_t_u_r_n
	    Return the best width and height that is closest to	the specified
	    width and height.

DESCRIPTION
  The _X_R_e_c_o_l_o_r_C_u_r_s_o_r function changes the color	of the specified cursor, and
  if the cursor	is being displayed on a	screen,	the change is visible immedi-
  ately.  Note that the	pixel members of the _X_C_o_l_o_r structures are ignored,
  only the RGB values are used.

  _X_R_e_c_o_l_o_r_C_u_r_s_o_r can generate a	_B_a_d_C_u_r_s_o_r error.


  The _X_F_r_e_e_C_u_r_s_o_r function deletes the association between the cursor
  resource ID and the specified	cursor.	 The cursor storage is freed when no
  other	resource references it.	 The specified cursor ID should	not be
  referred to again.


  _X_F_r_e_e_C_u_r_s_o_r can generate a _B_a_d_C_u_r_s_o_r error.

  Some displays	allow larger cursors than other	displays.  The _X_Q_u_e_r_y_B_e_s_t_C_u_r_-
  _s_o_r function provides	a way to find out what size cursors are	actually pos-
  sible	on the display.	 It returns the	largest	size that can be displayed.
  Applications should be prepared to use smaller cursors on displays that
  cannot support large ones.

  _X_Q_u_e_r_y_B_e_s_t_C_u_r_s_o_r can generate	a _B_a_d_D_r_a_w_a_b_l_e error.

DIAGNOSTICS

  _B_a_d_C_u_r_s_o_r A value for	a Cursor argument does not name	a defined Cursor.

  _B_a_d_D_r_a_w_a_b_l_e
	    A value for	a Drawable argument does not name a defined Window or
	    Pixmap.

SEE ALSO
  XCreateColormap(3X11), XCreateFontCursor(3X11), XDefineCursor(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













































