


XChangePointerControl(3X11)			  XChangePointerControl(3X11)
X11R5									X11R5



NAME
  XChangePointerControl, XGetPointerControl - control pointer

SYNTAX
  XChangePointerControl(_d_i_s_p_l_a_y, _d_o__a_c_c_e_l, _d_o__t_h_r_e_s_h_o_l_d, _a_c_c_e_l__n_u_m_e_r_a_t_o_r,
			  _a_c_c_e_l__d_e_n_o_m_i_n_a_t_o_r, _t_h_r_e_s_h_o_l_d)
	Display	*_d_i_s_p_l_a_y;
	Bool _d_o__a_c_c_e_l, _d_o__t_h_r_e_s_h_o_l_d;
	int _a_c_c_e_l__n_u_m_e_r_a_t_o_r, _a_c_c_e_l__d_e_n_o_m_i_n_a_t_o_r;
	int _t_h_r_e_s_h_o_l_d;

  XGetPointerControl(_d_i_s_p_l_a_y, _a_c_c_e_l__n_u_m_e_r_a_t_o_r__r_e_t_u_r_n,
  _a_c_c_e_l__d_e_n_o_m_i_n_a_t_o_r__r_e_t_u_r_n,
			 _t_h_r_e_s_h_o_l_d__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	int *_a_c_c_e_l__n_u_m_e_r_a_t_o_r__r_e_t_u_r_n, *_a_c_c_e_l__d_e_n_o_m_i_n_a_t_o_r__r_e_t_u_r_n;
	int *_t_h_r_e_s_h_o_l_d__r_e_t_u_r_n;

ARGUMENTS

  _a_c_c_e_l__d_e_n_o_m_i_n_a_t_o_r
	    Specifies the denominator for the acceleration multiplier.

  _a_c_c_e_l__d_e_n_o_m_i_n_a_t_o_r__r_e_t_u_r_n
	    Returns the	denominator for	the acceleration multiplier.

  _a_c_c_e_l__n_u_m_e_r_a_t_o_r
	    Specifies the numerator for	the acceleration multiplier.

  _a_c_c_e_l__n_u_m_e_r_a_t_o_r__r_e_t_u_r_n
	    Returns the	numerator for the acceleration multiplier.

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

  _d_o__a_c_c_e_l  Specifies a	Boolean	value that controls whether the	values for
	    the	accel_numerator	or accel_denominator are used.

  _d_o__t_h_r_e_s_h_o_l_d
	    Specifies a	Boolean	value that controls whether the	value for the
	    threshold is used.

  _t_h_r_e_s_h_o_l_d Specifies the acceleration threshold.

  _t_h_r_e_s_h_o_l_d__r_e_t_u_r_n
	    Returns the	acceleration threshold.

DESCRIPTION
  The _X_C_h_a_n_g_e_P_o_i_n_t_e_r_C_o_n_t_r_o_l function defines how the pointing device moves.
  The acceleration, expressed as a fraction, is	a multiplier for movement.
  For example, specifying 3/1 means the	pointer	moves three times as fast as
  normal.  The fraction	may be rounded arbitrarily by the X server. Accelera-
  tion only takes effect if the	pointer	moves more than	threshold pixels at
  once and only	applies	to the amount beyond the value in the threshold	argu-
  ment.	 Setting a value to -1 restores	the default.  The values of the
  do_accel and do_threshold arguments must be _T_r_u_e for the pointer values to
  be set, or the parameters are	unchanged.  Negative values (other than	-1)
  generate a _B_a_d_V_a_l_u_e error, as	does a zero value for the accel_denominator
  argument.

  _X_C_h_a_n_g_e_P_o_i_n_t_e_r_C_o_n_t_r_o_l	can generate a _B_a_d_V_a_l_u_e	error.

  The _X_G_e_t_P_o_i_n_t_e_r_C_o_n_t_r_o_l function returns the pointer's	current	acceleration
  multiplier and acceleration threshold.

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
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e


















































