Transition
creates an animation, that changes the stroke color
of a shape over a duration
. This is done by updating the
stroke
variable of the shape
at regular intervals.
It starts from the fromValue
if provided else uses the shape
's stroke
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);
rect.setFill(null);
StrokeTransition st = new StrokeTransition(Duration.millis(3000), rect, Color.RED, Color.BLUE);
st.setCycleCount(4);
st.setAutoReverse(true);
st.play();
...
- Since:
- JavaFX 2.0
- See Also:
-
Property Summary
TypePropertyDescriptionfinal ObjectProperty<Duration>
The duration of thisStrokeTransition
.final ObjectProperty<Color>
Specifies the start color value for thisStrokeTransition
.final ObjectProperty<Shape>
The target shape of thisStrokeTransition
.final ObjectProperty<Color>
Specifies the stop color value for thisStrokeTransition
.Properties declared in class javafx.animation.Transition
interpolator
Properties declared in class javafx.animation.Animation
autoReverse, currentRate, currentTime, cycleCount, cycleDuration, delay, onFinished, rate, status, totalDuration
-
Nested Class Summary
Nested classes/interfaces declared in class javafx.animation.Animation
Animation.Status
-
Field Summary
Fields declared in class javafx.animation.Animation
INDEFINITE
-
Constructor Summary
ConstructorDescriptionThe constructor ofStrokeTransition
StrokeTransition
(Duration duration) The constructor ofStrokeTransition
StrokeTransition
(Duration duration, Color fromValue, Color toValue) The constructor ofStrokeTransition
StrokeTransition
(Duration duration, Shape shape) The constructor ofStrokeTransition
StrokeTransition
(Duration duration, Shape shape, Color fromValue, Color toValue) The constructor ofStrokeTransition
-
Method Summary
Modifier and TypeMethodDescriptionfinal ObjectProperty<Duration>
The duration of thisStrokeTransition
.final ObjectProperty<Color>
Specifies the start color value for thisStrokeTransition
.final Duration
Gets the value of theduration
property.final Color
Gets the value of thefromValue
property.final Shape
getShape()
Gets the value of theshape
property.final Color
Gets the value of thetoValue
property.protected void
interpolate
(double frac) The methodinterpolate()
has to be provided by implementations ofTransition
.final void
setDuration
(Duration value) Sets the value of theduration
property.final void
setFromValue
(Color value) Sets the value of thefromValue
property.final void
Sets the value of theshape
property.final void
setToValue
(Color value) Sets the value of thetoValue
property.final ObjectProperty<Shape>
The target shape of thisStrokeTransition
.final ObjectProperty<Color>
Specifies the stop color value for thisStrokeTransition
.Methods declared in class javafx.animation.Transition
getCachedInterpolator, getInterpolator, getParentTargetNode, interpolatorProperty, setInterpolator
Methods declared in 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 thisStrokeTransition
.It is not possible to change the target
shape
of a runningStrokeTransition
. If the value ofshape
is changed for a runningStrokeTransition
, the animation has to be stopped and started again to pick up the new value.- See Also:
-
duration
The duration of thisStrokeTransition
.It is not possible to change the
duration
of a runningStrokeTransition
. If the value ofduration
is changed for a runningStrokeTransition
, 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:
-
fromValue
Specifies the start color value for thisStrokeTransition
.It is not possible to change
fromValue
of a runningStrokeTransition
. If the value offromValue
is changed for a runningStrokeTransition
, the animation has to be stopped and started again to pick up the new value.- Default value:
null
- See Also:
-
toValue
Specifies the stop color value for thisStrokeTransition
.It is not possible to change
toValue
of a runningStrokeTransition
. If the value oftoValue
is changed for a runningStrokeTransition
, the animation has to be stopped and started again to pick up the new value.- Default value:
null
- See Also:
-
-
Constructor Details
-
StrokeTransition
The constructor ofStrokeTransition
- Parameters:
duration
- The duration of theStrokeTransition
shape
- Theshape
which filling will be animatedfromValue
- The start value of the color-animationtoValue
- The end value of the color-animation
-
StrokeTransition
The constructor ofStrokeTransition
- Parameters:
duration
- The duration of theStrokeTransition
fromValue
- The start value of the color-animationtoValue
- The end value of the color-animation
-
StrokeTransition
The constructor ofStrokeTransition
- Parameters:
duration
- The duration of theStrokeTransition
shape
- Theshape
which stroke paint will be animated
-
StrokeTransition
The constructor ofStrokeTransition
- Parameters:
duration
- The duration of theStrokeTransition
-
StrokeTransition
public StrokeTransition()The constructor ofStrokeTransition
-
-
Method Details
-
setShape
Sets the value of theshape
property.- Property description:
- The target shape of this
StrokeTransition
.It is not possible to change the target
shape
of a runningStrokeTransition
. If the value ofshape
is changed for a runningStrokeTransition
, the animation has to be stopped and started again to pick up the new value. - Parameters:
value
- the value for theshape
property- See Also:
-
getShape
Gets the value of theshape
property.- Property description:
- The target shape of this
StrokeTransition
.It is not possible to change the target
shape
of a runningStrokeTransition
. If the value ofshape
is changed for a runningStrokeTransition
, the animation has to be stopped and started again to pick up the new value. - Returns:
- the value of the
shape
property - See Also:
-
shapeProperty
The target shape of thisStrokeTransition
.It is not possible to change the target
shape
of a runningStrokeTransition
. If the value ofshape
is changed for a runningStrokeTransition
, the animation has to be stopped and started again to pick up the new value.- Returns:
- the
shape
property - See Also:
-
setDuration
Sets the value of theduration
property.- Property description:
- The duration of this
StrokeTransition
.It is not possible to change the
duration
of a runningStrokeTransition
. If the value ofduration
is changed for a runningStrokeTransition
, 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
- Parameters:
value
- the value for theduration
property- See Also:
-
getDuration
Gets the value of theduration
property.- Property description:
- The duration of this
StrokeTransition
.It is not possible to change the
duration
of a runningStrokeTransition
. If the value ofduration
is changed for a runningStrokeTransition
, 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
- Returns:
- the value of the
duration
property - See Also:
-
durationProperty
The duration of thisStrokeTransition
.It is not possible to change the
duration
of a runningStrokeTransition
. If the value ofduration
is changed for a runningStrokeTransition
, 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
- Returns:
- the
duration
property - See Also:
-
setFromValue
Sets the value of thefromValue
property.- Property description:
- Specifies the start color value for this
StrokeTransition
.It is not possible to change
fromValue
of a runningStrokeTransition
. If the value offromValue
is changed for a runningStrokeTransition
, the animation has to be stopped and started again to pick up the new value. - Default value:
null
- Parameters:
value
- the value for thefromValue
property- See Also:
-
getFromValue
Gets the value of thefromValue
property.- Property description:
- Specifies the start color value for this
StrokeTransition
.It is not possible to change
fromValue
of a runningStrokeTransition
. If the value offromValue
is changed for a runningStrokeTransition
, the animation has to be stopped and started again to pick up the new value. - Default value:
null
- Returns:
- the value of the
fromValue
property - See Also:
-
fromValueProperty
Specifies the start color value for thisStrokeTransition
.It is not possible to change
fromValue
of a runningStrokeTransition
. If the value offromValue
is changed for a runningStrokeTransition
, the animation has to be stopped and started again to pick up the new value.- Default value:
null
- Returns:
- the
fromValue
property - See Also:
-
setToValue
Sets the value of thetoValue
property.- Property description:
- Specifies the stop color value for this
StrokeTransition
.It is not possible to change
toValue
of a runningStrokeTransition
. If the value oftoValue
is changed for a runningStrokeTransition
, the animation has to be stopped and started again to pick up the new value. - Default value:
null
- Parameters:
value
- the value for thetoValue
property- See Also:
-
getToValue
Gets the value of thetoValue
property.- Property description:
- Specifies the stop color value for this
StrokeTransition
.It is not possible to change
toValue
of a runningStrokeTransition
. If the value oftoValue
is changed for a runningStrokeTransition
, the animation has to be stopped and started again to pick up the new value. - Default value:
null
- Returns:
- the value of the
toValue
property - See Also:
-
toValueProperty
Specifies the stop color value for thisStrokeTransition
.It is not possible to change
toValue
of a runningStrokeTransition
. If the value oftoValue
is changed for a runningStrokeTransition
, the animation has to be stopped and started again to pick up the new value.- Default value:
null
- Returns:
- the
toValue
property - See Also:
-
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
-