x11r4 man page for xsetdevicevaluators

XSetDeviceValuators(3)						    X FUNCTIONS 					    XSetDeviceValuators(3)

NAME
       XSetDeviceValuators - initialize the valuators on an extension input device

SYNTAX
       XSetDeviceValuators(display, device, valuators, first_valuator, num_valuators)
	     Display *display;
	     XDevice *device;
	     int *valuators;
	     int first_valuator;
	     int num_valuators;

ARGUMENTS
       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 the device valuators.

       first_valuator
		   Specifies the first valuator to be set.  Valuators are numbered beginning with zero.

       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 XOpenInputDe-
		   vice.

       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.

SEE ALSO
       Programming with Xlib

X Version 11							    libXi 1.2.1 					    XSetDeviceValuators(3)