XGetDeviceMotionEvents man page on BSDOS

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDOS logo
[printable version]



XGetDeviceMotionEvents(3X11X FUNCTIONXGetDeviceMotionEvents(3X11)

NAME
       XGetDeviceMotionEvents,	XDeviceTimeCoord  -  get  device
       motion history

SYNTAX
       XDeviceTimeCoord *XGetDeviceMotionEvents(display,  device,
       start, stop,
       nevents_return, mode_return, axis_count_return)
	     Display *display;
	     XDevice *device;
	     Time start, stop;
	     int *nevents_return;
	     int *mode_return;
	     int *axis_count_return;

ARGUMENTS
       display	Specifies the connection to the X server.

       device	Specifies  the	device whose motion history is
		   to be queried.

       start
       stop	Specify the time interval in which the	events
		   are	returned  from the motion history buffer.
		   You can pass a timestamp or CurrentTime.

       nevents_return
		   Returns the number of events from  the  motion
		   history buffer.

       mode_return Returns  the mode  of the device (Absolute or
		   Relative).

       axis_count_return
		   Returns the count of axes being reported.

DESCRIPTION
       The server may retain the recent history	 of  the  device
       motion  and  do so to a finer granularity than is reported
       by DeviceMotionNotify events.  The  XGetDeviceMotionEvents
       request makes this history available.

       The  XGetDeviceMotionEvents  request returns all events in
       the motion history buffer that fall between the	specified
       start  and  stop times,	inclusive.  If the start time is
       later than the stop time or if the start time  is  in  the
       future,	no  events  are returned.  If the stop time is in
       the future, it is equivalent to specifying CurrentTime.

       The mode indicates whether the device is reporting  abso-
       lute  positional data  (mode=Absolute) or relative motion
       data (mode=Relative).  Some devices allow their mode to be
       changed	via  the XSetDeviceMode request.  These constants
       are defined in the file XI.h.  The axis_count returns  the

X Version 11		Release 6.4				1

XGetDeviceMotionEvents(3X11X FUNCTIONXGetDeviceMotionEvents(3X11)

       number  of axes or valuators being reported by the device.

       XGetDeviceMotionEvents can generate a BadDevice, or  Bad-
       Match error.

STRUCTURES
       The XDeviceTimeCoord structure contains:

       typedef struct {
	    Time time;
	    int *data;
       } XDeviceTimeCoord;

       The  time member is set to the time, in milliseconds.  The
       data member is a pointer to an array of	integers.   These
       integers are  set  to the values of each valuator or axis
       reported by the device.	There is one element in the array
       per  axis  of motion reported by the device.  The value of
       the array elements depends on the mode of the device.   If
       the mode is Absolute, the values are the raw values gener-
       ated by the device.  These may be scaled by  client  pro-
       grams  using the maximum values that the device can gener-
       ate.  The maximum value for each axis  of  the  device  is
       reported in the max_val field of the XAxisInfo returned by
       the XListInputDevices request.  If the mode  is	Relative,
       the  data  values are the relative values generated by the
       device.

       You should use XFreeDeviceMotionEvents to  free	the  data
       returned by this request.

       Errors returned by this request: BadDevice, BadMatch.

DIAGNOSTICS
       BadDevice   An  invalid	device was specified.  The speci-
		   fied device does not exist  or  has	not  been
		   opened  by  this  client via XOpenInputDevice.
		   This error may also	occur  if  the	specified
		   device  is the X keyboard or X pointer device.

       BadMatch This error may occur if	 an	XGetDeviceMotion-
		   Events  request  is	made  specifying a device
		   that has no valuators and reports no axes  of
		   motion.

SEE ALSO
       Programming with Xlib

X Version 11		Release 6.4				2

[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server BSDOS

List of man pages available for BSDOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net