Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

XGetMotionEvents()					    XGetMotionEvents()

Name
  XGetMotionEvents – get events from pointer motion history buffer.

Synopsis
  XTimeCoord *XGetMotionEvents(display, w, start, stop, nevents_return)
	Display *display;
	Window w;
	Time start, stop;
	int *nevents_return;

Arguments
  display  Specifies a connection to an X server; returned from XOpenDis‐
	   play().

  w	   Specifies the ID of the window whose associated pointer motion
	   events will be returned.

  start	   Specify  the	 time  interval for which the events are returned
  stop	   from the motion history buffer.  Pass a time	 stamp	(in  mil‐
	   liseconds) or CurrentTime.

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

Returns
  The list of pointer positions.

Description
  XGetMotionEvents() returns all events in the motion history buffer that
  fall	between	 the  specified start and stop times (inclusive) and that
  have coordinates that lie within (including borders) the specified win‐
  dow  at its present placement.  The x and y coordinates of the XTimeCo‐
  ord return structure are reported relative to the origin of w.

  XGetMotionEvent returns NULL if the server does not  support	a  motion
  history  buffer  (which  is  common), or if the start time is after the
  stop time, or if the start time is in the future.  If the stop time  is
  in the future, it is equivalent to specifying the constant CurrentTime,
  since the server does not wait to report future events.  A motion  his‐
  tory	buffer	is supported if XDisplayMotionBufferSize() (display) > 0.
  The pointer position at each pointer hardware interrupt is then  stored
  for later retrieval.

  Use XFree() to free the returned XTimeCoord structures when they are no
  longer needed.

  For more information, see Volume  One,  Chapter  9,  The  Keyboard  and
  Pointer.

Structures
     typedef struct _XTimeCoord {
	 Time time;
	 short x, y;
     } XTimeCoord;

Errors
  BadWindow

See Also
  XQLength(), XAllowEvents(), XCheckIfEvent(), XCheckMaskEvent(), XCheck‐
  TypedEvent(),	     XCheckTypedWindowEvent(),	     XCheckWindowEvent(),
  XEventsQueued(),   XGetInputFocus(),	XIfEvent(),  XMaskEvent(),  XNex‐
  tEvent(), XPeekEvent(),  XPeekIfEvent(),  XPending(),	 XPutBackEvent(),
  XSelectInput(),  XSendEvent(),  XSetInputFocus(), XSynchronize(), XWin‐
  dowEvent().

Xlib - Input Handling					    XGetMotionEvents()

Vote for polarhome