com.simsilica.lemur.anim

Class Tweens

java.lang.Object

com.simsilica.lemur.anim.Tweens

public class Tweens
extends java.lang.Object

Static utility methods for creating common generic Tween objects.

Constructor Summary

Constructors

Constructor and Description
Tweens()

Method Summary

Modifier and Type	Method and Description
static Tween	callMethod(java.lang.Object target, java.lang.String method, java.lang.Object... args) Creates a Tween that will call the specified method and optional arguments whenever supplied a time value greater than or equal to 0.
static Tween	callTweenMethod(double length, java.lang.Object target, java.lang.String method, java.lang.Object... args) Creates a Tween that will call the specified method and optional arguments, including the time value scaled between 0 and 1.
static Tween	delay(double length) Creates a tween that will perform a no-op until the length has expired.
static Tween	parallel(Tween... delegates) Creates a tween that will interpolate over an entire list of tweens in parallel, ie: all tweens will be run at the same time.
static Tween	sequence(Tween... delegates) Creates a tween that will interpolate over an entire sequence of tweens in order.
static Tween	sineStep(Tween... delegates) Creates a tween that uses a sine function to smooth step the time value for the specified delegate tween or tweens.
static Tween	smoothStep(Tween... delegates) Creates a tween that uses a hermite function to smooth step the time value for the specified delegate tween or tweens.
static Tween	stretch(double desiredLength, Tween... delegates) Creates a tween that scales the specified delegate tween or tweens to the desired length.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Tweens

public Tweens()

Method Detail

sequence

public static Tween sequence(Tween... delegates)

Creates a tween that will interpolate over an entire sequence of tweens in order.

parallel

public static Tween parallel(Tween... delegates)

Creates a tween that will interpolate over an entire list of tweens in parallel, ie: all tweens will be run at the same time.

delay

public static Tween delay(double length)

Creates a tween that will perform a no-op until the length has expired.

stretch

public static Tween stretch(double desiredLength,
                            Tween... delegates)

Creates a tween that scales the specified delegate tween or tweens to the desired length. If more than one tween is specified then they are wrapped in a sequence using the sequence() method.

sineStep

public static Tween sineStep(Tween... delegates)

Creates a tween that uses a sine function to smooth step the time value for the specified delegate tween or tweens. These 'curved' wrappers can be used to smooth the interpolation of another tween.

smoothStep

public static Tween smoothStep(Tween... delegates)

Creates a tween that uses a hermite function to smooth step the time value for the specified delegate tween or tweens. This is similar to GLSL's smoothstep(). These 'curved' wrappers can be used to smooth the interpolation of another tween.

callMethod

public static Tween callMethod(java.lang.Object target,
                               java.lang.String method,
                               java.lang.Object... args)

Creates a Tween that will call the specified method and optional arguments whenever supplied a time value greater than or equal to 0. This creates an "instant" tween of length 0.

callTweenMethod

public static Tween callTweenMethod(double length,
                                    java.lang.Object target,
                                    java.lang.String method,
                                    java.lang.Object... args)

Creates a Tween that will call the specified method and optional arguments, including the time value scaled between 0 and 1. The method must take a float or double value as its first or last argument, in addition to whatever optional arguments are specified.

For example:

Tweens.callTweenMethod(1, myObject, "foo", "bar")

Would work for any of the following method signatures:

    void foo( float t, String arg )
    void foo( double t, String arg )
    void foo( String arg, float t )
    void foo( String arg, double t )