Transition
creates a path animation that spans its
duration
. The translation along the path is done by updating the
translateX
and translateY
variables of the node
, and
the rotate
variable will get updated if orientation
is set to
OrientationType.ORTHOGONAL_TO_TANGENT
, at regular interval.
The animated path is defined by the outline of a shape.
Code Segment Example:
import javafx.scene.shape.*;
import javafx.animation.*;
...
Rectangle rect = new Rectangle (100, 40, 100, 100);
rect.setArcHeight(50);
rect.setArcWidth(50);
rect.setFill(Color.VIOLET);
Path path = new Path();
path.getElements().add (new MoveTo (0f, 50f));
path.getElements().add (new CubicCurveTo (40f, 10f, 390f, 240f, 1904, 50f));
pathTransition.setDuration(Duration.millis(10000));
pathTransition.setNode(rect);
pathTransition.setPath(path);
pathTransition.setOrientation(OrientationType.ORTHOGONAL_TO_TANGENT);
pathTransition.setCycleCount(4f);
pathTransition.setAutoReverse(true);
pathTransition.play();
...
- Since:
- JavaFX 2.0
- See Also:
-
Property Summary
TypePropertyDescriptionfinal ObjectProperty<Duration>
The duration of thisTransition
.final ObjectProperty<Node>
The target node of thisPathTransition
.Specifies the upright orientation ofnode
along thepath
.final ObjectProperty<Shape>
The shape on which outline the node should be animated.Properties declared in class javafx.animation.Transition
interpolator
Properties declared in class javafx.animation.Animation
autoReverse, currentRate, currentTime, cycleCount, cycleDuration, delay, onFinished, rate, status, totalDuration
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic enum
Specifies the upright orientation ofnode
along thepath
.Nested classes/interfaces declared in class javafx.animation.Animation
Animation.Status
-
Field Summary
Fields declared in class javafx.animation.Animation
INDEFINITE
-
Constructor Summary
ConstructorDescriptionThe constructor ofPathTransition
.PathTransition
(Duration duration, Shape path) The constructor ofPathTransition
.PathTransition
(Duration duration, Shape path, Node node) The constructor ofPathTransition
. -
Method Summary
Modifier and TypeMethodDescriptionfinal ObjectProperty<Duration>
The duration of thisTransition
.final Duration
Gets the value of theduration
property.final Node
getNode()
Gets the value of thenode
property.Gets the value of theorientation
property.final Shape
getPath()
Gets the value of thepath
property.void
interpolate
(double frac) The methodinterpolate()
has to be provided by implementations ofTransition
.final ObjectProperty<Node>
The target node of thisPathTransition
.Specifies the upright orientation ofnode
along thepath
.final ObjectProperty<Shape>
The shape on which outline the node should be animated.final void
setDuration
(Duration value) Sets the value of theduration
property.final void
Sets the value of thenode
property.final void
Sets the value of theorientation
property.final void
Sets the value of thepath
property.Methods declared in class javafx.animation.Transition
getCachedInterpolator, getInterpolator, getParentTargetNode, interpolatorProperty, setInterpolator
Methods declared in class javafx.animation.Animation
autoReverseProperty, currentRateProperty, currentTimeProperty, cycleCountProperty, cycleDurationProperty, delayProperty, getCuePoints, getCurrentRate, getCurrentTime, getCycleCount, getCycleDuration, getDelay, getOnFinished, getRate, getStatus, getTargetFramerate, getTotalDuration, isAutoReverse, jumpTo, jumpTo, onFinishedProperty, pause, play, playFrom, playFrom, playFromStart, rateProperty, setAutoReverse, setCycleCount, setCycleDuration, setDelay, setOnFinished, setRate, setStatus, statusProperty, stop, totalDurationProperty
-
Property Details
-
node
The target node of thisPathTransition
.It is not possible to change the target
node
of a runningPathTransition
. If the value ofnode
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value.- See Also:
-
duration
The duration of thisTransition
.It is not possible to change the
duration
of a runningPathTransition
. If the value ofduration
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value.Note: While the unit of
duration
is a millisecond, the granularity depends on the underlying operating system and will in general be larger. For example animations on desktop systems usually run with a maximum of 60fps which gives a granularity of ~17 ms. Setting duration to value lower thanDuration.ZERO
will result inIllegalArgumentException
.- Default value:
- 400ms
- See Also:
-
path
The shape on which outline the node should be animated.It is not possible to change the
path
of a runningPathTransition
. If the value ofpath
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value.- Default value:
- null
- See Also:
-
orientation
Specifies the upright orientation ofnode
along thepath
. The default orientation is set toPathTransition.OrientationType.NONE
.It is not possible to change the
orientation
of a runningPathTransition
. If the value oforientation
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value.- Default value:
- NONE
- See Also:
-
-
Constructor Details
-
PathTransition
The constructor ofPathTransition
. -
PathTransition
The constructor ofPathTransition
. -
PathTransition
public PathTransition()The constructor ofPathTransition
.
-
-
Method Details
-
setNode
Sets the value of thenode
property.- Property description:
- The target node of this
PathTransition
.It is not possible to change the target
node
of a runningPathTransition
. If the value ofnode
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value. - Parameters:
value
- the value for thenode
property- See Also:
-
getNode
Gets the value of thenode
property.- Property description:
- The target node of this
PathTransition
.It is not possible to change the target
node
of a runningPathTransition
. If the value ofnode
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value. - Returns:
- the value of the
node
property - See Also:
-
nodeProperty
The target node of thisPathTransition
.It is not possible to change the target
node
of a runningPathTransition
. If the value ofnode
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value.- Returns:
- the
node
property - See Also:
-
setDuration
Sets the value of theduration
property.- Property description:
- The duration of this
Transition
.It is not possible to change the
duration
of a runningPathTransition
. If the value ofduration
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value.Note: While the unit of
duration
is a millisecond, the granularity depends on the underlying operating system and will in general be larger. For example animations on desktop systems usually run with a maximum of 60fps which gives a granularity of ~17 ms. Setting duration to value lower thanDuration.ZERO
will result inIllegalArgumentException
. - Default value:
- 400ms
- Parameters:
value
- the value for theduration
property- See Also:
-
getDuration
Gets the value of theduration
property.- Property description:
- The duration of this
Transition
.It is not possible to change the
duration
of a runningPathTransition
. If the value ofduration
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value.Note: While the unit of
duration
is a millisecond, the granularity depends on the underlying operating system and will in general be larger. For example animations on desktop systems usually run with a maximum of 60fps which gives a granularity of ~17 ms. Setting duration to value lower thanDuration.ZERO
will result inIllegalArgumentException
. - Default value:
- 400ms
- Returns:
- the value of the
duration
property - See Also:
-
durationProperty
The duration of thisTransition
.It is not possible to change the
duration
of a runningPathTransition
. If the value ofduration
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value.Note: While the unit of
duration
is a millisecond, the granularity depends on the underlying operating system and will in general be larger. For example animations on desktop systems usually run with a maximum of 60fps which gives a granularity of ~17 ms. Setting duration to value lower thanDuration.ZERO
will result inIllegalArgumentException
.- Default value:
- 400ms
- Returns:
- the
duration
property - See Also:
-
setPath
Sets the value of thepath
property.- Property description:
- The shape on which outline the node should be animated.
It is not possible to change the
path
of a runningPathTransition
. If the value ofpath
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value. - Default value:
- null
- Parameters:
value
- the value for thepath
property- See Also:
-
getPath
Gets the value of thepath
property.- Property description:
- The shape on which outline the node should be animated.
It is not possible to change the
path
of a runningPathTransition
. If the value ofpath
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value. - Default value:
- null
- Returns:
- the value of the
path
property - See Also:
-
pathProperty
The shape on which outline the node should be animated.It is not possible to change the
path
of a runningPathTransition
. If the value ofpath
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value.- Default value:
- null
- Returns:
- the
path
property - See Also:
-
setOrientation
Sets the value of theorientation
property.- Property description:
- Specifies the upright orientation of
node
along thepath
. The default orientation is set toPathTransition.OrientationType.NONE
.It is not possible to change the
orientation
of a runningPathTransition
. If the value oforientation
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value. - Default value:
- NONE
- Parameters:
value
- the value for theorientation
property- See Also:
-
getOrientation
Gets the value of theorientation
property.- Property description:
- Specifies the upright orientation of
node
along thepath
. The default orientation is set toPathTransition.OrientationType.NONE
.It is not possible to change the
orientation
of a runningPathTransition
. If the value oforientation
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value. - Default value:
- NONE
- Returns:
- the value of the
orientation
property - See Also:
-
orientationProperty
Specifies the upright orientation ofnode
along thepath
. The default orientation is set toPathTransition.OrientationType.NONE
.It is not possible to change the
orientation
of a runningPathTransition
. If the value oforientation
is changed for a runningPathTransition
, the animation has to be stopped and started again to pick up the new value.- Default value:
- NONE
- Returns:
- the
orientation
property - See Also:
-
interpolate
public void interpolate(double frac) The methodinterpolate()
has to be provided by implementations ofTransition
. While aTransition
is running, this method is called in every frame. The parameter defines the current position with the animation. At the start, the fraction will be0.0
and at the end it will be1.0
. How the parameter increases, depends on theinterpolator
, e.g. if theinterpolator
isInterpolator.LINEAR
, the fraction will increase linear. This method must not be called by the user directly.- Specified by:
interpolate
in classTransition
- Parameters:
frac
- The relative position
-