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
                   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.  Valu-
                   ators 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 initial-
       ization 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 speci-
                   fied 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