public final class ScaleTransition extends Transition
Transition
creates a scale animation that spans its
duration
. This is done by updating the scaleX
,
scaleY
and scaleZ
variables of the node
at regular
interval.
It starts from the (fromX
, fromY
, fromZ
) value if
provided else uses the node
's (scaleX
, scaleY
,
scaleZ
) 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);
ScaleTransition st = new ScaleTransition(Duration.millis(2000), rect);
st.setByX(1.5f);
st.setByY(1.5f);
st.setCycleCount(4f);
st.setAutoReverse(true);
st.play();
...
Transition
,
Animation
Type | Property and Description |
---|---|
DoubleProperty |
byX
Specifies the incremented stop X scale value, from the start, of this
ScaleTransition . |
DoubleProperty |
byY
Specifies the incremented stop Y scale value, from the start, of this
ScaleTransition . |
DoubleProperty |
byZ
Specifies the incremented stop Z scale value, from the start, of this
ScaleTransition . |
ObjectProperty<Duration> |
duration
The duration of this
ScaleTransition . |
DoubleProperty |
fromX
Specifies the start X scale value of this
ScaleTransition . |
DoubleProperty |
fromY
Specifies the start Y scale value of this
ScaleTransition . |
DoubleProperty |
fromZ
Specifies the start Z scale value of this
ScaleTransition . |
ObjectProperty<Node> |
node
The target node of this
ScaleTransition . |
DoubleProperty |
toX
Specifies the stop X scale value of this
ScaleTransition . |
DoubleProperty |
toY
The stop Y scale value of this
ScaleTransition . |
DoubleProperty |
toZ
The stop Z scale value of this
ScaleTransition . |
interpolator
autoReverse, currentRate, currentTime, cycleCount, cycleDuration, delay, onFinished, rate, status, totalDuration
Animation.Status
INDEFINITE
Constructor and Description |
---|
ScaleTransition()
The constructor of
ScaleTransition |
ScaleTransition(Duration duration)
The constructor of
ScaleTransition |
ScaleTransition(Duration duration,
Node node)
The constructor of
ScaleTransition |
Modifier and Type | Method and Description |
---|---|
DoubleProperty |
byXProperty()
Specifies the incremented stop X scale value, from the start, of this
ScaleTransition . |
DoubleProperty |
byYProperty()
Specifies the incremented stop Y scale value, from the start, of this
ScaleTransition . |
DoubleProperty |
byZProperty()
Specifies the incremented stop Z scale value, from the start, of this
ScaleTransition . |
ObjectProperty<Duration> |
durationProperty()
The duration of this
ScaleTransition . |
DoubleProperty |
fromXProperty()
Specifies the start X scale value of this
ScaleTransition . |
DoubleProperty |
fromYProperty()
Specifies the start Y scale value of this
ScaleTransition . |
DoubleProperty |
fromZProperty()
Specifies the start Z scale value of this
ScaleTransition . |
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
ScaleTransition . |
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 scale value of this
ScaleTransition . |
DoubleProperty |
toYProperty()
The stop Y scale value of this
ScaleTransition . |
DoubleProperty |
toZProperty()
The stop Z scale value of this
ScaleTransition . |
getCachedInterpolator, getInterpolator, getParentTargetNode, interpolatorProperty, setInterpolator
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
public final ObjectProperty<Node> nodeProperty
ScaleTransition
.
It is not possible to change the target node
of a running
ScaleTransition
. If the value of node
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
getNode()
,
setNode(Node)
public final ObjectProperty<Duration> durationProperty
ScaleTransition
.
It is not possible to change the duration
of a running
ScaleTransition
. If the value of duration
is changed for
a running ScaleTransition
, 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
ScaleTransition
.
It is not possible to change fromX
of a running
ScaleTransition
. If the value of fromX
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getFromX()
,
setFromX(double)
public final DoubleProperty fromYProperty
ScaleTransition
.
It is not possible to change fromY
of a running
ScaleTransition
. If the value of fromY
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getFromY()
,
setFromY(double)
public final DoubleProperty fromZProperty
ScaleTransition
.
It is not possible to change fromZ
of a running
ScaleTransition
. If the value of fromZ
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getFromZ()
,
setFromZ(double)
public final DoubleProperty toXProperty
ScaleTransition
.
It is not possible to change toX
of a running
ScaleTransition
. If the value of toX
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getToX()
,
setToX(double)
public final DoubleProperty toYProperty
ScaleTransition
.
It is not possible to change toY
of a running
ScaleTransition
. If the value of toY
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getToY()
,
setToY(double)
public final DoubleProperty toZProperty
ScaleTransition
.
It is not possible to change toZ
of a running
ScaleTransition
. If the value of toZ
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getToZ()
,
setToZ(double)
public final DoubleProperty byXProperty
ScaleTransition
.
It is not possible to change byX
of a running
ScaleTransition
. If the value of byX
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
getByX()
,
setByX(double)
public final DoubleProperty byYProperty
ScaleTransition
.
It is not possible to change byY
of a running
ScaleTransition
. If the value of byY
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
getByY()
,
setByY(double)
public final DoubleProperty byZProperty
ScaleTransition
.
It is not possible to change byZ
of a running
ScaleTransition
. If the value of byZ
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
getByZ()
,
setByZ(double)
public ScaleTransition(Duration duration, Node node)
ScaleTransition
duration
- The duration of the ScaleTransition
node
- The node
which will be scaledpublic ScaleTransition(Duration duration)
ScaleTransition
duration
- The duration of the ScaleTransition
public ScaleTransition()
ScaleTransition
public final void setNode(Node value)
ScaleTransition
.
It is not possible to change the target node
of a running
ScaleTransition
. If the value of node
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
public final Node getNode()
ScaleTransition
.
It is not possible to change the target node
of a running
ScaleTransition
. If the value of node
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
public final ObjectProperty<Node> nodeProperty()
ScaleTransition
.
It is not possible to change the target node
of a running
ScaleTransition
. If the value of node
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
getNode()
,
setNode(Node)
public final void setDuration(Duration value)
ScaleTransition
.
It is not possible to change the duration
of a running
ScaleTransition
. If the value of duration
is changed for
a running ScaleTransition
, 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()
ScaleTransition
.
It is not possible to change the duration
of a running
ScaleTransition
. If the value of duration
is changed for
a running ScaleTransition
, 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()
ScaleTransition
.
It is not possible to change the duration
of a running
ScaleTransition
. If the value of duration
is changed for
a running ScaleTransition
, 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)
ScaleTransition
.
It is not possible to change fromX
of a running
ScaleTransition
. If the value of fromX
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final double getFromX()
ScaleTransition
.
It is not possible to change fromX
of a running
ScaleTransition
. If the value of fromX
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final DoubleProperty fromXProperty()
ScaleTransition
.
It is not possible to change fromX
of a running
ScaleTransition
. If the value of fromX
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getFromX()
,
setFromX(double)
public final void setFromY(double value)
ScaleTransition
.
It is not possible to change fromY
of a running
ScaleTransition
. If the value of fromY
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final double getFromY()
ScaleTransition
.
It is not possible to change fromY
of a running
ScaleTransition
. If the value of fromY
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final DoubleProperty fromYProperty()
ScaleTransition
.
It is not possible to change fromY
of a running
ScaleTransition
. If the value of fromY
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getFromY()
,
setFromY(double)
public final void setFromZ(double value)
ScaleTransition
.
It is not possible to change fromZ
of a running
ScaleTransition
. If the value of fromZ
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final double getFromZ()
ScaleTransition
.
It is not possible to change fromZ
of a running
ScaleTransition
. If the value of fromZ
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final DoubleProperty fromZProperty()
ScaleTransition
.
It is not possible to change fromZ
of a running
ScaleTransition
. If the value of fromZ
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getFromZ()
,
setFromZ(double)
public final void setToX(double value)
ScaleTransition
.
It is not possible to change toX
of a running
ScaleTransition
. If the value of toX
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final double getToX()
ScaleTransition
.
It is not possible to change toX
of a running
ScaleTransition
. If the value of toX
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final DoubleProperty toXProperty()
ScaleTransition
.
It is not possible to change toX
of a running
ScaleTransition
. If the value of toX
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getToX()
,
setToX(double)
public final void setToY(double value)
ScaleTransition
.
It is not possible to change toY
of a running
ScaleTransition
. If the value of toY
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final double getToY()
ScaleTransition
.
It is not possible to change toY
of a running
ScaleTransition
. If the value of toY
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final DoubleProperty toYProperty()
ScaleTransition
.
It is not possible to change toY
of a running
ScaleTransition
. If the value of toY
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getToY()
,
setToY(double)
public final void setToZ(double value)
ScaleTransition
.
It is not possible to change toZ
of a running
ScaleTransition
. If the value of toZ
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final double getToZ()
ScaleTransition
.
It is not possible to change toZ
of a running
ScaleTransition
. If the value of toZ
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final DoubleProperty toZProperty()
ScaleTransition
.
It is not possible to change toZ
of a running
ScaleTransition
. If the value of toZ
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getToZ()
,
setToZ(double)
public final void setByX(double value)
ScaleTransition
.
It is not possible to change byX
of a running
ScaleTransition
. If the value of byX
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
public final double getByX()
ScaleTransition
.
It is not possible to change byX
of a running
ScaleTransition
. If the value of byX
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
public final DoubleProperty byXProperty()
ScaleTransition
.
It is not possible to change byX
of a running
ScaleTransition
. If the value of byX
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
getByX()
,
setByX(double)
public final void setByY(double value)
ScaleTransition
.
It is not possible to change byY
of a running
ScaleTransition
. If the value of byY
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
public final double getByY()
ScaleTransition
.
It is not possible to change byY
of a running
ScaleTransition
. If the value of byY
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
public final DoubleProperty byYProperty()
ScaleTransition
.
It is not possible to change byY
of a running
ScaleTransition
. If the value of byY
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
getByY()
,
setByY(double)
public final void setByZ(double value)
ScaleTransition
.
It is not possible to change byZ
of a running
ScaleTransition
. If the value of byZ
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
public final double getByZ()
ScaleTransition
.
It is not possible to change byZ
of a running
ScaleTransition
. If the value of byZ
is changed for a
running ScaleTransition
, the animation has to be stopped and
started again to pick up the new value.
public final DoubleProperty byZProperty()
ScaleTransition
.
It is not possible to change byZ
of a running
ScaleTransition
. If the value of byZ
is changed for a
running ScaleTransition
, 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 Transition
frac
- The relative positionSubmit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 2008, 2017, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.