package com.android.systemui.statusbar import android.content.Context import android.graphics.Canvas import android.graphics.Color import android.graphics.Matrix import android.graphics.Paint import android.graphics.PointF import android.graphics.PorterDuff import android.graphics.PorterDuffColorFilter import android.graphics.PorterDuffXfermode import android.graphics.RadialGradient import android.graphics.Shader import android.os.Trace import android.util.AttributeSet import android.util.MathUtils.lerp import android.view.View import android.view.animation.PathInterpolator import com.android.systemui.animation.Interpolators import com.android.systemui.statusbar.LightRevealEffect.Companion.getPercentPastThreshold import com.android.systemui.util.getColorWithAlpha import com.android.systemui.util.leak.RotationUtils import com.android.systemui.util.leak.RotationUtils.Rotation import java.util.function.Consumer /** * Provides methods to modify the various properties of a [LightRevealScrim] to reveal between 0% to * 100% of the view(s) underneath the scrim. */ interface LightRevealEffect { fun setRevealAmountOnScrim(amount: Float, scrim: LightRevealScrim) companion object { /** * Returns the percent that the given value is past the threshold value. For example, 0.9 is * 50% of the way past 0.8. */ fun getPercentPastThreshold(value: Float, threshold: Float): Float { return (value - threshold).coerceAtLeast(0f) * (1f / (1f - threshold)) } } } /** * Light reveal effect that shows light entering the phone from the bottom of the screen. The light * enters from the bottom-middle as a narrow oval, and moves upward, eventually widening to fill the * screen. */ object LiftReveal : LightRevealEffect { /** Widen the oval of light after 35%, so it will eventually fill the screen. */ private const val WIDEN_OVAL_THRESHOLD = 0.35f /** After 85%, fade out the black color at the end of the gradient. */ private const val FADE_END_COLOR_OUT_THRESHOLD = 0.85f /** The initial width of the light oval, in percent of scrim width. */ private const val OVAL_INITIAL_WIDTH_PERCENT = 0.5f /** The initial top value of the light oval, in percent of scrim height. */ private const val OVAL_INITIAL_TOP_PERCENT = 1.1f /** The initial bottom value of the light oval, in percent of scrim height. */ private const val OVAL_INITIAL_BOTTOM_PERCENT = 1.2f /** Interpolator to use for the reveal amount. */ private val INTERPOLATOR = Interpolators.FAST_OUT_SLOW_IN_REVERSE override fun setRevealAmountOnScrim(amount: Float, scrim: LightRevealScrim) { val interpolatedAmount = INTERPOLATOR.getInterpolation(amount) val ovalWidthIncreaseAmount = getPercentPastThreshold(interpolatedAmount, WIDEN_OVAL_THRESHOLD) val initialWidthMultiplier = (1f - OVAL_INITIAL_WIDTH_PERCENT) / 2f with(scrim) { revealGradientEndColorAlpha = 1f - getPercentPastThreshold(amount, FADE_END_COLOR_OUT_THRESHOLD) setRevealGradientBounds( scrim.width * initialWidthMultiplier + -scrim.width * ovalWidthIncreaseAmount, scrim.height * OVAL_INITIAL_TOP_PERCENT - scrim.height * interpolatedAmount, scrim.width * (1f - initialWidthMultiplier) + scrim.width * ovalWidthIncreaseAmount, scrim.height * OVAL_INITIAL_BOTTOM_PERCENT + scrim.height * interpolatedAmount ) } } } class LinearLightRevealEffect(private val isVertical: Boolean) : LightRevealEffect { // Interpolator that reveals >80% of the content at 0.5 progress, makes revealing faster private val interpolator = PathInterpolator( /* controlX1= */ 0.4f, /* controlY1= */ 0f, /* controlX2= */ 0.2f, /* controlY2= */ 1f ) override fun setRevealAmountOnScrim(amount: Float, scrim: LightRevealScrim) { val interpolatedAmount = interpolator.getInterpolation(amount) scrim.interpolatedRevealAmount = interpolatedAmount scrim.startColorAlpha = getPercentPastThreshold( 1 - interpolatedAmount, threshold = 1 - START_COLOR_REVEAL_PERCENTAGE ) scrim.revealGradientEndColorAlpha = 1f - getPercentPastThreshold( interpolatedAmount, threshold = REVEAL_GRADIENT_END_COLOR_ALPHA_START_PERCENTAGE ) // Start changing gradient bounds later to avoid harsh gradient in the beginning val gradientBoundsAmount = lerp(GRADIENT_START_BOUNDS_PERCENTAGE, 1.0f, interpolatedAmount) if (isVertical) { scrim.setRevealGradientBounds( left = scrim.viewWidth / 2 - (scrim.viewWidth / 2) * gradientBoundsAmount, top = 0f, right = scrim.viewWidth / 2 + (scrim.viewWidth / 2) * gradientBoundsAmount, bottom = scrim.viewHeight.toFloat() ) } else { scrim.setRevealGradientBounds( left = 0f, top = scrim.viewHeight / 2 - (scrim.viewHeight / 2) * gradientBoundsAmount, right = scrim.viewWidth.toFloat(), bottom = scrim.viewHeight / 2 + (scrim.viewHeight / 2) * gradientBoundsAmount ) } } private companion object { // From which percentage we should start the gradient reveal width // E.g. if 0 - starts with 0px width, 0.3f - starts with 30% width private const val GRADIENT_START_BOUNDS_PERCENTAGE = 0.3f // When to start changing alpha color of the gradient scrim // E.g. if 0.6f - starts fading the gradient away at 60% and becomes completely // transparent at 100% private const val REVEAL_GRADIENT_END_COLOR_ALPHA_START_PERCENTAGE = 0.6f // When to finish displaying start color fill that reveals the content // E.g. if 0.3f - the content won't be visible at 0% and it will gradually // reduce the alpha until 30% (at this point the color fill is invisible) private const val START_COLOR_REVEAL_PERCENTAGE = 0.3f } } class CircleReveal( /** X-value of the circle center of the reveal. */ val centerX: Int, /** Y-value of the circle center of the reveal. */ val centerY: Int, /** Radius of initial state of circle reveal */ val startRadius: Int, /** Radius of end state of circle reveal */ val endRadius: Int ) : LightRevealEffect { override fun setRevealAmountOnScrim(amount: Float, scrim: LightRevealScrim) { // reveal amount updates already have an interpolator, so we intentionally use the // non-interpolated amount val fadeAmount = getPercentPastThreshold(amount, 0.5f) val radius = startRadius + ((endRadius - startRadius) * amount) scrim.interpolatedRevealAmount = amount scrim.revealGradientEndColorAlpha = 1f - fadeAmount scrim.setRevealGradientBounds( centerX - radius /* left */, centerY - radius /* top */, centerX + radius /* right */, centerY + radius /* bottom */ ) } } class PowerButtonReveal( /** Approximate Y-value of the center of the power button on the physical device. */ val powerButtonY: Float ) : LightRevealEffect { /** * How far off the side of the screen to start the power button reveal, in terms of percent of * the screen width. This ensures that the initial part of the animation (where the reveal is * just a sliver) starts just off screen. */ private val OFF_SCREEN_START_AMOUNT = 0.05f private val INCREASE_MULTIPLIER = 1.25f override fun setRevealAmountOnScrim(amount: Float, scrim: LightRevealScrim) { val interpolatedAmount = Interpolators.FAST_OUT_SLOW_IN_REVERSE.getInterpolation(amount) val fadeAmount = getPercentPastThreshold(interpolatedAmount, 0.5f) with(scrim) { revealGradientEndColorAlpha = 1f - fadeAmount interpolatedRevealAmount = interpolatedAmount @Rotation val rotation = RotationUtils.getRotation(scrim.getContext()) if (rotation == RotationUtils.ROTATION_NONE) { setRevealGradientBounds( width * (1f + OFF_SCREEN_START_AMOUNT) - width * INCREASE_MULTIPLIER * interpolatedAmount, powerButtonY - height * interpolatedAmount, width * (1f + OFF_SCREEN_START_AMOUNT) + width * INCREASE_MULTIPLIER * interpolatedAmount, powerButtonY + height * interpolatedAmount ) } else if (rotation == RotationUtils.ROTATION_LANDSCAPE) { setRevealGradientBounds( powerButtonY - width * interpolatedAmount, (-height * OFF_SCREEN_START_AMOUNT) - height * INCREASE_MULTIPLIER * interpolatedAmount, powerButtonY + width * interpolatedAmount, (-height * OFF_SCREEN_START_AMOUNT) + height * INCREASE_MULTIPLIER * interpolatedAmount ) } else { // RotationUtils.ROTATION_SEASCAPE setRevealGradientBounds( (width - powerButtonY) - width * interpolatedAmount, height * (1f + OFF_SCREEN_START_AMOUNT) - height * INCREASE_MULTIPLIER * interpolatedAmount, (width - powerButtonY) + width * interpolatedAmount, height * (1f + OFF_SCREEN_START_AMOUNT) + height * INCREASE_MULTIPLIER * interpolatedAmount ) } } } } /** * Scrim view that partially reveals the content underneath it using a [RadialGradient] with a * transparent center. The center position, size, and stops of the gradient can be manipulated to * reveal views below the scrim as if they are being 'lit up'. */ class LightRevealScrim @JvmOverloads constructor( context: Context?, attrs: AttributeSet?, initialWidth: Int? = null, initialHeight: Int? = null ) : View(context, attrs) { /** Listener that is called if the scrim's opaqueness changes */ lateinit var isScrimOpaqueChangedListener: Consumer /** * How much of the underlying views are revealed, in percent. 0 means they will be completely * obscured and 1 means they'll be fully visible. */ var revealAmount: Float = 1f set(value) { if (field != value) { field = value revealEffect.setRevealAmountOnScrim(value, this) updateScrimOpaque() Trace.traceCounter( Trace.TRACE_TAG_APP, "light_reveal_amount", (field * 100).toInt() ) invalidate() } } /** * The [LightRevealEffect] used to manipulate the radial gradient whenever [revealAmount] * changes. */ var revealEffect: LightRevealEffect = LiftReveal set(value) { if (field != value) { field = value revealEffect.setRevealAmountOnScrim(revealAmount, this) invalidate() } } var revealGradientCenter = PointF() var revealGradientWidth: Float = 0f var revealGradientHeight: Float = 0f /** * Keeps the initial value until the view is measured. See [LightRevealScrim.onMeasure]. * * Needed as the view dimensions are used before the onMeasure pass happens, and without preset * width and height some flicker during fold/unfold happens. */ internal var viewWidth: Int = initialWidth ?: 0 private set internal var viewHeight: Int = initialHeight ?: 0 private set /** * Alpha of the fill that can be used in the beginning of the animation to hide the content. * Normally the gradient bounds are animated from small size so the content is not visible, but * if the start gradient bounds allow to see some content this could be used to make the reveal * smoother. It can help to add fade in effect in the beginning of the animation. The color of * the fill is determined by [revealGradientEndColor]. * * 0 - no fill and content is visible, 1 - the content is covered with the start color */ var startColorAlpha = 0f set(value) { if (field != value) { field = value invalidate() } } var revealGradientEndColor: Int = Color.BLACK set(value) { if (field != value) { field = value setPaintColorFilter() } } var revealGradientEndColorAlpha = 0f set(value) { if (field != value) { field = value setPaintColorFilter() } } /** Is the scrim currently fully opaque */ var isScrimOpaque = false private set(value) { if (field != value) { field = value isScrimOpaqueChangedListener.accept(field) } } var interpolatedRevealAmount: Float = 1f val isScrimAlmostOccludes: Boolean get() { // if the interpolatedRevealAmount less than 0.1, over 90% of the screen is black. return interpolatedRevealAmount < 0.1f } private fun updateScrimOpaque() { isScrimOpaque = revealAmount == 0.0f && alpha == 1.0f && visibility == VISIBLE } override fun setAlpha(alpha: Float) { super.setAlpha(alpha) updateScrimOpaque() } override fun setVisibility(visibility: Int) { super.setVisibility(visibility) updateScrimOpaque() } /** * Paint used to draw a transparent-to-white radial gradient. This will be scaled and translated * via local matrix in [onDraw] so we never need to construct a new shader. */ private val gradientPaint = Paint().apply { shader = RadialGradient( 0f, 0f, 1f, intArrayOf(Color.TRANSPARENT, Color.WHITE), floatArrayOf(0f, 1f), Shader.TileMode.CLAMP ) // SRC_OVER ensures that we draw the semitransparent pixels over other views in the same // window, rather than outright replacing them. xfermode = PorterDuffXfermode(PorterDuff.Mode.SRC_OVER) } /** * Matrix applied to [gradientPaint]'s RadialGradient shader to move the gradient to * [revealGradientCenter] and set its size to [revealGradientWidth]/[revealGradientHeight], * without needing to construct a new shader each time those properties change. */ private val shaderGradientMatrix = Matrix() init { revealEffect.setRevealAmountOnScrim(revealAmount, this) setPaintColorFilter() invalidate() } override fun onMeasure(widthMeasureSpec: Int, heightMeasureSpec: Int) { super.onMeasure(widthMeasureSpec, heightMeasureSpec) viewWidth = measuredWidth viewHeight = measuredHeight } /** * Sets bounds for the transparent oval gradient that reveals the views below the scrim. This is * simply a helper method that sets [revealGradientCenter], [revealGradientWidth], and * [revealGradientHeight] for you. * * This method does not call [invalidate] * - you should do so once you're done changing properties. */ fun setRevealGradientBounds(left: Float, top: Float, right: Float, bottom: Float) { revealGradientWidth = right - left revealGradientHeight = bottom - top revealGradientCenter.x = left + (revealGradientWidth / 2f) revealGradientCenter.y = top + (revealGradientHeight / 2f) } override fun onDraw(canvas: Canvas?) { if ( canvas == null || revealGradientWidth <= 0 || revealGradientHeight <= 0 || revealAmount == 0f ) { if (revealAmount < 1f) { canvas?.drawColor(revealGradientEndColor) } return } if (startColorAlpha > 0f) { canvas.drawColor(getColorWithAlpha(revealGradientEndColor, startColorAlpha)) } with(shaderGradientMatrix) { setScale(revealGradientWidth, revealGradientHeight, 0f, 0f) postTranslate(revealGradientCenter.x, revealGradientCenter.y) gradientPaint.shader.setLocalMatrix(this) } // Draw the gradient over the screen, then multiply the end color by it. canvas.drawRect(0f, 0f, width.toFloat(), height.toFloat(), gradientPaint) } private fun setPaintColorFilter() { gradientPaint.colorFilter = PorterDuffColorFilter( getColorWithAlpha(revealGradientEndColor, revealGradientEndColorAlpha), PorterDuff.Mode.MULTIPLY ) } }