XSetDeviceValuators

XSetDeviceValuators(3X11)	 X FUNCTIONS	    XSetDeviceValuators(3X11)



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 initial-
		   ized.

       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  valua-
       tors 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 sup-
       port 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.

SEE ALSO
       Programming with Xlib



						    XSetDeviceValuators(3X11)