OLD | NEW |
| (Empty) |
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 CONTENT_RENDERER_INPUT_INPUT_SCROLL_ELASTICITY_CONTROLLER_H_ | |
6 #define CONTENT_RENDERER_INPUT_INPUT_SCROLL_ELASTICITY_CONTROLLER_H_ | |
7 | |
8 #include "base/macros.h" | |
9 #include "base/memory/weak_ptr.h" | |
10 #include "cc/input/scroll_elasticity_helper.h" | |
11 #include "content/common/content_export.h" | |
12 #include "third_party/WebKit/public/web/WebInputEvent.h" | |
13 | |
14 // InputScrollElasticityController is based on | |
15 // WebKit/Source/platform/mac/ScrollElasticityController.h | |
16 /* | |
17 * Copyright (C) 2011 Apple Inc. All rights reserved. | |
18 * | |
19 * Redistribution and use in source and binary forms, with or without | |
20 * modification, are permitted provided that the following conditions | |
21 * are met: | |
22 * 1. Redistributions of source code must retain the above copyright | |
23 * notice, this list of conditions and the following disclaimer. | |
24 * 2. Redistributions in binary form must reproduce the above copyright | |
25 * notice, this list of conditions and the following disclaimer in the | |
26 * documentation and/or other materials provided with the distribution. | |
27 * | |
28 * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' | |
29 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, | |
30 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR | |
31 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS | |
32 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR | |
33 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF | |
34 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS | |
35 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN | |
36 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | |
37 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF | |
38 * THE POSSIBILITY OF SUCH DAMAGE. | |
39 */ | |
40 | |
41 namespace cc { | |
42 struct InputHandlerScrollResult; | |
43 } // namespace cc | |
44 | |
45 namespace content { | |
46 | |
47 class CONTENT_EXPORT InputScrollElasticityController { | |
48 public: | |
49 explicit InputScrollElasticityController(cc::ScrollElasticityHelper* helper); | |
50 virtual ~InputScrollElasticityController(); | |
51 | |
52 base::WeakPtr<InputScrollElasticityController> GetWeakPtr(); | |
53 | |
54 // Update the overscroll state based a wheel event that has been processed. | |
55 // Note that this assumes that all events are coming from a single input | |
56 // device. If the user simultaneously uses multiple input devices, Cocoa may | |
57 // not correctly pass all the gesture begin and end events. In this case, | |
58 // this class may disregard some scrolls that come in at unexpected times. | |
59 void ObserveWheelEventAndResult( | |
60 const blink::WebMouseWheelEvent& wheel_event, | |
61 const cc::InputHandlerScrollResult& scroll_result); | |
62 void Animate(base::TimeTicks time); | |
63 | |
64 void ReconcileStretchAndScroll(); | |
65 | |
66 private: | |
67 enum State { | |
68 // The initial state, during which the overscroll amount is zero and | |
69 // there are no active or momentum scroll events coming in. This state | |
70 // is briefly returned to between the active and momentum phases of a | |
71 // scroll (if there is no overscroll). | |
72 kStateInactive, | |
73 // The state between receiving PhaseBegan/MayBegin and PhaseEnd/Cancelled, | |
74 // corresponding to the period during which the user has fingers on the | |
75 // trackpad. The overscroll amount is updated as input events are received. | |
76 // When PhaseEnd is received, the state transitions to Inactive if there is | |
77 // no overscroll and MomentumAnimated if there is non-zero overscroll. | |
78 kStateActiveScroll, | |
79 // The state between receiving a momentum PhaseBegan and PhaseEnd, while | |
80 // there is no overscroll. The overscroll amount is updated as input events | |
81 // are received. If the overscroll is ever non-zero then the state | |
82 // immediately transitions to kStateMomentumAnimated. | |
83 kStateMomentumScroll, | |
84 // The state while the overscroll amount is updated by an animation. If | |
85 // the user places fingers on the trackpad (a PhaseMayBegin is received) | |
86 // then the state transition to kStateActiveScroll. Otherwise the state | |
87 // transitions to Inactive when the overscroll amount becomes zero. | |
88 kStateMomentumAnimated, | |
89 }; | |
90 | |
91 void UpdateVelocity(const gfx::Vector2dF& event_delta, | |
92 const base::TimeTicks& event_timestamp); | |
93 void Overscroll(const gfx::Vector2dF& input_delta, | |
94 const gfx::Vector2dF& overscroll_delta); | |
95 void EnterStateMomentumAnimated( | |
96 const base::TimeTicks& triggering_event_timestamp); | |
97 void EnterStateInactive(); | |
98 | |
99 // Returns true if |direction| is pointing in a direction in which it is not | |
100 // possible to scroll any farther horizontally (or vertically). It is only in | |
101 // this circumstance that an overscroll in that direction may begin. | |
102 bool PinnedHorizontally(float direction) const; | |
103 bool PinnedVertically(float direction) const; | |
104 // Whether or not the content of the page is scrollable horizontaly (or | |
105 // vertically). | |
106 bool CanScrollHorizontally() const; | |
107 bool CanScrollVertically() const; | |
108 | |
109 cc::ScrollElasticityHelper* helper_; | |
110 State state_; | |
111 | |
112 // If there is no overscroll, require a minimum overscroll delta before | |
113 // starting the rubber-band effect. Track the amount of scrolling that has | |
114 // has occurred but has not yet caused rubber-band stretching in | |
115 // |pending_overscroll_delta_|. | |
116 gfx::Vector2dF pending_overscroll_delta_; | |
117 | |
118 // Maintain a calculation of the velocity of the scroll, based on the input | |
119 // scroll delta divide by the time between input events. Track this velocity | |
120 // in |scroll_velocity| and the previous input event timestamp for finite | |
121 // differencing in |last_scroll_event_timestamp_|. | |
122 gfx::Vector2dF scroll_velocity; | |
123 base::TimeTicks last_scroll_event_timestamp_; | |
124 | |
125 // The force of the rubber-band spring. This is equal to the cumulative sum | |
126 // of all overscroll offsets since entering a non-Inactive state. This is | |
127 // reset to zero only when entering the Inactive state. | |
128 gfx::Vector2dF stretch_scroll_force_; | |
129 | |
130 // Momentum animation state. This state is valid only while the state is | |
131 // MomentumAnimated, and is initialized in EnterStateMomentumAnimated. | |
132 base::TimeTicks momentum_animation_start_time_; | |
133 gfx::Vector2dF momentum_animation_initial_stretch_; | |
134 gfx::Vector2dF momentum_animation_initial_velocity_; | |
135 | |
136 // This is set in response to a scroll (most likely programmatic) occuring | |
137 // while animating the momentum phase. In this case, re-set the initial | |
138 // velocity, stretch, and start time at the next frame (this is the same | |
139 // behavior as would happen if the scroll were caused by an active scroll). | |
140 bool momentum_animation_reset_at_next_frame_; | |
141 | |
142 base::WeakPtrFactory<InputScrollElasticityController> weak_factory_; | |
143 DISALLOW_COPY_AND_ASSIGN(InputScrollElasticityController); | |
144 }; | |
145 | |
146 } // namespace content | |
147 | |
148 #endif // CONTENT_RENDERER_INPUT_INPUT_SCROLL_ELASTICITY_CONTROLLER_H_ | |
OLD | NEW |