OLD | NEW |
1 // Copyright 2013 The Chromium Authors. All rights reserved. | 1 // Copyright 2013 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef CONTENT_BROWSER_RENDERER_HOST_INPUT_TOUCH_EVENT_QUEUE_H_ | 5 #ifndef CONTENT_BROWSER_RENDERER_HOST_INPUT_TOUCH_EVENT_QUEUE_H_ |
6 #define CONTENT_BROWSER_RENDERER_HOST_INPUT_TOUCH_EVENT_QUEUE_H_ | 6 #define CONTENT_BROWSER_RENDERER_HOST_INPUT_TOUCH_EVENT_QUEUE_H_ |
7 | 7 |
8 #include <deque> | 8 #include <deque> |
9 #include <map> | 9 #include <map> |
10 | 10 |
(...skipping 18 matching lines...) Expand all Loading... |
29 const TouchEventWithLatencyInfo& event) = 0; | 29 const TouchEventWithLatencyInfo& event) = 0; |
30 | 30 |
31 virtual void OnTouchEventAck( | 31 virtual void OnTouchEventAck( |
32 const TouchEventWithLatencyInfo& event, | 32 const TouchEventWithLatencyInfo& event, |
33 InputEventAckState ack_result) = 0; | 33 InputEventAckState ack_result) = 0; |
34 }; | 34 }; |
35 | 35 |
36 // A queue for throttling and coalescing touch-events. | 36 // A queue for throttling and coalescing touch-events. |
37 class CONTENT_EXPORT TouchEventQueue { | 37 class CONTENT_EXPORT TouchEventQueue { |
38 public: | 38 public: |
| 39 // Different ways of dealing with touch events during scrolling. |
| 40 // TODO(rbyers): Remove (or otherwise update) this once results of |
| 41 // experiments are complete. http://crbug.com/328503 |
| 42 enum TouchScrollingMode { |
| 43 // Send a touchcancel on scroll start and no further touch events for the |
| 44 // duration of the scroll. Chrome Android's traditional behavior. |
| 45 TOUCH_SCROLLING_MODE_TOUCHCANCEL, |
| 46 // Send touchmove events throughout a scroll, blocking on each ACK and |
| 47 // using the disposition to determine whether a scroll update should be |
| 48 // sent. Mobile Safari's default overflow scroll behavior. |
| 49 TOUCH_SCROLLING_MODE_SYNC_TOUCHMOVE, |
| 50 // Like sync, except that consumed scroll events cause subsequent touchmove |
| 51 // events to be suppressed. Unconsumed scroll events return touchmove |
| 52 // events to being dispatched synchronously (so scrolling may be hijacked |
| 53 // when a scroll limit is reached, and later resumed). |
| 54 TOUCH_SCROLLING_MODE_ABSORB_TOUCHMOVE, |
| 55 TOUCH_SCROLLING_MODE_DEFAULT = TOUCH_SCROLLING_MODE_TOUCHCANCEL |
| 56 }; |
39 | 57 |
40 // The |client| must outlive the TouchEventQueue. | 58 // The |client| must outlive the TouchEventQueue. |
41 explicit TouchEventQueue(TouchEventQueueClient* client); | 59 TouchEventQueue(TouchEventQueueClient* client, TouchScrollingMode mode); |
42 ~TouchEventQueue(); | 60 ~TouchEventQueue(); |
43 | 61 |
44 // Adds an event to the queue. The event may be coalesced with previously | 62 // Adds an event to the queue. The event may be coalesced with previously |
45 // queued events (e.g. consecutive touch-move events can be coalesced into a | 63 // queued events (e.g. consecutive touch-move events can be coalesced into a |
46 // single touch-move event). The event may also be immediately forwarded to | 64 // single touch-move event). The event may also be immediately forwarded to |
47 // the renderer (e.g. when there are no other queued touch event). | 65 // the renderer (e.g. when there are no other queued touch event). |
48 void QueueEvent(const TouchEventWithLatencyInfo& event); | 66 void QueueEvent(const TouchEventWithLatencyInfo& event); |
49 | 67 |
50 // Notifies the queue that a touch-event has been processed by the renderer. | 68 // Notifies the queue that a touch-event has been processed by the renderer. |
51 // At this point, the queue may send one or more gesture events and/or | 69 // At this point, the queue may send one or more gesture events and/or |
52 // additional queued touch-events to the renderer. | 70 // additional queued touch-events to the renderer. |
53 void ProcessTouchAck(InputEventAckState ack_result, | 71 void ProcessTouchAck(InputEventAckState ack_result, |
54 const ui::LatencyInfo& latency_info); | 72 const ui::LatencyInfo& latency_info); |
55 | 73 |
56 // When GestureScrollBegin is received, we send a touch cancel to renderer, | 74 // When GestureScrollBegin is received, we send a touch cancel to renderer, |
57 // route all the following touch events directly to client, and ignore the | 75 // route all the following touch events directly to client, and ignore the |
58 // ack for the touch cancel. When Gesture{ScrollEnd,FlingStart} is received, | 76 // ack for the touch cancel. When Gesture{ScrollEnd,FlingStart} is received, |
59 // resume the normal flow of sending touch events to the renderer. | 77 // resume the normal flow of sending touch events to the renderer. |
60 void OnGestureScrollEvent(const GestureEventWithLatencyInfo& gesture_event); | 78 void OnGestureScrollEvent(const GestureEventWithLatencyInfo& gesture_event); |
61 | 79 |
| 80 void OnGestureEventAck( |
| 81 const GestureEventWithLatencyInfo& event, |
| 82 InputEventAckState ack_result); |
| 83 |
62 // Notifies the queue whether the renderer has at least one touch handler. | 84 // Notifies the queue whether the renderer has at least one touch handler. |
63 void OnHasTouchEventHandlers(bool has_handlers); | 85 void OnHasTouchEventHandlers(bool has_handlers); |
64 | 86 |
65 // Returns whether the currently pending touch event (waiting ACK) is for | 87 // Returns whether the currently pending touch event (waiting ACK) is for |
66 // a touch start event. | 88 // a touch start event. |
67 bool IsPendingAckTouchStart() const; | 89 bool IsPendingAckTouchStart() const; |
68 | 90 |
69 // Sets whether a delayed touch ack will cancel and flush the current | 91 // Sets whether a delayed touch ack will cancel and flush the current |
70 // touch sequence. | 92 // touch sequence. |
71 void SetAckTimeoutEnabled(bool enabled, size_t ack_timeout_delay_ms); | 93 void SetAckTimeoutEnabled(bool enabled, size_t ack_timeout_delay_ms); |
(...skipping 86 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
158 TouchFilteringState touch_filtering_state_; | 180 TouchFilteringState touch_filtering_state_; |
159 | 181 |
160 // Optional handler for timed-out touch event acks, disabled by default. | 182 // Optional handler for timed-out touch event acks, disabled by default. |
161 bool ack_timeout_enabled_; | 183 bool ack_timeout_enabled_; |
162 scoped_ptr<TouchTimeoutHandler> timeout_handler_; | 184 scoped_ptr<TouchTimeoutHandler> timeout_handler_; |
163 | 185 |
164 // Optional suppression of TouchMove's within a slop region when a sequence | 186 // Optional suppression of TouchMove's within a slop region when a sequence |
165 // has not yet been preventDefaulted, disabled by default. | 187 // has not yet been preventDefaulted, disabled by default. |
166 scoped_ptr<TouchMoveSlopSuppressor> touchmove_slop_suppressor_; | 188 scoped_ptr<TouchMoveSlopSuppressor> touchmove_slop_suppressor_; |
167 | 189 |
| 190 // How touch events are handled during scrolling. For now this is a global |
| 191 // setting for experimentation, but we may evolve it into an app-controlled |
| 192 // mode. |
| 193 const TouchScrollingMode touch_scrolling_mode_; |
| 194 |
| 195 // Whether touchmove events should be dropped due to the |
| 196 // TOUCH_SCROLLING_MODE_ABSORB_TOUCHMOVE mode. Note that we can't use |
| 197 // touch_filtering_state_ for this (without adding a few new states and |
| 198 // complicating the code significantly) because it can occur with and without |
| 199 // timeout, and shouldn't cause touchend to be dropped. |
| 200 bool absorbing_touch_moves_; |
| 201 |
168 DISALLOW_COPY_AND_ASSIGN(TouchEventQueue); | 202 DISALLOW_COPY_AND_ASSIGN(TouchEventQueue); |
169 }; | 203 }; |
170 | 204 |
171 } // namespace content | 205 } // namespace content |
172 | 206 |
173 #endif // CONTENT_BROWSER_RENDERER_HOST_INPUT_TOUCH_EVENT_QUEUE_H_ | 207 #endif // CONTENT_BROWSER_RENDERER_HOST_INPUT_TOUCH_EVENT_QUEUE_H_ |
OLD | NEW |