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