


XSetPointerMapping(3X11)			     XSetPointerMapping(3X11)
X11R5									X11R5



NAME
  XSetPointerMapping, XGetPointerMapping - manipulate pointer settings

SYNTAX
  int XSetPointerMapping(_d_i_s_p_l_a_y, _m_a_p, _n_m_a_p)
	Display	*_d_i_s_p_l_a_y;
	unsigned char _m_a_p[];
	int _n_m_a_p;

  int XGetPointerMapping(_d_i_s_p_l_a_y, _m_a_p__r_e_t_u_r_n, _n_m_a_p)
	Display	*_d_i_s_p_l_a_y;
	unsigned char _m_a_p__r_e_t_u_r_n[];
	int _n_m_a_p;

ARGUMENTS

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

  _m_a_p	    Specifies the mapping list.

  _m_a_p__r_e_t_u_r_n
	    Returns the	mapping	list.

  _n_m_a_p	    Specifies the number of items in the mapping list.

DESCRIPTION
  The _X_S_e_t_P_o_i_n_t_e_r_M_a_p_p_i_n_g function sets the mapping of the pointer.  If it
  succeeds, the	X server generates a _M_a_p_p_i_n_g_N_o_t_i_f_y event, and _X_S_e_t_P_o_i_n_t_e_r_M_a_p_-
  _p_i_n_g returns _M_a_p_p_i_n_g_S_u_c_c_e_s_s.	Element	map[i] defines the logical button
  number for the physical button i+1.  The length of the list must be the
  same as _X_G_e_t_P_o_i_n_t_e_r_M_a_p_p_i_n_g would return, or a	_B_a_d_V_a_l_u_e error results.	 A
  zero element disables	a button, and elements are not restricted in value by
  the number of	physical buttons.  However, no two elements can	have the same
  nonzero value, or a _B_a_d_V_a_l_u_e error results.  If any of the buttons to	be
  altered are logically	in the down state, _X_S_e_t_P_o_i_n_t_e_r_M_a_p_p_i_n_g returns _M_a_p_-
  _p_i_n_g_B_u_s_y, and	the mapping is not changed.

  _X_S_e_t_P_o_i_n_t_e_r_M_a_p_p_i_n_g can generate a _B_a_d_V_a_l_u_e error.

  The _X_G_e_t_P_o_i_n_t_e_r_M_a_p_p_i_n_g function returns the current mapping of the pointer.
  Pointer buttons are numbered starting	from one.  _X_G_e_t_P_o_i_n_t_e_r_M_a_p_p_i_n_g returns
  the number of	physical buttons actually on the pointer.  The nominal map-
  ping for a pointer is	map[i]=i+1.  The nmap argument specifies the length
  of the array where the pointer mapping is returned, and only the first nmap
  elements are returned	in map_return.

DIAGNOSTICS

  _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of values accepted by
	    the	request.  Unless a specific range is specified for an argu-
	    ment, the full range defined by the	argument's type	is accepted.
	    Any	argument defined as a set of alternatives can generate this
	    error.

SEE ALSO
  XChangeKeyboardControl(3X11),	XChangeKeyboardMapping(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

