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();
AnimationAnimation.Status| Modifier and Type | Field and Description |
|---|---|
private Interpolator |
cachedInterpolator |
private static Interpolator |
DEFAULT_INTERPOLATOR |
private ObjectProperty<Interpolator> |
interpolator
Controls the timing for acceleration and deceleration at each
Transition cycle. |
clipEnvelope, INDEFINITE, parent, pulseReceiver| Constructor and Description |
|---|
Transition()
The constructor of
Transition. |
Transition(AbstractMasterTimer timer) |
Transition(double targetFramerate)
The constructor of
Transition. |
| Modifier and Type | Method and Description |
|---|---|
private double |
calculateFraction(long currentTicks,
long cycleTicks) |
protected Interpolator |
getCachedInterpolator()
Returns the
Interpolator, that was set when the
Transition was started. |
Interpolator |
getInterpolator() |
protected Node |
getParentTargetNode()
Returns the target
Node for animation of this Transition. |
(package private) void |
impl_jumpTo(long currentTicks,
long cycleTicks,
boolean forceJump) |
(package private) void |
impl_playTo(long currentTicks,
long cycleTicks) |
(package private) boolean |
impl_startable(boolean forceSync) |
(package private) void |
impl_sync(boolean forceSync) |
protected abstract void |
interpolate(double frac)
The method
interpolate() has to be provided by implementations of
Transition. |
ObjectProperty<Interpolator> |
interpolatorProperty() |
void |
setInterpolator(Interpolator value) |
autoReverseProperty, currentRateProperty, currentTimeProperty, cycleCountProperty, cycleDurationProperty, delayProperty, getCuePoints, getCurrentRate, getCurrentTime, getCycleCount, getCycleDuration, getDelay, getOnFinished, getRate, getStatus, getTargetFramerate, getTotalDuration, impl_finished, impl_pause, impl_resume, impl_setCurrentRate, impl_setCurrentTicks, impl_start, impl_stop, impl_timePulse, isAutoReverse, jumpTo, jumpTo, onFinishedProperty, pause, pauseReceiver, play, playFrom, playFrom, playFromStart, rateProperty, resumeReceiver, setAutoReverse, setCycleCount, setCycleDuration, setDelay, setOnFinished, setRate, setStatus, startReceiver, statusProperty, stop, totalDurationPropertyprivate ObjectProperty<Interpolator> interpolator
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.
private static final Interpolator DEFAULT_INTERPOLATOR
private Interpolator cachedInterpolator
public Transition(double targetFramerate)
Transition.
This constructor allows to define a Animation.targetFramerate.targetFramerate - The custom target frame rate for this Transitionpublic Transition()
Transition.Transition(AbstractMasterTimer timer)
public final void setInterpolator(Interpolator value)
public final Interpolator getInterpolator()
public final ObjectProperty<Interpolator> interpolatorProperty()
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 positionprivate double calculateFraction(long currentTicks,
long cycleTicks)
boolean impl_startable(boolean forceSync)
impl_startable in class Animationvoid impl_playTo(long currentTicks,
long cycleTicks)
impl_playTo in class Animationvoid impl_jumpTo(long currentTicks,
long cycleTicks,
boolean forceJump)
impl_jumpTo in class Animation