public final class FillTransition extends Transition
Transition
creates an animation, that changes the filling of a
shape over a duration
. This is done by updating the fill
variable of the shape
at regular intervals.
It starts from the fromValue
if provided else uses the shape
's fill
value. (The stroke
value has to be a
Color
in this case).
It stops at the toValue
value.
Code Segment Example:
import javafx.scene.shape.*;
import javafx.animation.*;
...
Rectangle rect = new Rectangle (100, 40, 100, 100);
rect.setArcHeight(50);
rect.setArcWidth(50);
FillTransition ft = new FillTransition(Duration.millis(3000), rect, Color.RED, Color.BLUE);
ft.setCycleCount(4);
ft.setAutoReverse(true);
ft.play();
...
- Since:
- JavaFX 2.0
- See Also:
Transition
,Animation
-
Property Summary
Properties Type Property Description ObjectProperty<Duration>
duration
The duration of thisFillTransition
.ObjectProperty<Color>
fromValue
Specifies the start color value for thisFillTransition
.ObjectProperty<Shape>
shape
The target shape of thisFillTransition
.ObjectProperty<Color>
toValue
Specifies the stop color value for thisFillTransition
.Properties inherited from class javafx.animation.Transition
interpolator
Properties inherited from class javafx.animation.Animation
autoReverse, currentRate, currentTime, cycleCount, cycleDuration, delay, onFinished, rate, status, totalDuration
-
Nested Class Summary
Nested classes/interfaces inherited from class javafx.animation.Animation
Animation.Status
-
Field Summary
Fields inherited from class javafx.animation.Animation
INDEFINITE
-
Constructor Summary
Constructors Constructor Description FillTransition()
The constructor ofFillTransition
FillTransition(Duration duration)
The constructor ofFillTransition
FillTransition(Duration duration, Color fromValue, Color toValue)
The constructor ofFillTransition
FillTransition(Duration duration, Shape shape)
The constructor ofFillTransition
FillTransition(Duration duration, Shape shape, Color fromValue, Color toValue)
The constructor ofFillTransition
-
Method Summary
Modifier and Type Method Description ObjectProperty<Duration>
durationProperty()
The duration of thisFillTransition
.ObjectProperty<Color>
fromValueProperty()
Specifies the start color value for thisFillTransition
.Duration
getDuration()
Gets the value of the property duration.Color
getFromValue()
Gets the value of the property fromValue.Shape
getShape()
Gets the value of the property shape.Color
getToValue()
Gets the value of the property toValue.protected void
interpolate(double frac)
The methodinterpolate()
has to be provided by implementations ofTransition
.void
setDuration(Duration value)
Sets the value of the property duration.void
setFromValue(Color value)
Sets the value of the property fromValue.void
setShape(Shape value)
Sets the value of the property shape.void
setToValue(Color value)
Sets the value of the property toValue.ObjectProperty<Shape>
shapeProperty()
The target shape of thisFillTransition
.ObjectProperty<Color>
toValueProperty()
Specifies the stop color value for thisFillTransition
.Methods inherited from class javafx.animation.Transition
getCachedInterpolator, getInterpolator, getParentTargetNode, interpolatorProperty, setInterpolator
Methods inherited from class javafx.animation.Animation
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
-
Property Details
-
shape
The target shape of thisFillTransition
.It is not possible to change the target
shape
of a runningFillTransition
. If the value ofshape
is changed for a runningFillTransition
, the animation has to be stopped and started again to pick up the new value.- See Also:
getShape()
,setShape(Shape)
-
duration
The duration of thisFillTransition
.It is not possible to change the
duration
of a runningFillTransition
. If the value ofduration
is changed for a runningFillTransition
, 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 thanDuration.ZERO
will result inIllegalArgumentException
.- Default value:
- 400ms
- See Also:
getDuration()
,setDuration(Duration)
-
fromValue
Specifies the start color value for thisFillTransition
.It is not possible to change
fromValue
of a runningFillTransition
. If the value offromValue
is changed for a runningFillTransition
, the animation has to be stopped and started again to pick up the new value.- Default value:
null
- See Also:
getFromValue()
,setFromValue(Color)
-
toValue
Specifies the stop color value for thisFillTransition
.It is not possible to change
toValue
of a runningFillTransition
. If the value oftoValue
is changed for a runningFillTransition
, the animation has to be stopped and started again to pick up the new value.- Default value:
null
- See Also:
getToValue()
,setToValue(Color)
-
-
Constructor Details
-
FillTransition
The constructor ofFillTransition
- Parameters:
duration
- The duration of theFillTransition
shape
- Theshape
which filling will be animatedfromValue
- The start value of the color-animationtoValue
- The end value of the color-animation
-
FillTransition
The constructor ofFillTransition
- Parameters:
duration
- The duration of theFillTransition
fromValue
- The start value of the color-animationtoValue
- The end value of the color-animation
-
FillTransition
The constructor ofFillTransition
- Parameters:
duration
- The duration of theFillTransition
shape
- Theshape
which filling will be animated
-
FillTransition
The constructor ofFillTransition
- Parameters:
duration
- The duration of theFadeTransition
-
FillTransition
public FillTransition()The constructor ofFillTransition
-
-
Method Details
-
setShape
Sets the value of the property shape.- Property description:
- The target shape of this
FillTransition
.It is not possible to change the target
shape
of a runningFillTransition
. If the value ofshape
is changed for a runningFillTransition
, the animation has to be stopped and started again to pick up the new value.
-
getShape
Gets the value of the property shape.- Property description:
- The target shape of this
FillTransition
.It is not possible to change the target
shape
of a runningFillTransition
. If the value ofshape
is changed for a runningFillTransition
, the animation has to be stopped and started again to pick up the new value.
-
shapeProperty
The target shape of thisFillTransition
.It is not possible to change the target
shape
of a runningFillTransition
. If the value ofshape
is changed for a runningFillTransition
, the animation has to be stopped and started again to pick up the new value.- See Also:
getShape()
,setShape(Shape)
-
setDuration
Sets the value of the property duration.- Property description:
- The duration of this
FillTransition
.It is not possible to change the
duration
of a runningFillTransition
. If the value ofduration
is changed for a runningFillTransition
, 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 thanDuration.ZERO
will result inIllegalArgumentException
. - Default value:
- 400ms
-
getDuration
Gets the value of the property duration.- Property description:
- The duration of this
FillTransition
.It is not possible to change the
duration
of a runningFillTransition
. If the value ofduration
is changed for a runningFillTransition
, 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 thanDuration.ZERO
will result inIllegalArgumentException
. - Default value:
- 400ms
-
durationProperty
The duration of thisFillTransition
.It is not possible to change the
duration
of a runningFillTransition
. If the value ofduration
is changed for a runningFillTransition
, 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 thanDuration.ZERO
will result inIllegalArgumentException
.- Default value:
- 400ms
- See Also:
getDuration()
,setDuration(Duration)
-
setFromValue
Sets the value of the property fromValue.- Property description:
- Specifies the start color value for this
FillTransition
.It is not possible to change
fromValue
of a runningFillTransition
. If the value offromValue
is changed for a runningFillTransition
, the animation has to be stopped and started again to pick up the new value. - Default value:
null
-
getFromValue
Gets the value of the property fromValue.- Property description:
- Specifies the start color value for this
FillTransition
.It is not possible to change
fromValue
of a runningFillTransition
. If the value offromValue
is changed for a runningFillTransition
, the animation has to be stopped and started again to pick up the new value. - Default value:
null
-
fromValueProperty
Specifies the start color value for thisFillTransition
.It is not possible to change
fromValue
of a runningFillTransition
. If the value offromValue
is changed for a runningFillTransition
, the animation has to be stopped and started again to pick up the new value.- Default value:
null
- See Also:
getFromValue()
,setFromValue(Color)
-
setToValue
Sets the value of the property toValue.- Property description:
- Specifies the stop color value for this
FillTransition
.It is not possible to change
toValue
of a runningFillTransition
. If the value oftoValue
is changed for a runningFillTransition
, the animation has to be stopped and started again to pick up the new value. - Default value:
null
-
getToValue
Gets the value of the property toValue.- Property description:
- Specifies the stop color value for this
FillTransition
.It is not possible to change
toValue
of a runningFillTransition
. If the value oftoValue
is changed for a runningFillTransition
, the animation has to be stopped and started again to pick up the new value. - Default value:
null
-
toValueProperty
Specifies the stop color value for thisFillTransition
.It is not possible to change
toValue
of a runningFillTransition
. If the value oftoValue
is changed for a runningFillTransition
, the animation has to be stopped and started again to pick up the new value.- Default value:
null
- See Also:
getToValue()
,setToValue(Color)
-
interpolate
protected void interpolate(double frac)The methodinterpolate()
has to be provided by implementations ofTransition
. While aTransition
is running, this method is called in every frame. The parameter defines the current position with the animation. At the start, the fraction will be0.0
and at the end it will be1.0
. How the parameter increases, depends on theinterpolator
, e.g. if theinterpolator
isInterpolator.LINEAR
, the fraction will increase linear. This method must not be called by the user directly.- Specified by:
interpolate
in classTransition
- Parameters:
frac
- The relative position
-