com.threerings.media.util

Class TimeFunction

java.lang.Object

com.threerings.media.util.TimeFunction

Direct Known Subclasses:

LinearTimeFunction

public abstract class TimeFunction
extends Object

Used to vary a value over time where time is provided at discrete increments (on the frame tick) and the value is computed appropriately.

Constructor Summary

Constructors

Constructor and Description
TimeFunction(int start, int end, int duration) Every time function varies a value from some starting value to some ending value over some duration.

Method Summary

Modifier and Type	Method and Description
void	fastForward(long timeDelta) Called to fast forward our time stamps if we are ever paused and need to resume where we left off.
int	getValue(long tickStamp) Returns the current value given the supplied time stamp.
void	init(long tickStamp) Configures this function with a starting time.

Methods inherited from class java.lang.Object

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

Constructor Detail

TimeFunction

public TimeFunction(int start,
                    int end,
                    int duration)

Every time function varies a value from some starting value to some ending value over some duration. The way in which it varies (linearly, for example) is up to the derived class.

Note: it is assumed that we will operate with relatively short durations such that integer arithmetic may be used rather than long arithmetic.

Method Detail

init

public void init(long tickStamp)

Configures this function with a starting time. This method need not be called, and instead the first vall to getValue(long) will be used to obtain a starting time stamp.

fastForward

public void fastForward(long timeDelta)

Called to fast forward our time stamps if we are ever paused and need to resume where we left off.

getValue

public int getValue(long tickStamp)

Returns the current value given the supplied time stamp. The value will be bounded to the originally supplied starting and ending values at times 0 (and below) and _duration (and above) respectively.