manpagez: man pages & more
man XSetDeviceValuators(3)
Home | html | info | man
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 num-
                   bered 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.  Val-
       uators  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  XOpen-
                   InputDevice.

       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 spec-
                   ified.


SEE ALSO

       Programming with Xlib



X Version 11                      libXi 1.2.1           XSetDeviceValuators(3)

Mac OS X 10.6 X11 - Generated Sun Mar 7 12:30:49 CST 2010
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.