public final class TranslateTransition extends Transition
Transition creates a move/translate animation that spans its
duration. This is done by updating the translateX,
translateY and translateZ variables of the node at
regular interval.
It starts from the (fromX, fromY, fromZ) value if
provided else uses the node's (translateX, translateY, translateZ) value.
It stops at the (toX, toY, toZ) value if provided
else it will use start value plus (byX, byY, byZ)
value.
The (toX, toY, toZ) value takes precedence if both (
toX, toY, toZ) and (byX, byY,
byZ) values are specified.
Code Segment Example:
import javafx.scene.shape.*;
import javafx.animation.transition.*;
...
Rectangle rect = new Rectangle (100, 40, 100, 100);
rect.setArcHeight(50);
rect.setArcWidth(50);
rect.setFill(Color.VIOLET);
TranslateTransition tt = new TranslateTransition(Duration.millis(2000), rect);
tt.setByX(200f);
tt.setCycleCount(4f);
tt.setAutoReverse(true);
tt.play();
...
Transition,
Animation| Type | Property and Description |
|---|---|
DoubleProperty |
byX
Specifies the incremented stop X coordinate value, from the start, of
this
TranslateTransition. |
DoubleProperty |
byY
Specifies the incremented stop Y coordinate value, from the start, of
this
TranslateTransition. |
DoubleProperty |
byZ
Specifies the incremented stop Z coordinate value, from the start, of
this
TranslateTransition. |
ObjectProperty<Duration> |
duration
The duration of this
TranslateTransition. |
DoubleProperty |
fromX
Specifies the start X coordinate value of this
TranslateTransition. |
DoubleProperty |
fromY
Specifies the start Y coordinate value of this
TranslateTransition. |
DoubleProperty |
fromZ
Specifies the start Z coordinate value of this
TranslateTransition. |
ObjectProperty<Node> |
node
The target node of this
TranslateTransition. |
DoubleProperty |
toX
Specifies the stop X coordinate value of this
TranslateTransition. |
DoubleProperty |
toY
Specifies the stop Y coordinate value of this
TranslateTransition. |
DoubleProperty |
toZ
Specifies the stop Z coordinate value of this
TranslateTransition. |
interpolatorautoReverse, currentRate, currentTime, cycleCount, cycleDuration, delay, onFinished, rate, status, totalDurationAnimation.StatusINDEFINITE| Constructor and Description |
|---|
TranslateTransition()
The constructor of
TranslateTransition |
TranslateTransition(Duration duration)
The constructor of
TranslateTransition |
TranslateTransition(Duration duration,
Node node)
The constructor of
TranslateTransition |
| Modifier and Type | Method and Description |
|---|---|
DoubleProperty |
byXProperty()
Specifies the incremented stop X coordinate value, from the start, of
this
TranslateTransition. |
DoubleProperty |
byYProperty()
Specifies the incremented stop Y coordinate value, from the start, of
this
TranslateTransition. |
DoubleProperty |
byZProperty()
Specifies the incremented stop Z coordinate value, from the start, of
this
TranslateTransition. |
ObjectProperty<Duration> |
durationProperty()
The duration of this
TranslateTransition. |
DoubleProperty |
fromXProperty()
Specifies the start X coordinate value of this
TranslateTransition. |
DoubleProperty |
fromYProperty()
Specifies the start Y coordinate value of this
TranslateTransition. |
DoubleProperty |
fromZProperty()
Specifies the start Z coordinate value of this
TranslateTransition. |
double |
getByX()
Gets the value of the property byX.
|
double |
getByY()
Gets the value of the property byY.
|
double |
getByZ()
Gets the value of the property byZ.
|
Duration |
getDuration()
Gets the value of the property duration.
|
double |
getFromX()
Gets the value of the property fromX.
|
double |
getFromY()
Gets the value of the property fromY.
|
double |
getFromZ()
Gets the value of the property fromZ.
|
Node |
getNode()
Gets the value of the property node.
|
double |
getToX()
Gets the value of the property toX.
|
double |
getToY()
Gets the value of the property toY.
|
double |
getToZ()
Gets the value of the property toZ.
|
void |
interpolate(double frac)
The method
interpolate() has to be provided by implementations of
Transition. |
ObjectProperty<Node> |
nodeProperty()
The target node of this
TranslateTransition. |
void |
setByX(double value)
Sets the value of the property byX.
|
void |
setByY(double value)
Sets the value of the property byY.
|
void |
setByZ(double value)
Sets the value of the property byZ.
|
void |
setDuration(Duration value)
Sets the value of the property duration.
|
void |
setFromX(double value)
Sets the value of the property fromX.
|
void |
setFromY(double value)
Sets the value of the property fromY.
|
void |
setFromZ(double value)
Sets the value of the property fromZ.
|
void |
setNode(Node value)
Sets the value of the property node.
|
void |
setToX(double value)
Sets the value of the property toX.
|
void |
setToY(double value)
Sets the value of the property toY.
|
void |
setToZ(double value)
Sets the value of the property toZ.
|
DoubleProperty |
toXProperty()
Specifies the stop X coordinate value of this
TranslateTransition. |
DoubleProperty |
toYProperty()
Specifies the stop Y coordinate value of this
TranslateTransition. |
DoubleProperty |
toZProperty()
Specifies the stop Z coordinate value of this
TranslateTransition. |
getCachedInterpolator, getInterpolator, getParentTargetNode, interpolatorProperty, setInterpolatorautoReverseProperty, 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, totalDurationPropertypublic final ObjectProperty<Node> nodeProperty
TranslateTransition.
It is not possible to change the target node of a running
TranslateTransition. If the value of node is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
getNode(),
setNode(Node)public final ObjectProperty<Duration> durationProperty
TranslateTransition.
It is not possible to change the duration of a running
TranslateTransition. If the value of duration is changed
for a running TranslateTransition, 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 than Duration.ZERO will result
in IllegalArgumentException.
getDuration(),
setDuration(Duration)public final DoubleProperty fromXProperty
TranslateTransition.
It is not possible to change fromX of a running
TranslateTransition. If the value of fromX is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
Double.NaNgetFromX(),
setFromX(double)public final DoubleProperty fromYProperty
TranslateTransition.
It is not possible to change fromY of a running
TranslateTransition. If the value of fromY is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
Double.NaNgetFromY(),
setFromY(double)public final DoubleProperty fromZProperty
TranslateTransition.
It is not possible to change fromZ of a running
TranslateTransition. If the value of fromZ is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
Double.NaNgetFromZ(),
setFromZ(double)public final DoubleProperty toXProperty
TranslateTransition.
It is not possible to change toX of a running
TranslateTransition. If the value of toX is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
Double.NaNgetToX(),
setToX(double)public final DoubleProperty toYProperty
TranslateTransition.
It is not possible to change toY of a running
TranslateTransition. If the value of toY is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
Double.NaNgetToY(),
setToY(double)public final DoubleProperty toZProperty
TranslateTransition.
It is not possible to change toZ of a running
TranslateTransition. If the value of toZ is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
Double.NaNgetToZ(),
setToZ(double)public final DoubleProperty byXProperty
TranslateTransition.
It is not possible to change byX of a running
TranslateTransition. If the value of byX is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
getByX(),
setByX(double)public final DoubleProperty byYProperty
TranslateTransition.
It is not possible to change byY of a running
TranslateTransition. If the value of byY is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
getByY(),
setByY(double)public final DoubleProperty byZProperty
TranslateTransition.
It is not possible to change byZ of a running
TranslateTransition. If the value of byZ is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
getByZ(),
setByZ(double)public TranslateTransition(Duration duration, Node node)
TranslateTransitionduration - The duration of the TranslateTransitionnode - The node which will be translatedpublic TranslateTransition(Duration duration)
TranslateTransitionduration - The duration of the TranslateTransitionpublic TranslateTransition()
TranslateTransitionpublic final void setNode(Node value)
TranslateTransition.
It is not possible to change the target node of a running
TranslateTransition. If the value of node is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
public final Node getNode()
TranslateTransition.
It is not possible to change the target node of a running
TranslateTransition. If the value of node is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
public final ObjectProperty<Node> nodeProperty()
TranslateTransition.
It is not possible to change the target node of a running
TranslateTransition. If the value of node is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
getNode(),
setNode(Node)public final void setDuration(Duration value)
TranslateTransition.
It is not possible to change the duration of a running
TranslateTransition. If the value of duration is changed
for a running TranslateTransition, 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 than Duration.ZERO will result
in IllegalArgumentException.
public final Duration getDuration()
TranslateTransition.
It is not possible to change the duration of a running
TranslateTransition. If the value of duration is changed
for a running TranslateTransition, 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 than Duration.ZERO will result
in IllegalArgumentException.
public final ObjectProperty<Duration> durationProperty()
TranslateTransition.
It is not possible to change the duration of a running
TranslateTransition. If the value of duration is changed
for a running TranslateTransition, 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 than Duration.ZERO will result
in IllegalArgumentException.
getDuration(),
setDuration(Duration)public final void setFromX(double value)
TranslateTransition.
It is not possible to change fromX of a running
TranslateTransition. If the value of fromX is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
Double.NaNpublic final double getFromX()
TranslateTransition.
It is not possible to change fromX of a running
TranslateTransition. If the value of fromX is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
Double.NaNpublic final DoubleProperty fromXProperty()
TranslateTransition.
It is not possible to change fromX of a running
TranslateTransition. If the value of fromX is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
Double.NaNgetFromX(),
setFromX(double)public final void setFromY(double value)
TranslateTransition.
It is not possible to change fromY of a running
TranslateTransition. If the value of fromY is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
Double.NaNpublic final double getFromY()
TranslateTransition.
It is not possible to change fromY of a running
TranslateTransition. If the value of fromY is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
Double.NaNpublic final DoubleProperty fromYProperty()
TranslateTransition.
It is not possible to change fromY of a running
TranslateTransition. If the value of fromY is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
Double.NaNgetFromY(),
setFromY(double)public final void setFromZ(double value)
TranslateTransition.
It is not possible to change fromZ of a running
TranslateTransition. If the value of fromZ is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
Double.NaNpublic final double getFromZ()
TranslateTransition.
It is not possible to change fromZ of a running
TranslateTransition. If the value of fromZ is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
Double.NaNpublic final DoubleProperty fromZProperty()
TranslateTransition.
It is not possible to change fromZ of a running
TranslateTransition. If the value of fromZ is changed for
a running TranslateTransition, the animation has to be stopped
and started again to pick up the new value.
Double.NaNgetFromZ(),
setFromZ(double)public final void setToX(double value)
TranslateTransition.
It is not possible to change toX of a running
TranslateTransition. If the value of toX is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
Double.NaNpublic final double getToX()
TranslateTransition.
It is not possible to change toX of a running
TranslateTransition. If the value of toX is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
Double.NaNpublic final DoubleProperty toXProperty()
TranslateTransition.
It is not possible to change toX of a running
TranslateTransition. If the value of toX is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
Double.NaNgetToX(),
setToX(double)public final void setToY(double value)
TranslateTransition.
It is not possible to change toY of a running
TranslateTransition. If the value of toY is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
Double.NaNpublic final double getToY()
TranslateTransition.
It is not possible to change toY of a running
TranslateTransition. If the value of toY is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
Double.NaNpublic final DoubleProperty toYProperty()
TranslateTransition.
It is not possible to change toY of a running
TranslateTransition. If the value of toY is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
Double.NaNgetToY(),
setToY(double)public final void setToZ(double value)
TranslateTransition.
It is not possible to change toZ of a running
TranslateTransition. If the value of toZ is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
Double.NaNpublic final double getToZ()
TranslateTransition.
It is not possible to change toZ of a running
TranslateTransition. If the value of toZ is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
Double.NaNpublic final DoubleProperty toZProperty()
TranslateTransition.
It is not possible to change toZ of a running
TranslateTransition. If the value of toZ is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
Double.NaNgetToZ(),
setToZ(double)public final void setByX(double value)
TranslateTransition.
It is not possible to change byX of a running
TranslateTransition. If the value of byX is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
public final double getByX()
TranslateTransition.
It is not possible to change byX of a running
TranslateTransition. If the value of byX is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
public final DoubleProperty byXProperty()
TranslateTransition.
It is not possible to change byX of a running
TranslateTransition. If the value of byX is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
getByX(),
setByX(double)public final void setByY(double value)
TranslateTransition.
It is not possible to change byY of a running
TranslateTransition. If the value of byY is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
public final double getByY()
TranslateTransition.
It is not possible to change byY of a running
TranslateTransition. If the value of byY is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
public final DoubleProperty byYProperty()
TranslateTransition.
It is not possible to change byY of a running
TranslateTransition. If the value of byY is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
getByY(),
setByY(double)public final void setByZ(double value)
TranslateTransition.
It is not possible to change byZ of a running
TranslateTransition. If the value of byZ is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
public final double getByZ()
TranslateTransition.
It is not possible to change byZ of a running
TranslateTransition. If the value of byZ is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
public final DoubleProperty byZProperty()
TranslateTransition.
It is not possible to change byZ of a running
TranslateTransition. If the value of byZ is changed for a
running TranslateTransition, the animation has to be stopped and
started again to pick up the new value.
getByZ(),
setByZ(double)public void interpolate(double frac)
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.interpolate in class Transitionfrac - The relative positionCopyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.