javafx.animation

Class SequentialTransition

java.lang.Object

javafx.animation.Animation

javafx.animation.Transition

javafx.animation.SequentialTransition

public final class SequentialTransition
extends Transition

This Transition plays a list of Animations in sequential order.

Children of this Transition inherit node, if their node property is not specified.

Code Segment Example:

 
     Rectangle rect = new Rectangle (100, 40, 100, 100);
     rect.setArcHeight(50);
     rect.setArcWidth(50);
     rect.setFill(Color.VIOLET);

     final Duration SEC_2 = Duration.millis(2000);
     final Duration SEC_3 = Duration.millis(3000);

     PauseTransition pt = new PauseTransition(Duration.millis(1000));
     FadeTransition ft = new FadeTransition(SEC_3);
     ft.setFromValue(1.0f);
     ft.setToValue(0.3f);
     ft.setCycleCount(2f);
     ft.setAutoReverse(true);
     TranslateTransition tt = new TranslateTransition(SEC_2);
     tt.setFromX(-100f);
     tt.setToX(100f);
     tt.setCycleCount(2f);
     tt.setAutoReverse(true);
     RotateTransition rt = new RotateTransition(SEC_3);
     rt.setByAngle(180f);
     rt.setCycleCount(4f);
     rt.setAutoReverse(true);
     ScaleTransition st = new ScaleTransition(SEC_2);
     st.setByX(1.5f);
     st.setByY(1.5f);
     st.setCycleCount(2f);
     st.setAutoReverse(true);

     SequentialTransition seqT = new SequentialTransition (rect, pt, ft, tt, rt, st);
     seqT.play();
 
 

Since:

JavaFX 2.0

See Also:

Transition, Animation

Property Summary

Type	Property and Description
<any>	node This javafx.scene.Node is used in all child Transitions, that do not define a target Node themselves.

Properties inherited from class javafx.animation.Transition

interpolatorProperty

Properties inherited from class javafx.animation.Animation

autoReverseProperty, currentRateProperty, currentTimeProperty, cycleCountProperty, cycleDurationProperty, delayProperty, onFinishedProperty, rateProperty, statusProperty, totalDurationProperty

Nested Class Summary

Nested classes/interfaces inherited from class javafx.animation.Animation

Animation.Status

Field Summary

Fields

Modifier and Type	Field and Description
private static int	BEFORE
private Animation[]	cachedChildren
private <any>	children
private boolean	childrenChanged
private InvalidationListener	childrenListener
private java.util.Set<Animation>	childrenSet
private int	curIndex
private static Node	DEFAULT_NODE
private long[]	delays
private long[]	durations
private static Animation[]	EMPTY_ANIMATION_ARRAY
private int	end
private static double	EPSILON
private boolean[]	forceChildSync
private <any>	node This javafx.scene.Node is used in all child Transitions, that do not define a target Node themselves.
private long	offsetTicks
private long	oldTicks
private <any>	rateListener
private double[]	rates
private long[]	startTimes
private boolean	toggledRate

Fields inherited from class javafx.animation.Animation

clipEnvelope, INDEFINITE, parent, pulseReceiver

Constructor Summary

Constructors

Constructor and Description
SequentialTransition() The constructor of SequentialTransition.
SequentialTransition(AbstractMasterTimer timer)
SequentialTransition(Animation... children) The constructor of SequentialTransition.
SequentialTransition(Node node) The constructor of SequentialTransition.
SequentialTransition(Node node, Animation... children) The constructor of SequentialTransition.

Method Summary

Modifier and Type	Method and Description
private double	calculateFraction(long currentTicks, long cycleTicks)
private static boolean	checkCycle(Animation child, Animation parent)
private Duration	computeCycleDuration()
(package private) void	doJumpTo(long currentTicks, long cycleTicks, boolean forceJump)
(package private) void	doPause()
(package private) void	doPlayTo(long currentTicks, long cycleTicks)
(package private) void	doResume()
(package private) void	doStart(boolean forceSync)
(package private) void	doStop()
private int	findNewIndex(long ticks)
<any>	getChildren() A list of Animations that will be played sequentially.
Node	getNode() Gets the value of the property node.
protected Node	getParentTargetNode() Returns the first non-null target Node in the parent hierarchy of this Transition, or null if such a node is not found.
protected void	interpolate(double frac) The method interpolate() has to be provided by implementations of Transition.
private void	jumpToBefore()
private void	jumpToEnd()
<any>	nodeProperty() This javafx.scene.Node is used in all child Transitions, that do not define a target Node themselves.
void	setNode(Node value) Sets the value of the property node.
private boolean	startChild(Animation child, int index)
(package private) void	sync(boolean forceSync)

Methods inherited from class javafx.animation.Transition

getCachedInterpolator, getInterpolator, interpolatorProperty, setInterpolator, startable

Methods inherited from class javafx.animation.Animation

autoReverseProperty, currentRateProperty, currentTimeProperty, cycleCountProperty, cycleDurationProperty, delayProperty, doTimePulse, finished, getCuePoints, getCurrentRate, getCurrentTime, getCycleCount, getCycleDuration, getDelay, getOnFinished, getRate, getStatus, getTargetFramerate, getTotalDuration, isAutoReverse, jumpTo, onFinishedProperty, pause, pauseReceiver, play, playFrom, playFrom, playFromStart, rateProperty, resumeReceiver, setAutoReverse, setCurrentRate, setCurrentTicks, setCycleCount, setCycleDuration, setDelay, setOnFinished, setRate, setStatus, startReceiver, statusProperty, stop, totalDurationProperty

Methods inherited from class java.lang.Object

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

Property Detail

node

public final <any> nodeProperty

This javafx.scene.Node is used in all child Transitions, that do not define a target Node themselves. This can be used if a number of Transitions should be applied to a single Node.

It is not possible to change the target node of a running Transition. If the value of node is changed for a running Transition, the animation has to be stopped and started again to pick up the new value.

See Also:

getNode(), setNode(Node)

Field Detail

EMPTY_ANIMATION_ARRAY

private static final Animation[] EMPTY_ANIMATION_ARRAY

BEFORE

private static final int BEFORE

See Also:

Constant Field Values

EPSILON

private static final double EPSILON

See Also:

Constant Field Values

cachedChildren

private Animation[] cachedChildren

startTimes

private long[] startTimes

durations

private long[] durations

delays

private long[] delays

rates

private double[] rates

forceChildSync

private boolean[] forceChildSync

end

private int end

curIndex

private int curIndex

oldTicks

private long oldTicks

offsetTicks

private long offsetTicks

childrenChanged

private boolean childrenChanged

toggledRate

private boolean toggledRate

childrenListener

private final InvalidationListener childrenListener

rateListener

private final <any> rateListener

node

private <any> node

This javafx.scene.Node is used in all child Transitions, that do not define a target Node themselves. This can be used if a number of Transitions should be applied to a single Node.

It is not possible to change the target node of a running Transition. If the value of node is changed for a running Transition, the animation has to be stopped and started again to pick up the new value.

DEFAULT_NODE

private static final Node DEFAULT_NODE

childrenSet

private final java.util.Set<Animation> childrenSet

children

private final <any> children

Constructor Detail

SequentialTransition

public SequentialTransition(Node node,
                            Animation... children)

The constructor of SequentialTransition.

Parameters:

node - The target javafx.scene.Node to be used in child Transitions that have no Node specified themselves

children - The child Animations of this SequentialTransition

SequentialTransition

public SequentialTransition(Animation... children)

The constructor of SequentialTransition.

Parameters:

children - The child Animations of this SequentialTransition

SequentialTransition

public SequentialTransition(Node node)

The constructor of SequentialTransition.

Parameters:

node - The target javafx.scene.Node to be used in child Transitions that have no Node specified themselves

SequentialTransition

public SequentialTransition()

The constructor of SequentialTransition.

SequentialTransition

SequentialTransition(AbstractMasterTimer timer)

Method Detail

setNode

public final void setNode(Node value)

Sets the value of the property node.

getNode

public final Node getNode()

Gets the value of the property node.

nodeProperty

public final <any> nodeProperty()

This javafx.scene.Node is used in all child Transitions, that do not define a target Node themselves. This can be used if a number of Transitions should be applied to a single Node.

It is not possible to change the target node of a running Transition. If the value of node is changed for a running Transition, the animation has to be stopped and started again to pick up the new value.

See Also:

getNode(), setNode(Node)

checkCycle

private static boolean checkCycle(Animation child,
                                  Animation parent)

getChildren

public final <any> getChildren()

A list of Animations that will be played sequentially.

It is not possible to change the children of a running SequentialTransition. If the children are changed for a running SequentialTransition, the animation has to be stopped and started again to pick up the new value.

Returns:

a list of Animations that will be played sequentially

getParentTargetNode

protected Node getParentTargetNode()

Returns the first non-null target Node in the parent hierarchy of this Transition, or null if such a node is not found.

A parent animation is one that can have child animations. Examples are SequentialTransition and ParallelTransition. A parent animation can also be a child of another parent animation.

Note that if this Transition has a target node set and is not a parent animation, it will be ignored during the call as this method only queries parent animations.

Overrides:

getParentTargetNode in class Transition

Returns:

the target Node

computeCycleDuration

private Duration computeCycleDuration()

calculateFraction

private double calculateFraction(long currentTicks,
                                 long cycleTicks)

findNewIndex

private int findNewIndex(long ticks)

sync

void sync(boolean forceSync)

Overrides:

sync in class Transition

doStart

void doStart(boolean forceSync)

Overrides:

doStart in class Animation

doPause

void doPause()

Overrides:

doPause in class Animation

doResume

void doResume()

Overrides:

doResume in class Animation

doStop

void doStop()

Overrides:

doStop in class Animation

startChild

private boolean startChild(Animation child,
                           int index)

doPlayTo

void doPlayTo(long currentTicks,
              long cycleTicks)

Overrides:

doPlayTo in class Transition

doJumpTo

void doJumpTo(long currentTicks,
              long cycleTicks,
              boolean forceJump)

Overrides:

doJumpTo in class Transition

jumpToEnd

private void jumpToEnd()

jumpToBefore

private void jumpToBefore()

interpolate

protected void interpolate(double frac)

The method interpolate() has to be provided by implementations of Transition. While a Transition is running, this method is called in every frame. The parameter defines the current position with the animation. At the start, the fraction will be 0.0 and at the end it will be 1.0. How the parameter increases, depends on the interpolator, e.g. if the interpolator is Interpolator.LINEAR, the fraction will increase linear. This method must not be called by the user directly.

Specified by:

interpolate in class Transition

Parameters:

frac - The relative position