public abstract class Transition extends Animation
Transition based animations, such as PathTransition and
RotateTransition.
This class offers a simple framework to define animation. It provides all the
basic functionality defined in Animation. Transition requires
the implementation of a method interpolate(double) which is the
called in each frame, while the Transition is running.
In addition an extending class needs to set the duration of a single cycle
with Animation.setCycleDuration(javafx.util.Duration). This duration
is usually set by the user via a duration property (as in
FadeTransition.duration) for example. But it can also be calculated
by the extending class as is done in ParallelTransition and
FadeTransition.
Below is a simple example. It creates a small animation that updates the
text property of a Text node. It starts
with an empty String and adds gradually letter by letter until the
full String was set when the animation finishes.
final String content = "Lorem ipsum";
final Text text = new Text(10, 20, "");
final Animation animation = new Transition() {
{
setCycleDuration(Duration.millis(2000));
}
protected void interpolate(double frac) {
final int length = content.length();
final int n = Math.round(length * (float) frac);
text.setText(content.substring(0, n));
}
};
animation.play();
Animation| Type | Property and Description |
|---|---|
ObjectProperty<Interpolator> |
interpolator
Controls the timing for acceleration and deceleration at each
Transition cycle. |
autoReverse, currentRate, currentTime, cycleCount, cycleDuration, delay, onFinished, rate, status, totalDurationAnimation.StatusINDEFINITE| Constructor and Description |
|---|
Transition()
The constructor of
Transition. |
Transition(double targetFramerate)
The constructor of
Transition. |
| Modifier and Type | Method and Description |
|---|---|
protected Interpolator |
getCachedInterpolator()
Returns the
Interpolator, that was set when the
Transition was started. |
Interpolator |
getInterpolator()
Gets the value of the property interpolator.
|
protected Node |
getParentTargetNode()
Returns the target
Node for animation of this Transition. |
protected abstract void |
interpolate(double frac)
The method
interpolate() has to be provided by implementations of
Transition. |
ObjectProperty<Interpolator> |
interpolatorProperty()
Controls the timing for acceleration and deceleration at each
Transition cycle. |
void |
setInterpolator(Interpolator value)
Sets the value of the property interpolator.
|
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, totalDurationPropertypublic final ObjectProperty<Interpolator> interpolatorProperty
Transition cycle.
This may only be changed prior to starting the transition or after the
transition has ended. If the value of interpolator is changed for
a running Transition, the animation has to be stopped and started again to
pick up the new value.
Default interpolator is set to Interpolator.EASE_BOTH.
getInterpolator(),
setInterpolator(Interpolator)public Transition(double targetFramerate)
Transition.
This constructor allows to define a Animation.targetFramerate.targetFramerate - The custom target frame rate for this Transitionpublic Transition()
Transition.public final void setInterpolator(Interpolator value)
Transition cycle.
This may only be changed prior to starting the transition or after the
transition has ended. If the value of interpolator is changed for
a running Transition, the animation has to be stopped and started again to
pick up the new value.
Default interpolator is set to Interpolator.EASE_BOTH.
public final Interpolator getInterpolator()
Transition cycle.
This may only be changed prior to starting the transition or after the
transition has ended. If the value of interpolator is changed for
a running Transition, the animation has to be stopped and started again to
pick up the new value.
Default interpolator is set to Interpolator.EASE_BOTH.
public final ObjectProperty<Interpolator> interpolatorProperty()
Transition cycle.
This may only be changed prior to starting the transition or after the
transition has ended. If the value of interpolator is changed for
a running Transition, the animation has to be stopped and started again to
pick up the new value.
Default interpolator is set to Interpolator.EASE_BOTH.
getInterpolator(),
setInterpolator(Interpolator)protected Interpolator getCachedInterpolator()
Interpolator, that was set when the
Transition was started.
Changing the interpolator of a running Transition should
have no immediate effect. Instead the running Transition should
continue to use the original Interpolator until it is stopped and
started again.Interpolator that was set when this
Transition was startedprotected Node getParentTargetNode()
Node for animation of this Transition.
This method returns node if it is set, else returns its
parent.getTargetNode() otherwise null.protected abstract 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.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.