Animation

java.lang.Object
- javafx.animation.Animation

Direct Known Subclasses:

Timeline, Transition
```
public abstract class Animation
extends java.lang.Object
```
The class Animation provides the core functionality of all animations used in the JavaFX runtime.
An animation can run in a loop by setting cycleCount. To make an animation run back and forth while looping, set the autoReverse -flag.
Call play() or playFromStart() to play an Animation . The Animation progresses in the direction and speed specified by rate, and stops when its duration is elapsed. An Animation with indefinite duration (a cycleCount of INDEFINITE) runs repeatedly until the stop() method is explicitly called, which will stop the running Animation and reset its play head to the initial position.
An Animation can be paused by calling pause(), and the next play() call will resume the Animation from where it was paused.
An Animation's play head can be randomly positioned, whether it is running or not. If the Animation is running, the play head jumps to the specified position immediately and continues playing from new position. If the Animation is not running, the next play() will start the Animation from the specified position.
Inverting the value of rate toggles the play direction.

Since:

JavaFX 2.0

See Also:

Timeline, Transition

Property Summary

All Methods Instance Methods Concrete Methods
Type	Property and Description
`BooleanProperty`	`autoReverse` Defines whether this `Animation` reverses direction on alternating cycles.
`ReadOnlyDoubleProperty`	`currentRate` Read-only variable to indicate current direction/speed at which the `Animation` is being played.
`<any>`	`currentTime` Defines the `Animation`'s play head position.
`IntegerProperty`	`cycleCount` Defines the number of cycles in this animation.
`<any>`	`cycleDuration` Read-only variable to indicate the duration of one cycle of this `Animation`: the time it takes to play from time 0 to the end of the Animation (at the default `rate` of 1.0).
`<any>`	`delay` Delays the start of an animation.
`<any>`	`onFinished` The action to be executed at the conclusion of this `Animation`.
`DoubleProperty`	`rate` Defines the direction/speed at which the `Animation` is expected to be played.
`<any>`	`status` The status of the `Animation`.
`<any>`	`totalDuration` Read-only variable to indicate the total duration of this `Animation`, including repeats.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`private class`	`Animation.AnimationReadOnlyProperty<T>`
`private class`	`Animation.CurrentRateProperty`
`private class`	`Animation.CurrentTimeProperty`
`static class`	`Animation.Status` The possible states for `status`.

Field Summary

Fields
Modifier and Type	Field and Description
`private java.security.AccessControlContext`	`accessCtrlCtx`
`private BooleanProperty`	`autoReverse` Defines whether this `Animation` reverses direction on alternating cycles.
`(package private) ClipEnvelope`	`clipEnvelope`
`private <any>`	`cuePoints`
`private ReadOnlyDoubleProperty`	`currentRate` Read-only variable to indicate current direction/speed at which the `Animation` is being played.
`private long`	`currentTicks`
`private Animation.CurrentTimeProperty`	`currentTime` Defines the `Animation`'s play head position.
`private IntegerProperty`	`cycleCount` Defines the number of cycles in this animation.
`private <any>`	`cycleDuration` Read-only variable to indicate the duration of one cycle of this `Animation`: the time it takes to play from time 0 to the end of the Animation (at the default `rate` of 1.0).
`private static boolean`	`DEFAULT_AUTO_REVERSE`
`private static double`	`DEFAULT_CURRENT_RATE`
`private static int`	`DEFAULT_CYCLE_COUNT`
`private static Duration`	`DEFAULT_CYCLE_DURATION`
`private static Duration`	`DEFAULT_DELAY`
`private static <any>`	`DEFAULT_ON_FINISHED`
`private static double`	`DEFAULT_RATE`
`private static Animation.Status`	`DEFAULT_STATUS`
`private static Duration`	`DEFAULT_TOTAL_DURATION`
`private <any>`	`delay` Delays the start of an animation.
`private static double`	`EPSILON`
`static int`	`INDEFINITE` Used to specify an animation that repeats indefinitely, until the `stop()` method is called.
`private boolean`	`lastPlayedFinished`
`private boolean`	`lastPlayedForward`
`private long`	`lastPulse`
`private double`	`oldRate`
`private <any>`	`onFinished` The action to be executed at the conclusion of this `Animation`.
`(package private) Animation`	`parent` The parent of this `Animation`.
`private boolean`	`paused`
`private long`	`pauseTime`
`(package private) PulseReceiver`	`pulseReceiver`
`private DoubleProperty`	`rate` Defines the direction/speed at which the `Animation` is expected to be played.
`private int`	`resolution`
`private long`	`startTime`
`private <any>`	`status` The status of the `Animation`.
`private double`	`targetFramerate`
`private AbstractMasterTimer`	`timer`
`private <any>`	`totalDuration` Read-only variable to indicate the total duration of this `Animation`, including repeats.

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`Animation()` The constructor of `Animation`.
`(package private)`	`Animation(AbstractMasterTimer timer)`
`(package private)`	`Animation(AbstractMasterTimer timer, ClipEnvelope clipEnvelope, int resolution)`
`protected`	`Animation(double targetFramerate)` The constructor of `Animation`.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`private void`	`addPulseReceiver()`
`BooleanProperty`	`autoReverseProperty()` Defines whether this `Animation` reverses direction on alternating cycles.
`ReadOnlyDoubleProperty`	`currentRateProperty()` Read-only variable to indicate current direction/speed at which the `Animation` is being played.
`<any>`	`currentTimeProperty()` Defines the `Animation`'s play head position.
`IntegerProperty`	`cycleCountProperty()` Defines the number of cycles in this animation.
`<any>`	`cycleDurationProperty()` Read-only variable to indicate the duration of one cycle of this `Animation`: the time it takes to play from time 0 to the end of the Animation (at the default `rate` of 1.0).
`<any>`	`delayProperty()` Delays the start of an animation.
`(package private) abstract void`	`doJumpTo(long currentTicks, long cycleTicks, boolean forceJump)`
`(package private) void`	`doPause()`
`(package private) abstract void`	`doPlayTo(long currentTicks, long cycleTicks)`
`(package private) void`	`doResume()`
`private void`	`doSetCurrentRate(double value)`
`(package private) void`	`doStart(boolean forceSync)`
`(package private) void`	`doStop()`
`(package private) void`	`doTimePulse(long elapsedTime)`
`(package private) void`	`finished()`
`<any>`	`getCuePoints()` The cue points can be used to mark important positions of the `Animation`.
`double`	`getCurrentRate()` Gets the value of the property currentRate.
`Duration`	`getCurrentTime()` Gets the value of the property currentTime.
`int`	`getCycleCount()` Gets the value of the property cycleCount.
`Duration`	`getCycleDuration()` Gets the value of the property cycleDuration.
`Duration`	`getDelay()` Gets the value of the property delay.
`<any>`	`getOnFinished()` Gets the value of the property onFinished.
`double`	`getRate()` Gets the value of the property rate.
`Animation.Status`	`getStatus()` Gets the value of the property status.
`double`	`getTargetFramerate()` The target framerate is the maximum framerate at which this `Animation` will run, in frames per second.
`Duration`	`getTotalDuration()` Gets the value of the property totalDuration.
`boolean`	`isAutoReverse()` Gets the value of the property autoReverse.
`private boolean`	`isRunningEmbedded()`
`void`	`jumpTo(Duration time)` Jumps to a given position in this `Animation`.
`private long`	`now()`
`<any>`	`onFinishedProperty()` The action to be executed at the conclusion of this `Animation`.
`void`	`pause()` Pauses the animation.
`(package private) void`	`pauseReceiver()`
`void`	`play()` Plays `Animation` from current position in the direction indicated by `rate`.
`void`	`playFrom(Duration time)` A convenience method to play this `Animation` from a specific position.
`void`	`playFrom(java.lang.String cuePoint)` A convenience method to play this `Animation` from a predefined position.
`void`	`playFromStart()` Plays an `Animation` from initial position in forward direction.
`DoubleProperty`	`rateProperty()` Defines the direction/speed at which the `Animation` is expected to be played.
`(package private) void`	`resumeReceiver()`
`void`	`setAutoReverse(boolean value)` Sets the value of the property autoReverse.
`(package private) void`	`setCurrentRate(double currentRate)`
`(package private) void`	`setCurrentTicks(long ticks)`
`void`	`setCycleCount(int value)` Sets the value of the property cycleCount.
`protected void`	`setCycleDuration(Duration value)` Sets the value of the property cycleDuration.
`void`	`setDelay(Duration value)` Sets the value of the property delay.
`void`	`setOnFinished(<any> value)` Sets the value of the property onFinished.
`void`	`setRate(double value)` Sets the value of the property rate.
`protected void`	`setStatus(Animation.Status value)` Sets the value of the property status.
`(package private) boolean`	`startable(boolean forceSync)`
`(package private) void`	`startReceiver(long delay)`
`<any>`	`statusProperty()` The status of the `Animation`.
`void`	`stop()` Stops the animation and resets the play head to its initial position.
`(package private) void`	`sync(boolean forceSync)`
`private void`	`syncClipEnvelope()`
`<any>`	`totalDurationProperty()` Read-only variable to indicate the total duration of this `Animation`, including repeats.
`private void`	`updateTotalDuration()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Property Detail
  - rate
```
public final DoubleProperty rateProperty
```
    Defines the direction/speed at which the Animation is expected to be played.
    The absolute value of rate indicates the speed at which the Animation is to be played, while the sign of rate indicates the direction. A positive value of rate indicates forward play, a negative value indicates backward play and 0.0 to stop a running Animation.
    Rate 1.0 is normal play, 2.0 is 2 time normal, -1.0 is backwards, etc.
    Inverting the rate of a running Animation will cause the Animation to reverse direction in place and play back over the portion of the Animation that has already elapsed.
    
    See Also:
    
    getRate(), setRate(double)
  - currentRate
```
public final ReadOnlyDoubleProperty currentRateProperty
```
    Read-only variable to indicate current direction/speed at which the Animation is being played.
    currentRate is not necessary equal to rate. currentRate is set to 0.0 when animation is paused or stopped. currentRate may also point to different direction during reverse cycles when autoReverse is true
    
    See Also:
    
    getCurrentRate()
  - cycleDuration
```
public final <any> cycleDurationProperty
```
    Read-only variable to indicate the duration of one cycle of this Animation: the time it takes to play from time 0 to the end of the Animation (at the default rate of 1.0).
    
    See Also:
    
    getCycleDuration(), setCycleDuration(Duration)
  - totalDuration
```
public final <any> totalDurationProperty
```
    Read-only variable to indicate the total duration of this Animation, including repeats. A Animation with a cycleCount of Animation.INDEFINITE will have a totalDuration of Duration.INDEFINITE.
    This is set to cycleDuration * cycleCount.
    
    See Also:
    
    getTotalDuration()
  - currentTime
```
public final <any> currentTimeProperty
```
    Defines the Animation's play head position.
    
    See Also:
    
    getCurrentTime()
  - delay
```
public final <any> delayProperty
```
    Delays the start of an animation. Cannot be negative. Setting to a negative number will result in IllegalArgumentException.
    
    See Also:
    
    getDelay(), setDelay(Duration)
  - cycleCount
```
public final IntegerProperty cycleCountProperty
```
    Defines the number of cycles in this animation. The cycleCount may be INDEFINITE for animations that repeat indefinitely, but must otherwise be > 0.
    It is not possible to change the cycleCount of a running Animation. If the value of cycleCount is changed for a running Animation, the animation has to be stopped and started again to pick up the new value.
    
    See Also:
    
    getCycleCount(), setCycleCount(int)
  - autoReverse
```
public final BooleanProperty autoReverseProperty
```
    Defines whether this Animation reverses direction on alternating cycles. If true, the Animation will proceed forward on the first cycle, then reverses on the second cycle, and so on. Otherwise, animation will loop such that each cycle proceeds forward from the start. It is not possible to change the autoReverse flag of a running Animation. If the value of autoReverse is changed for a running Animation, the animation has to be stopped and started again to pick up the new value.
    
    See Also:
    
    isAutoReverse(), setAutoReverse(boolean)
  - status
```
public final <any> statusProperty
```
    The status of the Animation. In Animation can be in one of three states: Animation.Status.STOPPED, Animation.Status.PAUSED or Animation.Status.RUNNING.
    
    See Also:
    
    getStatus(), setStatus(Status)
  - onFinished
```
public final <any> onFinishedProperty
```
    The action to be executed at the conclusion of this Animation.
    
    See Also:
    
    getOnFinished(), #setOnFinished()
- Field Detail
  - INDEFINITE
```
public static final int INDEFINITE
```
    Used to specify an animation that repeats indefinitely, until the stop() method is called.
    
    See Also:
    
    Constant Field Values
  - EPSILON
```
private static final double EPSILON
```
    See Also:
    
    Constant Field Values
  - startTime
```
private long startTime
```
  - pauseTime
```
private long pauseTime
```
  - paused
```
private boolean paused
```
  - timer
```
private final AbstractMasterTimer timer
```
  - accessCtrlCtx
```
private java.security.AccessControlContext accessCtrlCtx
```
  - pulseReceiver
```
final PulseReceiver pulseReceiver
```
  - parent
```
Animation parent
```
    The parent of this Animation. If this animation has not been added to another animation, such as ParallelTransition and SequentialTransition, then parent will be null.
  - clipEnvelope
```
ClipEnvelope clipEnvelope
```
  - lastPlayedFinished
```
private boolean lastPlayedFinished
```
  - lastPlayedForward
```
private boolean lastPlayedForward
```
  - rate
```
private DoubleProperty rate
```
    Defines the direction/speed at which the Animation is expected to be played.
    The absolute value of rate indicates the speed at which the Animation is to be played, while the sign of rate indicates the direction. A positive value of rate indicates forward play, a negative value indicates backward play and 0.0 to stop a running Animation.
    Rate 1.0 is normal play, 2.0 is 2 time normal, -1.0 is backwards, etc.
    Inverting the rate of a running Animation will cause the Animation to reverse direction in place and play back over the portion of the Animation that has already elapsed.
  - DEFAULT_RATE
```
private static final double DEFAULT_RATE
```
    See Also:
    
    Constant Field Values
  - oldRate
```
private double oldRate
```
  - currentRate
```
private ReadOnlyDoubleProperty currentRate
```
    Read-only variable to indicate current direction/speed at which the Animation is being played.
    currentRate is not necessary equal to rate. currentRate is set to 0.0 when animation is paused or stopped. currentRate may also point to different direction during reverse cycles when autoReverse is true
  - DEFAULT_CURRENT_RATE
```
private static final double DEFAULT_CURRENT_RATE
```
    See Also:
    
    Constant Field Values
  - cycleDuration
```
private <any> cycleDuration
```
    Read-only variable to indicate the duration of one cycle of this Animation: the time it takes to play from time 0 to the end of the Animation (at the default rate of 1.0).
  - DEFAULT_CYCLE_DURATION
```
private static final Duration DEFAULT_CYCLE_DURATION
```
  - totalDuration
```
private <any> totalDuration
```
    Read-only variable to indicate the total duration of this Animation, including repeats. A Animation with a cycleCount of Animation.INDEFINITE will have a totalDuration of Duration.INDEFINITE.
    This is set to cycleDuration * cycleCount.
  - DEFAULT_TOTAL_DURATION
```
private static final Duration DEFAULT_TOTAL_DURATION
```
  - currentTime
```
private Animation.CurrentTimeProperty currentTime
```
    Defines the Animation's play head position.
  - currentTicks
```
private long currentTicks
```
  - delay
```
private <any> delay
```
    Delays the start of an animation. Cannot be negative. Setting to a negative number will result in IllegalArgumentException.
  - DEFAULT_DELAY
```
private static final Duration DEFAULT_DELAY
```
  - cycleCount
```
private IntegerProperty cycleCount
```
    Defines the number of cycles in this animation. The cycleCount may be INDEFINITE for animations that repeat indefinitely, but must otherwise be > 0.
    It is not possible to change the cycleCount of a running Animation. If the value of cycleCount is changed for a running Animation, the animation has to be stopped and started again to pick up the new value.
  - DEFAULT_CYCLE_COUNT
```
private static final int DEFAULT_CYCLE_COUNT
```
    See Also:
    
    Constant Field Values
  - autoReverse
```
private BooleanProperty autoReverse
```
    Defines whether this Animation reverses direction on alternating cycles. If true, the Animation will proceed forward on the first cycle, then reverses on the second cycle, and so on. Otherwise, animation will loop such that each cycle proceeds forward from the start. It is not possible to change the autoReverse flag of a running Animation. If the value of autoReverse is changed for a running Animation, the animation has to be stopped and started again to pick up the new value.
  - DEFAULT_AUTO_REVERSE
```
private static final boolean DEFAULT_AUTO_REVERSE
```
    See Also:
    
    Constant Field Values
  - status
```
private <any> status
```
    The status of the Animation. In Animation can be in one of three states: Animation.Status.STOPPED, Animation.Status.PAUSED or Animation.Status.RUNNING.
  - DEFAULT_STATUS
```
private static final Animation.Status DEFAULT_STATUS
```
  - targetFramerate
```
private final double targetFramerate
```
  - resolution
```
private final int resolution
```
  - lastPulse
```
private long lastPulse
```
  - onFinished
```
private <any> onFinished
```
    The action to be executed at the conclusion of this Animation.
  - DEFAULT_ON_FINISHED
```
private static final <any> DEFAULT_ON_FINISHED
```
  - cuePoints
```
private final <any> cuePoints
```
- Constructor Detail
  - Animation
```
protected Animation(double targetFramerate)
```
    The constructor of Animation. This constructor allows to define a target framerate.
    
    Parameters:
    
    targetFramerate - The custom target frame rate for this Animation
    
    See Also:
    
    getTargetFramerate()
  - Animation
```
protected Animation()
```
    The constructor of Animation.
  - Animation
```
Animation(AbstractMasterTimer timer)
```
  - Animation
```
Animation(AbstractMasterTimer timer,
          ClipEnvelope clipEnvelope,
          int resolution)
```
- Method Detail
  - now
```
private long now()
```
  - addPulseReceiver
```
private void addPulseReceiver()
```
  - startReceiver
```
void startReceiver(long delay)
```
  - pauseReceiver
```
void pauseReceiver()
```
  - resumeReceiver
```
void resumeReceiver()
```
  - setRate
```
public final void setRate(double value)
```
    Sets the value of the property rate.
  - getRate
```
public final double getRate()
```
    Gets the value of the property rate.
  - rateProperty
```
public final DoubleProperty rateProperty()
```
    Defines the direction/speed at which the Animation is expected to be played.
    The absolute value of rate indicates the speed at which the Animation is to be played, while the sign of rate indicates the direction. A positive value of rate indicates forward play, a negative value indicates backward play and 0.0 to stop a running Animation.
    Rate 1.0 is normal play, 2.0 is 2 time normal, -1.0 is backwards, etc.
    Inverting the rate of a running Animation will cause the Animation to reverse direction in place and play back over the portion of the Animation that has already elapsed.
    
    See Also:
    
    getRate(), setRate(double)
  - isRunningEmbedded
```
private boolean isRunningEmbedded()
```
  - doSetCurrentRate
```
private void doSetCurrentRate(double value)
```
  - getCurrentRate
```
public final double getCurrentRate()
```
    Gets the value of the property currentRate.
  - currentRateProperty
```
public final ReadOnlyDoubleProperty currentRateProperty()
```
    Read-only variable to indicate current direction/speed at which the Animation is being played.
    currentRate is not necessary equal to rate. currentRate is set to 0.0 when animation is paused or stopped. currentRate may also point to different direction during reverse cycles when autoReverse is true
    
    See Also:
    
    getCurrentRate()
  - setCycleDuration
```
protected final void setCycleDuration(Duration value)
```
    Sets the value of the property cycleDuration.
  - getCycleDuration
```
public final Duration getCycleDuration()
```
    Gets the value of the property cycleDuration.
  - cycleDurationProperty
```
public final <any> cycleDurationProperty()
```
    Read-only variable to indicate the duration of one cycle of this Animation: the time it takes to play from time 0 to the end of the Animation (at the default rate of 1.0).
    
    See Also:
    
    getCycleDuration(), setCycleDuration(Duration)
  - getTotalDuration
```
public final Duration getTotalDuration()
```
    Gets the value of the property totalDuration.
  - totalDurationProperty
```
public final <any> totalDurationProperty()
```
    Read-only variable to indicate the total duration of this Animation, including repeats. A Animation with a cycleCount of Animation.INDEFINITE will have a totalDuration of Duration.INDEFINITE.
    This is set to cycleDuration * cycleCount.
    
    See Also:
    
    getTotalDuration()
  - updateTotalDuration
```
private void updateTotalDuration()
```
  - getCurrentTime
```
public final Duration getCurrentTime()
```
    Gets the value of the property currentTime.
  - currentTimeProperty
```
public final <any> currentTimeProperty()
```
    Defines the Animation's play head position.
    
    See Also:
    
    getCurrentTime()
  - setDelay
```
public final void setDelay(Duration value)
```
    Sets the value of the property delay.
  - getDelay
```
public final Duration getDelay()
```
    Gets the value of the property delay.
  - delayProperty
```
public final <any> delayProperty()
```
    Delays the start of an animation. Cannot be negative. Setting to a negative number will result in IllegalArgumentException.
    
    See Also:
    
    getDelay(), setDelay(Duration)
  - setCycleCount
```
public final void setCycleCount(int value)
```
    Sets the value of the property cycleCount.
  - getCycleCount
```
public final int getCycleCount()
```
    Gets the value of the property cycleCount.
  - cycleCountProperty
```
public final IntegerProperty cycleCountProperty()
```
    Defines the number of cycles in this animation. The cycleCount may be INDEFINITE for animations that repeat indefinitely, but must otherwise be > 0.
    It is not possible to change the cycleCount of a running Animation. If the value of cycleCount is changed for a running Animation, the animation has to be stopped and started again to pick up the new value.
    
    See Also:
    
    getCycleCount(), setCycleCount(int)
  - setAutoReverse
```
public final void setAutoReverse(boolean value)
```
    Sets the value of the property autoReverse.
  - isAutoReverse
```
public final boolean isAutoReverse()
```
    Gets the value of the property autoReverse.
  - autoReverseProperty
```
public final BooleanProperty autoReverseProperty()
```
    Defines whether this Animation reverses direction on alternating cycles. If true, the Animation will proceed forward on the first cycle, then reverses on the second cycle, and so on. Otherwise, animation will loop such that each cycle proceeds forward from the start. It is not possible to change the autoReverse flag of a running Animation. If the value of autoReverse is changed for a running Animation, the animation has to be stopped and started again to pick up the new value.
    
    See Also:
    
    isAutoReverse(), setAutoReverse(boolean)
  - setStatus
```
protected final void setStatus(Animation.Status value)
```
    Sets the value of the property status.
  - getStatus
```
public final Animation.Status getStatus()
```
    Gets the value of the property status.
  - statusProperty
```
public final <any> statusProperty()
```
    The status of the Animation. In Animation can be in one of three states: Animation.Status.STOPPED, Animation.Status.PAUSED or Animation.Status.RUNNING.
    
    See Also:
    
    getStatus(), setStatus(Status)
  - getTargetFramerate
```
public final double getTargetFramerate()
```
    The target framerate is the maximum framerate at which this Animation will run, in frames per second. This can be used, for example, to keep particularly complex Animations from over-consuming system resources. By default, an Animation's framerate is not explicitly limited, meaning the Animation will run at an optimal framerate for the underlying platform.
    
    Returns:
    
    the target framerate
  - setOnFinished
```
public final void setOnFinished(<any> value)
```
    Sets the value of the property onFinished.
  - getOnFinished
```
public final <any> getOnFinished()
```
    Gets the value of the property onFinished.
  - onFinishedProperty
```
public final <any> onFinishedProperty()
```
    The action to be executed at the conclusion of this Animation.
    
    See Also:
    
    getOnFinished(), #setOnFinished()
  - getCuePoints
```
public final <any> getCuePoints()
```
    The cue points can be used to mark important positions of the Animation. Once a cue point was defined, it can be used as an argument of jumpTo() and playFrom() to move to the associated position quickly.
    Every Animation has two predefined cue points "start" and "end", which are set at the start respectively the end of the Animation. The predefined cuepoints do not appear in the map, attempts to override them have no effect.
    Another option to define a cue point in a Animation is to set the name property of a KeyFrame.
    
    Returns:
    
    javafx.collections.ObservableMap of cue points
  - jumpTo
```
public void jumpTo(Duration time)
```
    Jumps to a given position in this Animation. If the given time is less than Duration#ZERO, this method will jump to the start of the animation. If the given time is larger than the duration of this Animation, this method will jump to the end.
    
    Parameters:
    
    time - the new position
    
    Throws:
    
    java.lang.NullPointerException - if time is null
    
    java.lang.IllegalArgumentException - if time is Duration#UNKNOWN
    
    java.lang.IllegalStateException - if embedded in another animation, such as SequentialTransition or ParallelTransition
  - playFrom
```
public void playFrom(java.lang.String cuePoint)
```
    A convenience method to play this Animation from a predefined position. The position has to be predefined in cue points. Calling this method is equivalent to
```
 
 animation.jumpTo(cuePoint);
 animation.play();
 
 
```
    Note that unlike playFromStart() calling this method will not change the playing direction of this Animation.
    Parameters:
    
    cuePoint - name of the cue point
    
    Throws:
    
    java.lang.NullPointerException - if cuePoint is null
    
    java.lang.IllegalStateException - if embedded in another animation, such as SequentialTransition or ParallelTransition
    
    See Also:
    
    getCuePoints()
  - playFrom
```
public void playFrom(Duration time)
```
    A convenience method to play this Animation from a specific position. Calling this method is equivalent to
```
 
 animation.jumpTo(time);
 animation.play();
 
 
```
    Note that unlike playFromStart() calling this method will not change the playing direction of this Animation.
    Parameters:
    
    time - position where to play from
    
    Throws:
    
    java.lang.NullPointerException - if time is null
    
    java.lang.IllegalArgumentException - if time is Duration#UNKNOWN
    
    java.lang.IllegalStateException - if embedded in another animation, such as SequentialTransition or ParallelTransition
  - play
```
public void play()
```
    Plays Animation from current position in the direction indicated by rate. If the Animation is running, it has no effect.
    When rate > 0 (forward play), if an Animation is already positioned at the end, the first cycle will not be played, it is considered to have already finished. This also applies to a backward ( rate < 0) cycle if an Animation is positioned at the beginning. However, if the Animation has cycleCount > 1, following cycle(s) will be played as usual.
    When the Animation reaches the end, the Animation is stopped and the play head remains at the end.
    To play an Animation backwards from the end:
    animation.setRate(negative rate); animation.jumpTo(overall duration of animation); animation.play();
    Note:
    - play() is an asynchronous call, the Animation may not start immediately.
    Throws:
    
    java.lang.IllegalStateException - if embedded in another animation, such as SequentialTransition or ParallelTransition
  - playFromStart
```
public void playFromStart()
```
    Plays an Animation from initial position in forward direction.
    It is equivalent to
    animation.stop(); animation.setRate = setRate(Math.abs(animation.getRate())); animation.jumpTo(Duration.ZERO); animation.play();
    Note:
    - playFromStart() is an asynchronous call, Animation may not start immediately.
    Throws:
    
    java.lang.IllegalStateException - if embedded in another animation, such as SequentialTransition or ParallelTransition
  - stop
```
public void stop()
```
    Stops the animation and resets the play head to its initial position. If the animation is not currently running, this method has no effect.
    Note:
    - stop() is an asynchronous call, the Animation may not stop immediately.
    Throws:
    
    java.lang.IllegalStateException - if embedded in another animation, such as SequentialTransition or ParallelTransition
  - pause
```
public void pause()
```
    Pauses the animation. If the animation is not currently running, this method has no effect.
    Note:
    - pause() is an asynchronous call, the Animation may not pause immediately.
    Throws:
    
    java.lang.IllegalStateException - if embedded in another animation, such as SequentialTransition or ParallelTransition
  - startable
```
boolean startable(boolean forceSync)
```
  - sync
```
void sync(boolean forceSync)
```
  - syncClipEnvelope
```
private void syncClipEnvelope()
```
  - doStart
```
void doStart(boolean forceSync)
```
  - doPause
```
void doPause()
```
  - doResume
```
void doResume()
```
  - doStop
```
void doStop()
```
  - doTimePulse
```
void doTimePulse(long elapsedTime)
```
  - doPlayTo
```
abstract void doPlayTo(long currentTicks,
                       long cycleTicks)
```
  - doJumpTo
```
abstract void doJumpTo(long currentTicks,
                       long cycleTicks,
                       boolean forceJump)
```
  - setCurrentTicks
```
void setCurrentTicks(long ticks)
```
  - setCurrentRate
```
void setCurrentRate(double currentRate)
```
  - finished
```
final void finished()
```

Class Animation

Property Summary

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Property Detail

rate

currentRate

cycleDuration

totalDuration

currentTime

delay

cycleCount

autoReverse

status

onFinished

Field Detail

INDEFINITE

EPSILON

startTime

pauseTime

paused

timer

accessCtrlCtx

pulseReceiver

parent

clipEnvelope

lastPlayedFinished

lastPlayedForward

rate

DEFAULT_RATE

oldRate

currentRate

DEFAULT_CURRENT_RATE

cycleDuration

DEFAULT_CYCLE_DURATION

totalDuration

DEFAULT_TOTAL_DURATION

currentTime

currentTicks

delay

DEFAULT_DELAY

cycleCount

DEFAULT_CYCLE_COUNT

autoReverse

DEFAULT_AUTO_REVERSE

status

DEFAULT_STATUS

targetFramerate

resolution

lastPulse

onFinished

DEFAULT_ON_FINISHED

cuePoints

Constructor Detail

Animation

Animation

Animation

Animation

Method Detail

now

addPulseReceiver

startReceiver

pauseReceiver

resumeReceiver

setRate

getRate

rateProperty

isRunningEmbedded

doSetCurrentRate

getCurrentRate

currentRateProperty

setCycleDuration

getCycleDuration

cycleDurationProperty

getTotalDuration

totalDurationProperty

updateTotalDuration