cc/animation/layer_animation_controller.h

   1 // Copyright 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 CC_ANIMATION_LAYER_ANIMATION_CONTROLLER_H_
   6 #define CC_ANIMATION_LAYER_ANIMATION_CONTROLLER_H_
   7
   8 #include "base/basictypes.h"
   9 #include "base/containers/hash_tables.h"
  10 #include "base/memory/ref_counted.h"
  11 #include "base/memory/scoped_ptr.h"
  12 #include "base/observer_list.h"
  13 #include "base/time/time.h"
  14 #include "cc/animation/animation_events.h"
  15 #include "cc/animation/layer_animation_event_observer.h"
  16 #include "cc/base/cc_export.h"
  17 #include "cc/base/scoped_ptr_vector.h"
  18 #include "ui/gfx/geometry/scroll_offset.h"
  19 #include "ui/gfx/transform.h"
  20
  21 namespace gfx {
  22 class BoxF;
  23 class Transform;
  24 }
  25
  26 namespace cc {
  27
  28 class Animation;
  29 class AnimationDelegate;
  30 class AnimationRegistrar;
  31 class FilterOperations;
  32 class KeyframeValueList;
  33 class LayerAnimationValueObserver;
  34 class LayerAnimationValueProvider;
  35
  36 class CC_EXPORT LayerAnimationController
  37     : public base::RefCounted<LayerAnimationController> {
  38  public:
  39   enum class ObserverType { ACTIVE, PENDING };
  40
  41   static scoped_refptr<LayerAnimationController> Create(int id);
  42
  43   int id() const { return id_; }
  44
  45   void AddAnimation(scoped_ptr<Animation> animation);
  46   void PauseAnimation(int animation_id, base::TimeDelta time_offset);
  47   void RemoveAnimation(int animation_id);
  48   void RemoveAnimation(int animation_id,
  49                        Animation::TargetProperty target_property);
  50   void AbortAnimations(Animation::TargetProperty target_property);
  51
  52   // Ensures that the list of active animations on the main thread and the impl
  53   // thread are kept in sync. This function does not take ownership of the impl
  54   // thread controller. This method is virtual for testing.
  55   virtual void PushAnimationUpdatesTo(
  56       LayerAnimationController* controller_impl);
  57
  58   void Animate(base::TimeTicks monotonic_time);
  59   void AccumulatePropertyUpdates(base::TimeTicks monotonic_time,
  60                                  AnimationEventsVector* events);
  61
  62   void UpdateState(bool start_ready_animations,
  63                    AnimationEventsVector* events);
  64
  65   // Make animations affect active observers if and only if they affect
  66   // pending observers. Any animations that no longer affect any observers
  67   // are deleted.
  68   void ActivateAnimations();
  69
  70   // Returns the active animation animating the given property that is either
  71   // running, or is next to run, if such an animation exists.
  72   Animation* GetAnimation(Animation::TargetProperty target_property) const;
  73
  74   // Returns the active animation for the given unique animation id.
  75   Animation* GetAnimationById(int animation_id) const;
  76
  77   // Returns true if there are any animations that have neither finished nor
  78   // aborted.
  79   bool HasActiveAnimation() const;
  80
  81   // Returns true if there are any animations at all to process.
  82   bool has_any_animation() const { return !animations_.empty(); }
  83
  84   // Returns true if there is an animation that is either currently animating
  85   // the given property or scheduled to animate this property in the future, and
  86   // that affects the given observer type.
  87   bool IsPotentiallyAnimatingProperty(Animation::TargetProperty target_property,
  88                                       ObserverType observer_type) const;
  89
  90   // Returns true if there is an animation that is currently animating the given
  91   // property and that affects the given observer type.
  92   bool IsCurrentlyAnimatingProperty(Animation::TargetProperty target_property,
  93                                     ObserverType observer_type) const;
  94
  95   void SetAnimationRegistrar(AnimationRegistrar* registrar);
  96   AnimationRegistrar* animation_registrar() { return registrar_; }
  97
  98   void NotifyAnimationStarted(const AnimationEvent& event);
  99   void NotifyAnimationFinished(const AnimationEvent& event);
 100   void NotifyAnimationAborted(const AnimationEvent& event);
 101   void NotifyAnimationPropertyUpdate(const AnimationEvent& event);
 102
 103   void AddValueObserver(LayerAnimationValueObserver* observer);
 104   void RemoveValueObserver(LayerAnimationValueObserver* observer);
 105
 106   void AddEventObserver(LayerAnimationEventObserver* observer);
 107   void RemoveEventObserver(LayerAnimationEventObserver* observer);
 108
 109   void set_value_provider(LayerAnimationValueProvider* provider) {
 110     value_provider_ = provider;
 111   }
 112
 113   void remove_value_provider(LayerAnimationValueProvider* provider) {
 114     if (value_provider_ == provider)
 115       value_provider_ = nullptr;
 116   }
 117
 118   void set_layer_animation_delegate(AnimationDelegate* delegate) {
 119     layer_animation_delegate_ = delegate;
 120   }
 121
 122   void remove_layer_animation_delegate(AnimationDelegate* delegate) {
 123     if (layer_animation_delegate_ == delegate)
 124       layer_animation_delegate_ = nullptr;
 125   }
 126
 127   bool HasFilterAnimationThatInflatesBounds() const;
 128   bool HasTransformAnimationThatInflatesBounds() const;
 129   bool HasAnimationThatInflatesBounds() const {
 130     return HasTransformAnimationThatInflatesBounds() ||
 131            HasFilterAnimationThatInflatesBounds();
 132   }
 133
 134   bool FilterAnimationBoundsForBox(const gfx::BoxF& box,
 135                                    gfx::BoxF* bounds) const;
 136   bool TransformAnimationBoundsForBox(const gfx::BoxF& box,
 137                                       gfx::BoxF* bounds) const;
 138
 139   bool HasAnimationThatAffectsScale() const;
 140
 141   bool HasOnlyTranslationTransforms(ObserverType observer_type) const;
 142
 143   bool AnimationsPreserveAxisAlignment() const;
 144
 145   // Sets |start_scale| to the maximum of starting animation scale along any
 146   // dimension at any destination in active animations. Returns false if the
 147   // starting scale cannot be computed.
 148   bool AnimationStartScale(ObserverType observer_type,
 149                            float* start_scale) const;
 150
 151   // Sets |max_scale| to the maximum scale along any dimension at any
 152   // destination in active animations. Returns false if the maximum scale cannot
 153   // be computed.
 154   bool MaximumTargetScale(ObserverType event_observers_,
 155                           float* max_scale) const;
 156
 157   // When a scroll animation is removed on the main thread, its compositor
 158   // thread counterpart continues producing scroll deltas until activation.
 159   // These scroll deltas need to be cleared at activation, so that the active
 160   // layer's scroll offset matches the offset provided by the main thread
 161   // rather than a combination of this offset and scroll deltas produced by
 162   // the removed animation. This is to provide the illusion of synchronicity to
 163   // JS that simultaneously removes an animation and sets the scroll offset.
 164   bool scroll_offset_animation_was_interrupted() const {
 165     return scroll_offset_animation_was_interrupted_;
 166   }
 167
 168   bool needs_to_start_animations_for_testing() {
 169     return needs_to_start_animations_;
 170   }
 171
 172  protected:
 173   friend class base::RefCounted<LayerAnimationController>;
 174
 175   explicit LayerAnimationController(int id);
 176   virtual ~LayerAnimationController();
 177
 178  private:
 179   typedef base::hash_set<int> TargetProperties;
 180
 181   void PushNewAnimationsToImplThread(
 182       LayerAnimationController* controller_impl) const;
 183   void RemoveAnimationsCompletedOnMainThread(
 184       LayerAnimationController* controller_impl) const;
 185   void PushPropertiesToImplThread(LayerAnimationController* controller_impl);
 186
 187   void StartAnimations(base::TimeTicks monotonic_time);
 188   void PromoteStartedAnimations(base::TimeTicks monotonic_time,
 189                                 AnimationEventsVector* events);
 190   void MarkFinishedAnimations(base::TimeTicks monotonic_time);
 191   void MarkAnimationsForDeletion(base::TimeTicks monotonic_time,
 192                                  AnimationEventsVector* events);
 193   void PurgeAnimationsMarkedForDeletion();
 194
 195   void TickAnimations(base::TimeTicks monotonic_time);
 196
 197   enum UpdateActivationType { NORMAL_ACTIVATION, FORCE_ACTIVATION };
 198   void UpdateActivation(UpdateActivationType type);
 199
 200   void NotifyObserversOpacityAnimated(float opacity,
 201                                       bool notify_active_observers,
 202                                       bool notify_pending_observers);
 203   void NotifyObserversTransformAnimated(const gfx::Transform& transform,
 204                                         bool notify_active_observers,
 205                                         bool notify_pending_observers);
 206   void NotifyObserversFilterAnimated(const FilterOperations& filter,
 207                                      bool notify_active_observers,
 208                                      bool notify_pending_observers);
 209   void NotifyObserversScrollOffsetAnimated(
 210       const gfx::ScrollOffset& scroll_offset,
 211       bool notify_active_observers,
 212       bool notify_pending_observers);
 213
 214   void NotifyObserversAnimationWaitingForDeletion();
 215
 216   void NotifyObserversTransformIsPotentiallyAnimatingChanged(
 217       bool notify_active_observers,
 218       bool notify_pending_observers);
 219
 220   void UpdatePotentiallyAnimatingTransform();
 221
 222   bool HasValueObserver();
 223   bool HasActiveValueObserver();
 224
 225   AnimationRegistrar* registrar_;
 226   int id_;
 227   ScopedPtrVector<Animation> animations_;
 228
 229   // This is used to ensure that we don't spam the registrar.
 230   bool is_active_;
 231
 232   base::TimeTicks last_tick_time_;
 233
 234   base::ObserverList<LayerAnimationValueObserver> value_observers_;
 235   base::ObserverList<LayerAnimationEventObserver> event_observers_;
 236
 237   LayerAnimationValueProvider* value_provider_;
 238
 239   AnimationDelegate* layer_animation_delegate_;
 240
 241   // Only try to start animations when new animations are added or when the
 242   // previous attempt at starting animations failed to start all animations.
 243   bool needs_to_start_animations_;
 244
 245   bool scroll_offset_animation_was_interrupted_;
 246
 247   bool potentially_animating_transform_for_active_observers_;
 248   bool potentially_animating_transform_for_pending_observers_;
 249
 250   DISALLOW_COPY_AND_ASSIGN(LayerAnimationController);
 251 };
 252
 253 }  // namespace cc
 254
 255 #endif  // CC_ANIMATION_LAYER_ANIMATION_CONTROLLER_H_