2 * Copyright © 2014 Red Hat, Inc.
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.
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.
24 #ifndef EVDEV_MT_TOUCHPAD_H
25 #define EVDEV_MT_TOUCHPAD_H
32 #define TOUCHPAD_HISTORY_LENGTH 4
33 #define TOUCHPAD_MIN_SAMPLES 4
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),
50 BUTTON_EVENT_IN_BOTTOM_R = 30,
51 BUTTON_EVENT_IN_BOTTOM_L,
63 BUTTON_STATE_BOTTOM_NEW,
64 BUTTON_STATE_BOTTOM_TO_AREA,
69 SCROLL_STATE_SCROLLING
78 TAP_STATE_TOUCH_2_HOLD,
80 TAP_STATE_TOUCH_3_HOLD,
81 TAP_STATE_DRAGGING_OR_DOUBLETAP,
83 TAP_STATE_DRAGGING_WAIT,
85 TAP_STATE_DEAD, /**< finger count exceeded */
94 enum touch_state state;
96 bool fake; /* a fake touch */
97 bool is_pointer; /* the pointer-controlling touch */
103 struct tp_motion samples[TOUCHPAD_HISTORY_LENGTH];
113 /* A pinned touchpoint is the one that pressed the physical button
114 * on a clickpad. After the release, it won't move until the center
115 * moves more than a threshold away from the original coordinates
123 /* Software-button state and timeout if applicable */
125 enum button_state state;
126 /* We use button_event here so we can use == on events */
127 enum button_event curr;
133 struct evdev_dispatch base;
134 struct evdev_device *device;
135 unsigned int nfingers_down; /* number of fingers down */
136 unsigned int slot; /* current slot */
139 unsigned int ntouches; /* number of slots */
140 struct tp_touch *touches; /* len == ntouches */
141 unsigned int fake_touches; /* fake touch mask */
148 struct motion_filter *filter;
151 double constant_factor;
157 bool has_buttons; /* true for physical LMR buttons */
158 bool use_clickfinger; /* number of fingers decides button number */
159 bool use_softbuttons; /* use software-button area */
162 uint32_t motion_dist; /* for pinned touches */
163 unsigned int active; /* currently active button, for release event */
165 /* Only used if has_buttons is false. The software button area is always
166 * a horizontal strip across the touchpad. Depending on the
167 * rightbutton_left_edge value, the buttons are split according to the
172 int32_t rightbutton_left_edge;
175 unsigned int timeout; /* current timeout in ms */
178 struct libinput_source *source;
179 } buttons; /* physical buttons */
182 enum scroll_state state;
183 enum libinput_pointer_axis direction;
186 enum touchpad_event queued;
191 struct libinput_source *source;
192 unsigned int timeout;
193 enum tp_tap_state state;
197 #define tp_for_each_touch(_tp, _t) \
198 for (unsigned int _i = 0; _i < (_tp)->ntouches && (_t = &(_tp)->touches[_i]); _i++)
201 tp_get_delta(struct tp_touch *t, double *dx, double *dy);
204 tp_set_pointer(struct tp_dispatch *tp, struct tp_touch *t);
207 tp_tap_handle_state(struct tp_dispatch *tp, uint32_t time);
210 tp_tap_handle_timeout(struct tp_dispatch *tp, uint32_t time);
213 tp_init_tap(struct tp_dispatch *tp);
216 tp_destroy_tap(struct tp_dispatch *tp);
219 tp_init_buttons(struct tp_dispatch *tp, struct evdev_device *device);
222 tp_destroy_buttons(struct tp_dispatch *tp);
225 tp_process_button(struct tp_dispatch *tp,
226 const struct input_event *e,
230 tp_post_button_events(struct tp_dispatch *tp, uint32_t time);
233 tp_button_handle_state(struct tp_dispatch *tp, uint32_t time);
236 tp_button_touch_active(struct tp_dispatch *tp, struct tp_touch *t);