Class DiscreteInterpolator

  • All Implemented Interfaces:
    Interpolator

    public final class DiscreteInterpolator
    extends java.lang.Object
    implements Interpolator
    This class implements the Interpolator interface. It should be used in cases where a "discrete" animation is desired. A discrete animation is defined to be one where the values during an animation do not change smoothly between the boundary values, but suddenly, at the boundary points. For example, a discrete animation with KeyFrames where the KeyTimes are {0, .5, 1.0} and the KeyValues are (0, 1, 2} would, during the animation, retain the value of 0 until half-way through the animation and 1 through the rest of the animation.

    Because there is no variation to this class, it is a singleton and is referenced by using the getInstance() static method.

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      static DiscreteInterpolator getInstance()
      Returns the single DiscreteInterpolator object
      float interpolate​(float fraction)
      This method always returns 0 for inputs less than 1, which will force users of this interpolation to assign a value equal to the value at the beginning of this timing interval, which is the desired behavior for discrete animations.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • getInstance

        public static DiscreteInterpolator getInstance()
        Returns the single DiscreteInterpolator object
      • interpolate

        public float interpolate​(float fraction)
        This method always returns 0 for inputs less than 1, which will force users of this interpolation to assign a value equal to the value at the beginning of this timing interval, which is the desired behavior for discrete animations. An input of 1 will return 1, since this means the end of the current interval (and start to the next interval).
        Specified by:
        interpolate in interface Interpolator
        Parameters:
        fraction - a value between 0 and 1, representing the elapsed fraction of a time interval (either an entire animation cycle or an interval between two KeyTimes, depending on where this Interpolator has been set)
        Returns:
        number representing the start of the current interval, usually 0, but if fracton == 0, returns 1.