TargetBasedAnimation

public class TargetBasedAnimation<T, V : AnimationVector> internal constructor(
    internal val animationSpec: VectorizedAnimationSpec<V>,
    override val typeConverter: TwoWayConverter<T, V>,
    initialValue: T,
    targetValue: T,
    initialVelocityVector: V? = null,
) : Animation<T, V>

This is a convenient animation wrapper class that works for all target based animations, i.e. animations that has a pre-defined end value, unlike decay.

It assumes that the starting value and velocity, as well as ending value do not change throughout the animation, and cache these values. This caching enables much more convenient query for animation value and velocity (where only playtime needs to be passed into the methods).

Note: When interruptions happen to the TargetBasedAnimation, a new instance should be created that use the current value and velocity as the starting conditions. This type of interruption handling is the default behavior for both Animatable and Transition. Consider using those APIs for the interruption handling, as well as built-in animation lifecycle management.

Parameters

Properties

initialValue

public val initialValue: T

targetValue

override val targetValue: T

isInfinite

override val isInfinite: Boolean

durationNanos

override val durationNanos: Long

Functions

getValueFromNanos

override fun getValueFromNanos(playTimeNanos: Long): T

getVelocityVectorFromNanos

override fun getVelocityVectorFromNanos(playTimeNanos: Long): V

toString

override fun toString(): String