XChangePointerControl(3X11) SDK X11 R4.11MU05 XChangePointerControl(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 multiplier.
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.
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
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
Xlib - C Language X Interface
Licensed material--property of copyright holder(s)