XChangePointerControl(3) XLIB FUNCTIONS XChangePointerControl(3)

# [NAME](#NAME)

XChangePointerControl, XGetPointerControl - control pointer

# [SYNTAX](#SYNTAX)

int XChangePointerControl(Display \**display*, Bool *do\_accel*, Bool *do\_threshold*, int *accel\_numerator*, int *accel\_denominator*, int *threshold*);

int XGetPointerControl(Display \**display*, int \**accel\_numerator\_return*, int \**accel\_denominator\_return*, int \**threshold\_return*);

# [ARGUMENTS](#ARGUMENTS)

[*accel\_denominator*](#accel_denominator)

Specifies the denominator for the acceleration multiplier.

[*accel\_denominator\_return*](#accel_denominator_return)

Returns the denominator for the acceleration multiplier.

[*accel\_numerator*](#accel_numerator)

Specifies the numerator for the acceleration multiplier.

[*accel\_numerator\_return*](#accel_numerator_return)

Returns the numerator for the acceleration multiplier.

[*display*](#display)

Specifies the connection to the X server.

[*do\_accel*](#do_accel)

Specifies a Boolean value that controls whether the values for the accel\_numerator or accel\_denominator are used.

[*do\_threshold*](#do_threshold)

Specifies a Boolean value that controls whether the value for the threshold is used.

[*threshold*](#threshold)

Specifies the acceleration threshold.

[*threshold\_return*](#threshold_return)

Returns the acceleration threshold.

# [DESCRIPTION](#DESCRIPTION)

The **XChangePointerControl** 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 **True** for the pointer values to be set, or the parameters are unchanged. Negative values (other than -1) generate a **BadValue** error, as does a zero value for the accel\_denominator argument.

**XChangePointerControl** can generate a **BadValue** error.

The **XGetPointerControl** function returns the pointer's current acceleration multiplier and acceleration threshold.

# [DIAGNOSTICS](#DIAGNOSTICS)

[**BadValue**](#BadValue)

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](#SEE_ALSO)

*Xlib - C Language X Interface*

libX11 1.8.14 X Version 11

---

Document: XChangePointerControl(3) from libx11 1.8.14-r2 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libx11.git