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.
This commit is contained in:
José Expósito 2021-07-12 19:50:09 +02:00 committed by Simon Ser
parent fb15538247
commit d069a783bc
2 changed files with 17 additions and 0 deletions

View file

@ -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

View file

@ -18,6 +18,8 @@ void wlr_pointer_init(struct wlr_pointer *pointer,
wl_signal_init(&pointer->events.pinch_begin);
wl_signal_init(&pointer->events.pinch_update);
wl_signal_init(&pointer->events.pinch_end);
wl_signal_init(&pointer->events.hold_begin);
wl_signal_init(&pointer->events.hold_end);
}
void wlr_pointer_destroy(struct wlr_pointer *pointer) {