/* * Copyright (C) 2016 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 com.android.systemui.animation; import android.graphics.Path; import android.util.MathUtils; import android.view.animation.AccelerateDecelerateInterpolator; import android.view.animation.AccelerateInterpolator; import android.view.animation.BounceInterpolator; import android.view.animation.DecelerateInterpolator; import android.view.animation.Interpolator; import android.view.animation.LinearInterpolator; import android.view.animation.PathInterpolator; /** * Utility class to receive interpolators from. * * Make sure that changes made to this class are also reflected in {@link InterpolatorsAndroidX}. * Please consider using the androidx dependencies featuring better testability altogether. */ public class Interpolators { /* * ============================================================================================ * Emphasized interpolators. * ============================================================================================ */ /** * The default emphasized interpolator. Used for hero / emphasized movement of content. */ public static final Interpolator EMPHASIZED = createEmphasizedInterpolator(); /** * The accelerated emphasized interpolator. Used for hero / emphasized movement of content that * is disappearing e.g. when moving off screen. */ public static final Interpolator EMPHASIZED_ACCELERATE = new PathInterpolator( 0.3f, 0f, 0.8f, 0.15f); /** * The decelerating emphasized interpolator. Used for hero / emphasized movement of content that * is appearing e.g. when coming from off screen */ public static final Interpolator EMPHASIZED_DECELERATE = new PathInterpolator( 0.05f, 0.7f, 0.1f, 1f); /* * ============================================================================================ * Standard interpolators. * ============================================================================================ */ /** * The standard interpolator that should be used on every normal animation */ public static final Interpolator STANDARD = new PathInterpolator( 0.2f, 0f, 0f, 1f); /** * The standard accelerating interpolator that should be used on every regular movement of * content that is disappearing e.g. when moving off screen. */ public static final Interpolator STANDARD_ACCELERATE = new PathInterpolator( 0.3f, 0f, 1f, 1f); /** * The standard decelerating interpolator that should be used on every regular movement of * content that is appearing e.g. when coming from off screen. */ public static final Interpolator STANDARD_DECELERATE = new PathInterpolator( 0f, 0f, 0f, 1f); /* * ============================================================================================ * Legacy * ============================================================================================ */ /** * The default legacy interpolator as defined in Material 1. Also known as FAST_OUT_SLOW_IN. */ public static final Interpolator LEGACY = new PathInterpolator(0.4f, 0f, 0.2f, 1f); /** * The default legacy accelerating interpolator as defined in Material 1. * Also known as FAST_OUT_LINEAR_IN. */ public static final Interpolator LEGACY_ACCELERATE = new PathInterpolator(0.4f, 0f, 1f, 1f); /** * The default legacy decelerating interpolator as defined in Material 1. * Also known as LINEAR_OUT_SLOW_IN. */ public static final Interpolator LEGACY_DECELERATE = new PathInterpolator(0f, 0f, 0.2f, 1f); /** * Linear interpolator. Often used if the interpolator is for different properties who need * different interpolations. */ public static final Interpolator LINEAR = new LinearInterpolator(); /* * ============================================================================================ * Custom interpolators * ============================================================================================ */ public static final Interpolator FAST_OUT_SLOW_IN = LEGACY; public static final Interpolator FAST_OUT_LINEAR_IN = LEGACY_ACCELERATE; public static final Interpolator LINEAR_OUT_SLOW_IN = LEGACY_DECELERATE; /** * Like {@link #FAST_OUT_SLOW_IN}, but used in case the animation is played in reverse (i.e. t * goes from 1 to 0 instead of 0 to 1). */ public static final Interpolator FAST_OUT_SLOW_IN_REVERSE = new PathInterpolator(0.8f, 0f, 0.6f, 1f); public static final Interpolator SLOW_OUT_LINEAR_IN = new PathInterpolator(0.8f, 0f, 1f, 1f); public static final Interpolator ALPHA_IN = new PathInterpolator(0.4f, 0f, 1f, 1f); public static final Interpolator ALPHA_OUT = new PathInterpolator(0f, 0f, 0.8f, 1f); public static final Interpolator ACCELERATE = new AccelerateInterpolator(); public static final Interpolator ACCELERATE_DECELERATE = new AccelerateDecelerateInterpolator(); public static final Interpolator DECELERATE_QUINT = new DecelerateInterpolator(2.5f); public static final Interpolator CUSTOM_40_40 = new PathInterpolator(0.4f, 0f, 0.6f, 1f); public static final Interpolator ICON_OVERSHOT = new PathInterpolator(0.4f, 0f, 0.2f, 1.4f); public static final Interpolator ICON_OVERSHOT_LESS = new PathInterpolator(0.4f, 0f, 0.2f, 1.1f); public static final Interpolator PANEL_CLOSE_ACCELERATED = new PathInterpolator(0.3f, 0, 0.5f, 1); public static final Interpolator BOUNCE = new BounceInterpolator(); /** * For state transitions on the control panel that lives in GlobalActions. */ public static final Interpolator CONTROL_STATE = new PathInterpolator(0.4f, 0f, 0.2f, 1.0f); /** * Interpolator to be used when animating a move based on a click. Pair with enough duration. */ public static final Interpolator TOUCH_RESPONSE = new PathInterpolator(0.3f, 0f, 0.1f, 1f); /** * Like {@link #TOUCH_RESPONSE}, but used in case the animation is played in reverse (i.e. t * goes from 1 to 0 instead of 0 to 1). */ public static final Interpolator TOUCH_RESPONSE_REVERSE = new PathInterpolator(0.9f, 0f, 0.7f, 1f); /* * ============================================================================================ * Functions / Utilities * ============================================================================================ */ /** * Calculate the amount of overshoot using an exponential falloff function with desired * properties, where the overshoot smoothly transitions at the 1.0f boundary into the * overshoot, retaining its acceleration. * * @param progress a progress value going from 0 to 1 * @param overshootAmount the amount > 0 of overshoot desired. A value of 0.1 means the max * value of the overall progress will be at 1.1. * @param overshootStart the point in (0,1] where the result should reach 1 * @return the interpolated overshoot */ public static float getOvershootInterpolation(float progress, float overshootAmount, float overshootStart) { if (overshootAmount == 0.0f || overshootStart == 0.0f) { throw new IllegalArgumentException("Invalid values for overshoot"); } float b = MathUtils.log((overshootAmount + 1) / (overshootAmount)) / overshootStart; return MathUtils.max(0.0f, (float) (1.0f - Math.exp(-b * progress)) * (overshootAmount + 1.0f)); } /** * Similar to {@link #getOvershootInterpolation(float, float, float)} but the overshoot * starts immediately here, instead of first having a section of non-overshooting * * @param progress a progress value going from 0 to 1 */ public static float getOvershootInterpolation(float progress) { return MathUtils.max(0.0f, (float) (1.0f - Math.exp(-4 * progress))); } // Create the default emphasized interpolator private static PathInterpolator createEmphasizedInterpolator() { Path path = new Path(); // Doing the same as fast_out_extra_slow_in path.moveTo(0f, 0f); path.cubicTo(0.05f, 0f, 0.133333f, 0.06f, 0.166666f, 0.4f); path.cubicTo(0.208333f, 0.82f, 0.25f, 1f, 1f, 1f); return new PathInterpolator(path); } }