src/evdev-mt-touchpad.h

   1 /*
   2  * Copyright © 2014 Red Hat, Inc.
   3  *
   4  * Permission to use, copy, modify, distribute, and sell this software and
   5  * its documentation for any purpose is hereby granted without fee, provided
   6  * that the above copyright notice appear in all copies and that both that
   7  * copyright notice and this permission notice appear in supporting
   8  * documentation, and that the name of the copyright holders not be used in
   9  * advertising or publicity pertaining to distribution of the software
  10  * without specific, written prior permission.  The copyright holders make
  11  * no representations about the suitability of this software for any
  12  * purpose.  It is provided "as is" without express or implied warranty.
  13  *
  14  * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
  15  * SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
  16  * FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
  17  * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
  18  * RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
  19  * CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  20  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  21  */
  22
  23
  24 #ifndef EVDEV_MT_TOUCHPAD_H
  25 #define EVDEV_MT_TOUCHPAD_H
  26
  27 #include <stdbool.h>
  28
  29 #include "evdev.h"
  30 #include "filter.h"
  31
  32 #define TOUCHPAD_HISTORY_LENGTH 4
  33 #define TOUCHPAD_MIN_SAMPLES 4
  34
  35 enum touchpad_event {
  36         TOUCHPAD_EVENT_NONE             = 0,
  37         TOUCHPAD_EVENT_MOTION           = (1 << 0),
  38         TOUCHPAD_EVENT_BUTTON_PRESS     = (1 << 1),
  39         TOUCHPAD_EVENT_BUTTON_RELEASE   = (1 << 2),
  40 };
  41
  42 enum touch_state {
  43         TOUCH_NONE = 0,
  44         TOUCH_BEGIN,
  45         TOUCH_UPDATE,
  46         TOUCH_END
  47 };
  48
  49 enum scroll_state {
  50         SCROLL_STATE_NONE,
  51         SCROLL_STATE_SCROLLING
  52 };
  53
  54 enum tp_tap_state {
  55         TAP_STATE_IDLE = 4,
  56         TAP_STATE_TOUCH,
  57         TAP_STATE_HOLD,
  58         TAP_STATE_TAPPED,
  59         TAP_STATE_TOUCH_2,
  60         TAP_STATE_TOUCH_2_HOLD,
  61         TAP_STATE_TOUCH_3,
  62         TAP_STATE_TOUCH_3_HOLD,
  63         TAP_STATE_DRAGGING_OR_DOUBLETAP,
  64         TAP_STATE_DRAGGING,
  65         TAP_STATE_DRAGGING_WAIT,
  66         TAP_STATE_DRAGGING_2,
  67         TAP_STATE_DEAD, /**< finger count exceeded */
  68 };
  69
  70 struct tp_motion {
  71         int32_t x;
  72         int32_t y;
  73 };
  74
  75 struct tp_touch {
  76         enum touch_state state;
  77         bool dirty;
  78         bool fake;                              /* a fake touch */
  79         bool is_pointer;                        /* the pointer-controlling touch */
  80         bool is_pinned;                         /* holds the phys. button */
  81         int32_t x;
  82         int32_t y;
  83         uint32_t millis;
  84
  85         struct {
  86                 struct tp_motion samples[TOUCHPAD_HISTORY_LENGTH];
  87                 unsigned int index;
  88                 unsigned int count;
  89         } history;
  90
  91         struct {
  92                 int32_t center_x;
  93                 int32_t center_y;
  94         } hysteresis;
  95 };
  96
  97 struct tp_dispatch {
  98         struct evdev_dispatch base;
  99         struct evdev_device *device;
 100         unsigned int nfingers_down;             /* number of fingers down */
 101         unsigned int slot;                      /* current slot */
 102         bool has_mt;
 103
 104         unsigned int ntouches;                  /* number of slots */
 105         struct tp_touch *touches;               /* len == ntouches */
 106         unsigned int fake_touches;              /* fake touch mask */
 107
 108         struct {
 109                 int32_t margin_x;
 110                 int32_t margin_y;
 111         } hysteresis;
 112
 113         struct motion_filter *filter;
 114
 115         struct {
 116                 double constant_factor;
 117                 double min_factor;
 118                 double max_factor;
 119         } accel;
 120
 121         struct {
 122                 bool has_buttons;               /* true for physical LMR buttons */
 123                 uint32_t state;
 124                 uint32_t old_state;
 125         } buttons;                              /* physical buttons */
 126
 127         struct {
 128                 enum scroll_state state;
 129                 enum libinput_pointer_axis direction;
 130         } scroll;
 131
 132         enum touchpad_event queued;
 133
 134         struct {
 135                 bool enabled;
 136                 int timer_fd;
 137                 struct libinput_source *source;
 138                 unsigned int timeout;
 139                 enum tp_tap_state state;
 140         } tap;
 141 };
 142
 143 #define tp_for_each_touch(_tp, _t) \
 144         for (unsigned int _i = 0; _i < (_tp)->ntouches && (_t = &(_tp)->touches[_i]); _i++)
 145
 146 void
 147 tp_get_delta(struct tp_touch *t, double *dx, double *dy);
 148
 149 int
 150 tp_tap_handle_state(struct tp_dispatch *tp, uint32_t time);
 151
 152 unsigned int
 153 tp_tap_handle_timeout(struct tp_dispatch *tp, uint32_t time);
 154
 155 int
 156 tp_init_tap(struct tp_dispatch *tp);
 157
 158 void
 159 tp_destroy_tap(struct tp_dispatch *tp);
 160
 161 #endif