OLD | NEW |
1 // Copyright 2012 The Chromium Authors. All rights reserved. | 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 | 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 CC_ANIMATION_H_ | 5 #ifndef CC_ANIMATION_H_ |
6 #define CC_ANIMATION_H_ | 6 #define CC_ANIMATION_H_ |
7 | 7 |
8 #include "base/basictypes.h" | 8 #include "base/basictypes.h" |
9 #include "base/memory/scoped_ptr.h" | 9 #include "base/memory/scoped_ptr.h" |
10 #include "cc/cc_export.h" | 10 #include "cc/cc_export.h" |
11 | 11 |
12 namespace cc { | 12 namespace cc { |
13 | 13 |
14 class AnimationCurve; | 14 class AnimationCurve; |
15 | 15 |
16 // An Animation, contains all the state required to play an AnimationCurve. | 16 // An Animation, contains all the state required to play an AnimationCurve. |
17 // Specifically, the affected property, the run state (paused, finished, etc.), | 17 // Specifically, the affected property, the run state (paused, finished, etc.), |
18 // loop count, last pause time, and the total time spent paused. | 18 // loop count, last pause time, and the total time spent paused. |
19 class CC_EXPORT Animation { | 19 class CC_EXPORT Animation { |
20 public: | 20 public: |
21 // Animations begin in one of the 'waiting' states. Animations waiting for t
he next tick | 21 // Animations begin in one of the 'waiting' states. Animations waiting for the |
22 // will start the next time the controller animates. Animations waiting for
target | 22 // next tick will start the next time the controller animates. Animations |
23 // availibility will run as soon as their target property is free (and all t
he animations | 23 // waiting for target availibility will run as soon as their target property |
24 // animating with it are also able to run). Animations waiting for their sta
rt time to | 24 // is free (and all the animations animating with it are also able to run). |
25 // come have be scheduled to run at a particular point in time. When this ti
me arrives, | 25 // Animations waiting for their start time to come have be scheduled to run at |
26 // the controller will move the animations into the Starting state, and then
into the | 26 // a particular point in time. When this time arrives, the controller will |
27 // Running state. Running animations may toggle between Running and Paused,
and may be | 27 // move the animations into the Starting state, and then into the Running |
28 // stopped by moving into either the Aborted or Finished states. A Finished
animation | 28 // state. Running animations may toggle between Running and Paused, and may be |
29 // was allowed to run to completion, but an Aborted animation was not. | 29 // stopped by moving into either the Aborted or Finished states. A Finished |
30 enum RunState { | 30 // animation was allowed to run to completion, but an Aborted animation was |
31 WaitingForNextTick = 0, | 31 // not. |
32 WaitingForTargetAvailability, | 32 enum RunState { |
33 WaitingForStartTime, | 33 WaitingForNextTick = 0, |
34 WaitingForDeletion, | 34 WaitingForTargetAvailability, |
35 Starting, | 35 WaitingForStartTime, |
36 Running, | 36 WaitingForDeletion, |
37 Paused, | 37 Starting, |
38 Finished, | 38 Running, |
39 Aborted, | 39 Paused, |
40 // This sentinel must be last. | 40 Finished, |
41 RunStateEnumSize | 41 Aborted, |
42 }; | 42 // This sentinel must be last. |
| 43 RunStateEnumSize |
| 44 }; |
43 | 45 |
44 enum TargetProperty { | 46 enum TargetProperty { |
45 Transform = 0, | 47 Transform = 0, |
46 Opacity, | 48 Opacity, |
47 // This sentinel must be last. | 49 // This sentinel must be last. |
48 TargetPropertyEnumSize | 50 TargetPropertyEnumSize |
49 }; | 51 }; |
50 | 52 |
51 static scoped_ptr<Animation> create(scoped_ptr<AnimationCurve>, int animatio
nId, int groupId, TargetProperty); | 53 static scoped_ptr<Animation> Create(scoped_ptr<AnimationCurve> curve, |
| 54 int animation_id, |
| 55 int group_id, |
| 56 TargetProperty target_property); |
52 | 57 |
53 virtual ~Animation(); | 58 virtual ~Animation(); |
54 | 59 |
55 int id() const { return m_id; } | 60 int id() const { return id_; } |
56 int group() const { return m_group; } | 61 int group() const { return group_; } |
57 TargetProperty targetProperty() const { return m_targetProperty; } | 62 TargetProperty target_property() const { return target_property_; } |
58 | 63 |
59 RunState runState() const { return m_runState; } | 64 RunState run_state() const { return run_state_; } |
60 void setRunState(RunState, double monotonicTime); | 65 void SetRunState(RunState run_state, double monotonic_time); |
61 | 66 |
62 // This is the number of times that the animation will play. If this | 67 // This is the number of times that the animation will play. If this |
63 // value is zero the animation will not play. If it is negative, then | 68 // value is zero the animation will not play. If it is negative, then |
64 // the animation will loop indefinitely. | 69 // the animation will loop indefinitely. |
65 int iterations() const { return m_iterations; } | 70 int iterations() const { return iterations_; } |
66 void setIterations(int n) { m_iterations = n; } | 71 void set_iterations(int n) { iterations_ = n; } |
67 | 72 |
68 double startTime() const { return m_startTime; } | 73 double start_time() const { return start_time_; } |
69 void setStartTime(double monotonicTime) { m_startTime = monotonicTime; } | 74 void set_start_time(double monotonic_time) { start_time_ = monotonic_time; } |
70 bool hasSetStartTime() const { return !!m_startTime; } | 75 bool has_set_start_time() const { return !!start_time_; } |
71 | 76 |
72 double timeOffset() const { return m_timeOffset; } | 77 double time_offset() const { return time_offset_; } |
73 void setTimeOffset(double monotonicTime) { m_timeOffset = monotonicTime; } | 78 void set_time_offset(double monotonic_time) { time_offset_ = monotonic_time; } |
74 | 79 |
75 void suspend(double monotonicTime); | 80 void Suspend(double monotonic_time); |
76 void resume(double monotonicTime); | 81 void Resume(double monotonic_time); |
77 | 82 |
78 // If alternatesDirection is true, on odd numbered iterations we reverse the
curve. | 83 // If alternatesDirection is true, on odd numbered iterations we reverse the |
79 bool alternatesDirection() const { return m_alternatesDirection; } | 84 // curve. |
80 void setAlternatesDirection(bool alternates) { m_alternatesDirection = alter
nates; } | 85 bool alternates_direction() const { return alternates_direction_; } |
| 86 void set_alternates_direction(bool alternates) { |
| 87 alternates_direction_ = alternates; |
| 88 } |
81 | 89 |
82 bool isFinishedAt(double monotonicTime) const; | 90 bool IsFinishedAt(double monotonic_time) const; |
83 bool isFinished() const { return m_runState == Finished | 91 bool is_finished() const { |
84 || m_runState == Aborted | 92 return run_state_ == Finished || |
85 || m_runState == WaitingForDeletion; } | 93 run_state_ == Aborted || |
| 94 run_state_ == WaitingForDeletion; |
| 95 } |
86 | 96 |
87 AnimationCurve* curve() { return m_curve.get(); } | 97 AnimationCurve* curve() { return curve_.get(); } |
88 const AnimationCurve* curve() const { return m_curve.get(); } | 98 const AnimationCurve* curve() const { return curve_.get(); } |
89 | 99 |
90 // If this is true, even if the animation is running, it will not be tickabl
e until | 100 // If this is true, even if the animation is running, it will not be tickable |
91 // it is given a start time. This is true for animations running on the main
thread. | 101 // until it is given a start time. This is true for animations running on the |
92 bool needsSynchronizedStartTime() const { return m_needsSynchronizedStartTim
e; } | 102 // main thread. |
93 void setNeedsSynchronizedStartTime(bool needsSynchronizedStartTime) { m_need
sSynchronizedStartTime = needsSynchronizedStartTime; } | 103 bool needs_synchronized_start_time() const { |
| 104 return needs_synchronized_start_time_; |
| 105 } |
| 106 void set_needs_synchronized_start_time(bool needs_synchronized_start_time) { |
| 107 needs_synchronized_start_time_ = needs_synchronized_start_time; |
| 108 } |
94 | 109 |
95 // Takes the given absolute time, and using the start time and the number | 110 // Takes the given absolute time, and using the start time and the number |
96 // of iterations, returns the relative time in the current iteration. | 111 // of iterations, returns the relative time in the current iteration. |
97 double trimTimeToCurrentIteration(double monotonicTime) const; | 112 double TrimTimeToCurrentIteration(double monotonic_time) const; |
98 | 113 |
99 enum InstanceType { | 114 enum InstanceType { |
100 ControllingInstance = 0, | 115 ControllingInstance = 0, |
101 NonControllingInstance | 116 NonControllingInstance |
102 }; | 117 }; |
103 | 118 |
104 scoped_ptr<Animation> clone(InstanceType) const; | 119 scoped_ptr<Animation> Clone(InstanceType instance_type) const; |
105 scoped_ptr<Animation> cloneAndInitialize(InstanceType, RunState initialRunSt
ate, double startTime) const; | 120 scoped_ptr<Animation> CloneAndInitialize(InstanceType instance_type, |
106 bool isControllingInstance() const { return m_isControllingInstance; } | 121 RunState initial_run_state, |
| 122 double start_time) const; |
| 123 bool is_controlling_instance() const { return is_controlling_instance_; } |
107 | 124 |
108 void pushPropertiesTo(Animation*) const; | 125 void PushPropertiesTo(Animation* other) const; |
109 | 126 |
110 void setIsImplOnly(bool isImplOnly) { m_isImplOnly = isImplOnly; } | 127 void set_is_impl_only(bool is_impl_only) { is_impl_only_ = is_impl_only; } |
111 bool isImplOnly() { return m_isImplOnly; } | 128 bool is_impl_only() const { return is_impl_only_; } |
112 | 129 |
113 private: | 130 private: |
114 Animation(scoped_ptr<AnimationCurve>, int animationId, int groupId, TargetPr
operty); | 131 Animation(scoped_ptr<AnimationCurve> curve, |
| 132 int animation_id, |
| 133 int group_id, |
| 134 TargetProperty target_property); |
115 | 135 |
116 scoped_ptr<AnimationCurve> m_curve; | 136 scoped_ptr<AnimationCurve> curve_; |
117 | 137 |
118 // IDs are not necessarily unique. | 138 // IDs are not necessarily unique. |
119 int m_id; | 139 int id_; |
120 | 140 |
121 // Animations that must be run together are called 'grouped' and have the sa
me group id | 141 // Animations that must be run together are called 'grouped' and have the same |
122 // Grouped animations are guaranteed to start at the same time and no other
animations | 142 // group id. Grouped animations are guaranteed to start at the same time and |
123 // may animate any of the group's target properties until all animations in
the | 143 // no other animations may animate any of the group's target properties until |
124 // group have finished animating. Note: an active animation's group id and t
arget | 144 // all animations in the group have finished animating. Note: an active |
125 // property uniquely identify that animation. | 145 // animation's group id and target property uniquely identify that animation. |
126 int m_group; | 146 int group_; |
127 | 147 |
128 TargetProperty m_targetProperty; | 148 TargetProperty target_property_; |
129 RunState m_runState; | 149 RunState run_state_; |
130 int m_iterations; | 150 int iterations_; |
131 double m_startTime; | 151 double start_time_; |
132 bool m_alternatesDirection; | 152 bool alternates_direction_; |
133 | 153 |
134 // The time offset effectively pushes the start of the animation back in tim
e. This is | 154 // The time offset effectively pushes the start of the animation back in time. |
135 // used for resuming paused animations -- an animation is added with a non-z
ero time | 155 // This is used for resuming paused animations -- an animation is added with a |
136 // offset, causing the animation to skip ahead to the desired point in time. | 156 // non-zero time offset, causing the animation to skip ahead to the desired |
137 double m_timeOffset; | 157 // point in time. |
| 158 double time_offset_; |
138 | 159 |
139 bool m_needsSynchronizedStartTime; | 160 bool needs_synchronized_start_time_; |
140 | 161 |
141 // When an animation is suspended, it behaves as if it is paused and it also
ignores | 162 // When an animation is suspended, it behaves as if it is paused and it also |
142 // all run state changes until it is resumed. This is used for testing purpo
ses. | 163 // ignores all run state changes until it is resumed. This is used for testing |
143 bool m_suspended; | 164 // purposes. |
| 165 bool suspended_; |
144 | 166 |
145 // These are used in trimTimeToCurrentIteration to account for time | 167 // These are used in trimTimeToCurrentIteration to account for time |
146 // spent while paused. This is not included in AnimationState since it | 168 // spent while paused. This is not included in AnimationState since it |
147 // there is absolutely no need for clients of this controller to know | 169 // there is absolutely no need for clients of this controller to know |
148 // about these values. | 170 // about these values. |
149 double m_pauseTime; | 171 double pause_time_; |
150 double m_totalPausedTime; | 172 double total_paused_time_; |
151 | 173 |
152 // Animations lead dual lives. An active animation will be conceptually owne
d by | 174 // Animations lead dual lives. An active animation will be conceptually owned |
153 // two controllers, one on the impl thread and one on the main. In reality,
there | 175 // by two controllers, one on the impl thread and one on the main. In reality, |
154 // will be two separate Animation instances for the same animation. They | 176 // there will be two separate Animation instances for the same animation. They |
155 // will have the same group id and the same target property (these two value
s | 177 // will have the same group id and the same target property (these two values |
156 // uniquely identify an animation). The instance on the impl thread is the i
nstance | 178 // uniquely identify an animation). The instance on the impl thread is the |
157 // that ultimately controls the values of the animating layer and so we will
refer | 179 // instance that ultimately controls the values of the animating layer and so |
158 // to it as the 'controlling instance'. | 180 // we will refer to it as the 'controlling instance'. |
159 bool m_isControllingInstance; | 181 bool is_controlling_instance_; |
160 | 182 |
161 bool m_isImplOnly; | 183 bool is_impl_only_; |
162 | 184 |
163 DISALLOW_COPY_AND_ASSIGN(Animation); | 185 DISALLOW_COPY_AND_ASSIGN(Animation); |
164 }; | 186 }; |
165 | 187 |
166 } // namespace cc | 188 } // namespace cc |
167 | 189 |
168 #endif // CC_ANIMATION_H_ | 190 #endif // CC_ANIMATION_H_ |
OLD | NEW |