Home | History | Annotate | Download | only in android
      1 // Copyright (c) 2012 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 CONTENT_BROWSER_ANDROID_OVERSCROLL_GLOW_H_
      6 #define CONTENT_BROWSER_ANDROID_OVERSCROLL_GLOW_H_
      7 
      8 #include "base/memory/ref_counted.h"
      9 #include "base/memory/scoped_ptr.h"
     10 #include "base/time/time.h"
     11 #include "content/browser/android/edge_effect.h"
     12 #include "ui/gfx/size_f.h"
     13 #include "ui/gfx/vector2d_f.h"
     14 
     15 class SkBitmap;
     16 
     17 namespace cc {
     18 class Layer;
     19 }
     20 
     21 namespace content {
     22 
     23 /* |OverscrollGlow| mirrors its Android counterpart, OverscrollGlow.java.
     24  * Conscious tradeoffs were made to align this as closely as possible with the
     25  * original Android java version.
     26  */
     27 class OverscrollGlow {
     28  public:
     29   // Create and initialize a new effect with the necessary resources.
     30   // If |enabled| is false, the effect will be be deactivated until
     31   // SetEnabled(true) is called.
     32   // The caller should attach |root_layer| to the desired layer tree.
     33   static scoped_ptr<OverscrollGlow> Create(bool enabled);
     34 
     35   // Force loading of any necessary resources.  This function is thread-safe.
     36   static void EnsureResources();
     37 
     38   ~OverscrollGlow();
     39 
     40   // If false, the glow will be deactivated, and subsequent calls to
     41   // OnOverscrolled or Animate will have no effect.
     42   void SetEnabled(bool enabled);
     43 
     44   // |overscroll| is the accumulated overscroll for the current gesture.
     45   // |velocity| is the instantaneous velocity for the overscroll.
     46   void OnOverscrolled(base::TimeTicks current_time,
     47                       gfx::Vector2dF overscroll,
     48                       gfx::Vector2dF velocity);
     49 
     50   // Triggers glow recession for any active edges.
     51   // Note: This does not actually release any resources; the name mirrors that
     52   //       in Android's OverscrollGlow class.
     53   void Release(base::TimeTicks current_time);
     54 
     55   // Returns true if the effect still needs animation ticks.
     56   bool Animate(base::TimeTicks current_time);
     57 
     58   // Returns true if the effect needs animation ticks.
     59   bool NeedsAnimate() const;
     60 
     61   // The root layer of the effect (not necessarily of the tree).
     62   scoped_refptr<cc::Layer> root_layer() const {
     63     return root_layer_;
     64   }
     65 
     66   // Horizontal overscroll will be ignored when false.
     67   void set_horizontal_overscroll_enabled(bool enabled) {
     68     horizontal_overscroll_enabled_ = enabled;
     69   }
     70   // Vertical overscroll will be ignored when false.
     71   void set_vertical_overscroll_enabled(bool enabled) {
     72     vertical_overscroll_enabled_ = enabled;
     73   }
     74   // The size of the layer for which edges will be animated.
     75   void set_size(gfx::SizeF size) {
     76     size_ = size;
     77   }
     78 
     79  private:
     80   enum Axis { AXIS_X, AXIS_Y };
     81 
     82   OverscrollGlow(bool enabled, const SkBitmap& edge, const SkBitmap& glow);
     83 
     84   void Pull(base::TimeTicks current_time,
     85             gfx::Vector2dF added_overscroll);
     86   void Absorb(base::TimeTicks current_time,
     87               gfx::Vector2dF velocity,
     88               gfx::Vector2dF overscroll,
     89               gfx::Vector2dF old_overscroll);
     90 
     91   void ReleaseAxis(Axis axis, base::TimeTicks current_time);
     92 
     93   EdgeEffect* GetOppositeEdge(int edge_index);
     94 
     95   scoped_ptr<EdgeEffect> edge_effects_[EdgeEffect::EDGE_COUNT];
     96 
     97   bool enabled_;
     98   gfx::SizeF size_;
     99   gfx::Vector2dF old_overscroll_;
    100   gfx::Vector2dF old_velocity_;
    101   bool horizontal_overscroll_enabled_;
    102   bool vertical_overscroll_enabled_;
    103 
    104   scoped_refptr<cc::Layer> root_layer_;
    105 
    106   DISALLOW_COPY_AND_ASSIGN(OverscrollGlow);
    107 };
    108 
    109 }  // namespace content
    110 
    111 #endif  // CONTENT_BROWSER_ANDROID_SCROLL_GLOW_H_
    112