pointer: add hold pointer event definition

As touchpad touches are generally fully abstracted, a client cannot
currently know when a user is interacting with the touchpad without
moving. This is solved by hold gestures.

Hold gestures are notifications about one or more fingers being held
down on the touchpad without significant movement.

Hold gestures are primarily designed for two interactions:

 - Hold to interact: where a hold gesture is active for some time a
   menu could pop up, some object could be selected, etc.
 - Hold to cancel: where e.g. kinetic scrolling is currently active,
   the start of a hold gesture can be used to stop the scroll.

Unlike swipe and pinch, hold gestures, by definition, do not have
movement, so there is no need for an "update" stage in the gesture.

Create two structs, wlr_event_pointer_hold_begin and
wlr_event_pointer_hold_end, to represent hold gesture events and the
signals to emit them: wlr_pointer->pointer.hold_begin/hold_end.

1 files changed, 15 insertions, 0 deletions

diff --git a/include/wlr/types/wlr_pointer.h b/include/wlr/types/wlr_pointer.h
index 1380fa76..bcfb2ad3 100644
--- a/include/wlr/types/wlr_pointer.h
+++ b/include/wlr/types/wlr_pointer.h
@@ -33,6 +33,9 @@ struct wlr_pointer {
 		struct wl_signal pinch_begin; // struct wlr_event_pointer_pinch_begin
 		struct wl_signal pinch_update; // struct wlr_event_pointer_pinch_update
 		struct wl_signal pinch_end; // struct wlr_event_pointer_pinch_end
+
+		struct wl_signal hold_begin; // struct wlr_event_pointer_hold_begin
+		struct wl_signal hold_end; // struct wlr_event_pointer_hold_end
 	} events;
 
 	void *data;
@@ -126,4 +129,16 @@ struct wlr_event_pointer_pinch_end {
 	bool cancelled;
 };
 
+struct wlr_event_pointer_hold_begin {
+	struct wlr_input_device *device;
+	uint32_t time_msec;
+	uint32_t fingers;
+};
+
+struct wlr_event_pointer_hold_end {
+	struct wlr_input_device *device;
+	uint32_t time_msec;
+	bool cancelled;
+};
+
 #endif