public final class FadeTransition extends Transition
Transition
creates a fade effect animation that spans its
duration
. This is done by updating the opacity
variable of
the node
at regular interval.
It starts from the fromValue
if provided else uses the node
's
opacity
value.
It stops at the toValue
value if provided else it will use start
value plus byValue
.
The toValue
takes precedence if both toValue
and
byValue
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);
FadeTransition ft = new FadeTransition(Duration.millis(3000), rect);
ft.setFromValue(1.0);
ft.setToValue(0.3);
ft.setCycleCount(4);
ft.setAutoReverse(true);
ft.play();
...
Transition
,
Animation
Type | Property and Description |
---|---|
DoubleProperty |
byValue
Specifies the incremented stop opacity value, from the start, of this
FadeTransition . |
ObjectProperty<Duration> |
duration
The duration of this
FadeTransition . |
DoubleProperty |
fromValue
Specifies the start opacity value for this
FadeTransition . |
ObjectProperty<Node> |
node
The target node of this
Transition . |
DoubleProperty |
toValue
Specifies the stop opacity value for this
FadeTransition . |
interpolator
autoReverse, currentRate, currentTime, cycleCount, cycleDuration, delay, onFinished, rate, status, totalDuration
Animation.Status
INDEFINITE
Constructor and Description |
---|
FadeTransition()
The constructor of
FadeTransition |
FadeTransition(Duration duration)
The constructor of
FadeTransition |
FadeTransition(Duration duration,
Node node)
The constructor of
FadeTransition |
Modifier and Type | Method and Description |
---|---|
DoubleProperty |
byValueProperty()
Specifies the incremented stop opacity value, from the start, of this
FadeTransition . |
ObjectProperty<Duration> |
durationProperty()
The duration of this
FadeTransition . |
DoubleProperty |
fromValueProperty()
Specifies the start opacity value for this
FadeTransition . |
double |
getByValue()
Gets the value of the property byValue.
|
Duration |
getDuration()
Gets the value of the property duration.
|
double |
getFromValue()
Gets the value of the property fromValue.
|
Node |
getNode()
Gets the value of the property node.
|
double |
getToValue()
Gets the value of the property toValue.
|
protected void |
interpolate(double frac)
The method
interpolate() has to be provided by implementations of
Transition . |
ObjectProperty<Node> |
nodeProperty()
The target node of this
Transition . |
void |
setByValue(double value)
Sets the value of the property byValue.
|
void |
setDuration(Duration value)
Sets the value of the property duration.
|
void |
setFromValue(double value)
Sets the value of the property fromValue.
|
void |
setNode(Node value)
Sets the value of the property node.
|
void |
setToValue(double value)
Sets the value of the property toValue.
|
DoubleProperty |
toValueProperty()
Specifies the stop opacity value for this
FadeTransition . |
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
Transition
.
It is not possible to change the target node
of a running
FadeTransition
. If the value of node
is changed for a
running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
getNode()
,
setNode(Node)
public final ObjectProperty<Duration> durationProperty
FadeTransition
.
It is not possible to change the duration
of a running
FadeTransition
. If the value of duration
is changed for a
running FadeTransition
, 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 fromValueProperty
FadeTransition
.
It is not possible to change fromValue
of a running
FadeTransition
. If the value of fromValue
is changed for
a running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getFromValue()
,
setFromValue(double)
public final DoubleProperty toValueProperty
FadeTransition
.
It is not possible to change toValue
of a running
FadeTransition
. If the value of toValue
is changed for a
running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getToValue()
,
setToValue(double)
public final DoubleProperty byValueProperty
FadeTransition
.
It is not possible to change byValue
of a running
FadeTransition
. If the value of byValue
is changed for a
running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
getByValue()
,
setByValue(double)
public FadeTransition(Duration duration, Node node)
FadeTransition
duration
- The duration of the FadeTransition
node
- The node
which opacity will be animatedpublic FadeTransition(Duration duration)
FadeTransition
duration
- The duration of the FadeTransition
public FadeTransition()
FadeTransition
public final void setNode(Node value)
Transition
.
It is not possible to change the target node
of a running
FadeTransition
. If the value of node
is changed for a
running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
public final Node getNode()
Transition
.
It is not possible to change the target node
of a running
FadeTransition
. If the value of node
is changed for a
running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
public final ObjectProperty<Node> nodeProperty()
Transition
.
It is not possible to change the target node
of a running
FadeTransition
. If the value of node
is changed for a
running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
getNode()
,
setNode(Node)
public final void setDuration(Duration value)
FadeTransition
.
It is not possible to change the duration
of a running
FadeTransition
. If the value of duration
is changed for a
running FadeTransition
, 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()
FadeTransition
.
It is not possible to change the duration
of a running
FadeTransition
. If the value of duration
is changed for a
running FadeTransition
, 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()
FadeTransition
.
It is not possible to change the duration
of a running
FadeTransition
. If the value of duration
is changed for a
running FadeTransition
, 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 setFromValue(double value)
FadeTransition
.
It is not possible to change fromValue
of a running
FadeTransition
. If the value of fromValue
is changed for
a running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final double getFromValue()
FadeTransition
.
It is not possible to change fromValue
of a running
FadeTransition
. If the value of fromValue
is changed for
a running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final DoubleProperty fromValueProperty()
FadeTransition
.
It is not possible to change fromValue
of a running
FadeTransition
. If the value of fromValue
is changed for
a running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getFromValue()
,
setFromValue(double)
public final void setToValue(double value)
FadeTransition
.
It is not possible to change toValue
of a running
FadeTransition
. If the value of toValue
is changed for a
running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final double getToValue()
FadeTransition
.
It is not possible to change toValue
of a running
FadeTransition
. If the value of toValue
is changed for a
running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
public final DoubleProperty toValueProperty()
FadeTransition
.
It is not possible to change toValue
of a running
FadeTransition
. If the value of toValue
is changed for a
running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
Double.NaN
getToValue()
,
setToValue(double)
public final void setByValue(double value)
FadeTransition
.
It is not possible to change byValue
of a running
FadeTransition
. If the value of byValue
is changed for a
running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
public final double getByValue()
FadeTransition
.
It is not possible to change byValue
of a running
FadeTransition
. If the value of byValue
is changed for a
running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
public final DoubleProperty byValueProperty()
FadeTransition
.
It is not possible to change byValue
of a running
FadeTransition
. If the value of byValue
is changed for a
running FadeTransition
, the animation has to be stopped and
started again to pick up the new value.
getByValue()
,
setByValue(double)
protected 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.