-
Notifications
You must be signed in to change notification settings - Fork 175
/
StopLogic.java
98 lines (87 loc) · 3.8 KB
/
StopLogic.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
/*
* Copyright (C) 2018 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package androidx.constraintlayout.motion.utils;
import androidx.constraintlayout.core.motion.utils.SpringStopEngine;
import androidx.constraintlayout.core.motion.utils.StopEngine;
import androidx.constraintlayout.core.motion.utils.StopLogicEngine;
import androidx.constraintlayout.motion.widget.MotionInterpolator;
/**
* This contains the class to provide the logic for an animation to come to a stop.
* The setup defines a series of velocity gradients that gets to the desired position
* ending at 0 velocity.
* The path is computed such that the velocities are continuous
*
* @hide
*/
public class StopLogic extends MotionInterpolator {
private StopLogicEngine mStopLogicEngine = new StopLogicEngine();
private SpringStopEngine mSpringStopEngine;
private StopEngine mEngine = mStopLogicEngine;
/**
* Debugging logic to log the state.
*
* @param desc Description to pre append
* @param time Time during animation
* @return string useful for debugging the state of the StopLogic
*/
public String debug(String desc, float time) {
return mEngine.debug(desc, time);
}
public float getVelocity(float x) {
return mEngine.getVelocity(x);
}
public void config(float currentPos, float destination, float currentVelocity, float maxTime, float maxAcceleration, float maxVelocity) {
mEngine = mStopLogicEngine;
mStopLogicEngine.config(currentPos, destination, currentVelocity, maxTime, maxAcceleration, maxVelocity);
}
/**
* This configure the stop logic to be a spring.
* Moving from currentPosition(P0) to destination with an initial velocity of currentVelocity (V0)
* moving as if it has a mass (m) with spring constant stiffness(k), and friction(c)
* It moves with the equation acceleration a = (-k.x-c.v)/m.
* x = current position - destination
* v is velocity
*
* @param currentPos The current position
* @param destination The destination position
* @param currentVelocity the initial velocity
* @param mass the mass
* @param stiffness the stiffness or spring constant (the force by which the spring pulls)
* @param damping the stiffness or spring constant. (the resistance to the motion)
* @param stopThreshold (When the max velocity of the movement is below this it stops)
* @param boundaryMode This will allow you to control if it overshoots or bounces when it hits 0 and 1
*/
public void springConfig(float currentPos, float destination, float currentVelocity,
float mass, float stiffness, float damping, float stopThreshold,
int boundaryMode) {
if (mSpringStopEngine == null) {
mSpringStopEngine = new SpringStopEngine();
}
mEngine = mSpringStopEngine;
mSpringStopEngine.springConfig(currentPos, destination, currentVelocity, mass, stiffness, damping, stopThreshold, boundaryMode);
}
@Override
public float getInterpolation(float v) {
return mEngine.getInterpolation(v);
}
@Override
public float getVelocity() {
return mEngine.getVelocity();
}
public boolean isStopped() {
return mEngine.isStopped();
}
}