NAME

XChangePointerControl, XGetPointerControl - control pointer

SYNTAX

int XChangePointerControl(Display *_d_i_s_p_l_a_y, Bool _d_o___a_c_c_e_l, Bool _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, int _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); int XGetPointerControl(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, int *_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. Acceleration 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 argument. 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 argument, 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