XSETDEVICEVALUATORS(3)
NAME
XSetDeviceValuators - initialize the valuators on an extension input
device
SYNOPSIS
#include <X11/extensions/XInput.h> XSetDeviceValuators( Display *display, XDevice *device, int *valuators, int first_valuator, int num_valuators); display Specifies the connection to the X server. device Specifies the device whose valuators are to be initialized. valuators Specifies a pointer to an array of integer values to be used to initialize thedevice valuators. first_valuator Specifies the first valuator to be set. Valuators are numbered beginning withzero. num_valuators Specifies the number of valuators to be set.
DESCRIPTION
The XSetDeviceValuators request sets the current values of the
valuators of an input device. The valuators in the range
first_valuator to (first_valuator + num_valuators) are set to
the specified values. Valuators are numbered beginning with 0.
Not all input devices support initialization of valuator
values. If this request is made to a device that does not
support valuators initialization, a BadMatch error will occur.
If the request succeeds, a status of Success is returned. If
another client has the device grabbed, a status of
AlreadyGrabbed is returned.
XSetDeviceValuators can generate a BadLength, BadDevice,
BadMatch, or BadValue error.
DIAGNOSTICS
- BadDevice
- An invalid device was specified. The specified device
does not exist or has not been opened by this client via
XOpenInputDevice. - BadMatch
- This error may occur if an XSetDeviceValuators request
is made specifying a device that has no valuators and
reports no axes of motion, or if such a request is made
specifying a device that does not support valuator
initialization. - BadValue
- An invalid first_valuator or num_valuators values was
specified.