libinput: Timestamps

Timestamps

# Event timestamps

Most libinput events provide a timestamp in millisecond and/or microsecond resolution. These timestamp usually increase monotonically, but libinput does not guarantee that this always the case. In other words, it is possible to receive an event with a timestamp earlier than the previous event.

For example, if a touchpad has Tap-to-click behaviour enabled, a button event may have a lower timestamp than an event from a different device. Tapping requires the use of timeouts to detect multi-finger taps and/or Tap-and-drag.

Consider the following event sequences from a touchpad and a mouse:

    Time      Touchpad      Mouse
    ---------------------------------
    t1       finger down
    t2        finger up
    t3                     movement
    t4       tap timeout

For this event sequence, the first event to be sent to a caller is in response to the mouse movement: an event of type LIBINPUT_EVENT_POINTER_MOTION with the timestamp t3. Once the timeout expires at t4, libinput generates an event of LIBINPUT_EVENT_POINTER_BUTTON (press) with a timestamp t1 and an event LIBINPUT_EVENT_POINTER_BUTTON (release) with a timestamp t2.

Thus, the caller gets events with timestamps in the order t3, t1, t2, despite t3 > t2 > t1.