ui/events/gesture_detection/gesture_provider.h

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef UI_EVENTS_GESTURE_DETECTION_GESTURE_PROVIDER_H_
   6 #define UI_EVENTS_GESTURE_DETECTION_GESTURE_PROVIDER_H_
   7
   8 #include "base/basictypes.h"
   9 #include "base/memory/scoped_ptr.h"
  10 #include "ui/events/gesture_detection/gesture_detection_export.h"
  11 #include "ui/events/gesture_detection/gesture_detector.h"
  12 #include "ui/events/gesture_detection/gesture_event_data.h"
  13 #include "ui/events/gesture_detection/gesture_touch_uma_histogram.h"
  14 #include "ui/events/gesture_detection/scale_gesture_detector.h"
  15 #include "ui/events/gesture_detection/snap_scroll_controller.h"
  16 #include "ui/gfx/display.h"
  17
  18 namespace ui {
  19
  20 class GESTURE_DETECTION_EXPORT GestureProviderClient {
  21  public:
  22   virtual ~GestureProviderClient() {}
  23   virtual void OnGestureEvent(const GestureEventData& gesture) = 0;
  24 };
  25
  26 // Given a stream of |MotionEvent|'s, provides gesture detection and gesture
  27 // event dispatch.
  28 class GESTURE_DETECTION_EXPORT GestureProvider {
  29  public:
  30   struct GESTURE_DETECTION_EXPORT Config {
  31     Config();
  32     ~Config();
  33     gfx::Display display;
  34     GestureDetector::Config gesture_detector_config;
  35     ScaleGestureDetector::Config scale_gesture_detector_config;
  36
  37     // Whether double-tap detection is supported by the platform. If disabled,
  38     // there will be no delay before tap events. Defaults to true.
  39     bool double_tap_support_for_platform_enabled;
  40
  41     // If |gesture_begin_end_types_enabled| is true, fire an ET_GESTURE_BEGIN
  42     // event for every added touch point, and an ET_GESTURE_END event for every
  43     // removed touch point. This requires one ACTION_CANCEL event to be sent per
  44     // touch point, which only occurs on Aura. Defaults to false.
  45     bool gesture_begin_end_types_enabled;
  46
  47     // The min and max size (both length and width, in dips) of the generated
  48     // bounding box for all gesture types. This is useful for touch streams
  49     // that may report zero or unreasonably small or large touch sizes.
  50     // Note that these bounds are only applied for touch or unknown tool types;
  51     // mouse and stylus-derived gestures will not be affected.
  52     // Both values default to 0 (disabled).
  53     float min_gesture_bounds_length;
  54     float max_gesture_bounds_length;
  55   };
  56
  57   GestureProvider(const Config& config, GestureProviderClient* client);
  58   ~GestureProvider();
  59
  60   // Handle the incoming MotionEvent, returning false if the event could not
  61   // be handled.
  62   bool OnTouchEvent(const MotionEvent& event);
  63
  64   // Reset any active gesture detection, including detection of timeout-based
  65   // events (e.g., double-tap or delayed tap) for which the pointer has already
  66   // been released.
  67   void ResetDetection();
  68
  69   // Update whether multi-touch pinch zoom is supported by the platform.
  70   void SetMultiTouchZoomSupportEnabled(bool enabled);
  71
  72   // Update whether double-tap gestures are supported by the platform.
  73   void SetDoubleTapSupportForPlatformEnabled(bool enabled);
  74
  75   // Update whether double-tap gesture detection should be suppressed, e.g.,
  76   // if the page scale is fixed or the page has a mobile viewport. This disables
  77   // the tap delay, allowing rapid and responsive single-tap gestures.
  78   void SetDoubleTapSupportForPageEnabled(bool enabled);
  79
  80   // Whether a scroll gesture is in-progress.
  81   bool IsScrollInProgress() const;
  82
  83   // Whether a pinch gesture is in-progress (i.e. a pinch update has been
  84   // forwarded and detection is still active).
  85   bool IsPinchInProgress() const;
  86
  87   // Whether a double-tap gesture is in-progress (either double-tap or
  88   // double-tap drag zoom).
  89   bool IsDoubleTapInProgress() const;
  90
  91   // May be NULL if there is no currently active touch sequence.
  92   const ui::MotionEvent* current_down_event() const {
  93     return current_down_event_.get();
  94   }
  95
  96  private:
  97   bool CanHandle(const MotionEvent& event) const;
  98   void OnTouchEventHandlingBegin(const MotionEvent& event);
  99   void OnTouchEventHandlingEnd(const MotionEvent& event);
 100   void UpdateDoubleTapDetectionSupport();
 101
 102   class GestureListenerImpl;
 103   scoped_ptr<GestureListenerImpl> gesture_listener_;
 104
 105   scoped_ptr<MotionEvent> current_down_event_;
 106
 107   // Logs information on touch and gesture events.
 108   GestureTouchUMAHistogram uma_histogram_;
 109
 110   // Whether double-tap gesture detection is currently supported.
 111   bool double_tap_support_for_page_;
 112   bool double_tap_support_for_platform_;
 113
 114   const bool gesture_begin_end_types_enabled_;
 115 };
 116
 117 }  //  namespace ui
 118
 119 #endif  // UI_EVENTS_GESTURE_DETECTION_GESTURE_PROVIDER_H_