XChangePointerControl(3X11)
XLIB FUNCTION
XC
ShangePointerControl(3X11)
NAME
XChangePointerControl, XGetPointerControl - control
pointer
SYNTAX
XChangePointerControl(display, doaccel, dothreshold,
accelnumerator,
acceldenominator, threshold)
Display *display;
Bool doaccel, dothreshold;
int accelnumerator, acceldenominator;
int threshold;
XGetPointerControl(display, accelnumeratorreturn,
acceldenominatorreturn,
thresholdreturn)
Display *display;
int *accelnumeratorreturn,
*acceldenominatorreturn;
int *thresholdreturn;
ARGUMENTS
acceldenominator
Specifies the denominator for the acceleration
multiplier.
acceldenominatorreturn
Returns the denominator for the acceleration
multiplier.
accelnumerator
Specifies the numerator for the acceleration
multiplier.
accelnumeratorreturn
Returns the numerator for the acceleration mul-
tiplier.
display Specifies the connection to the X server.
doaccel Specifies a Boolean value that controls whether
the values for the accel_numerator or
accel_denominator are used.
dothreshold
Specifies a Boolean value that controls whether
the value for the threshold is used.
threshold Specifies the acceleration threshold.
thresholdreturn
Returns the acceleration threshold.
X Version 11 Release 5 1
XChangePointerControl(3X11)
XLIB FUNCTION
XC
ShangePointerControl(3X11)
DESCRIPTION
The XChangePointerControl function defines how the point-
ing device moves. The acceleration, expressed as a frac-
tion, is a multiplier for movement. For example, specify-
ing 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 cur-
rent acceleration multiplier and acceleration threshold.
DIAGNOSTICS
BadValue Some numeric value falls outside the range of
values accepted by the request. Unless a spe-
cific 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
Xlib - C Language X Interface
X Version 11 Release 5 2