Class FadeTransition


  • public final class FadeTransition
    extends Transition
    This 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.*;
    
     ...
    
         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();
    
     ...
    
     
     
    Since:
    JavaFX 2.0
    See Also:
    Transition, Animation
    • Property Detail

      • node

        public final ObjectProperty<Node> nodeProperty
        The target node of this 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.

        See Also:
        getNode(), setNode(Node)
      • duration

        public final ObjectProperty<Duration> durationProperty
        The duration of this 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.

        Default value:
        400ms
        See Also:
        getDuration(), setDuration(Duration)
      • fromValue

        public final DoubleProperty fromValueProperty
        Specifies the start opacity value for this 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.

        Default value:
        Double.NaN
        See Also:
        getFromValue(), setFromValue(double)
      • toValue

        public final DoubleProperty toValueProperty
        Specifies the stop opacity value for this 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.

        Default value:
        Double.NaN
        See Also:
        getToValue(), setToValue(double)
      • byValue

        public final DoubleProperty byValueProperty
        Specifies the incremented stop opacity value, from the start, of this 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.

        See Also:
        getByValue(), setByValue(double)
    • Constructor Detail

      • FadeTransition

        public FadeTransition​(Duration duration,
                              Node node)
        The constructor of FadeTransition
        Parameters:
        duration - The duration of the FadeTransition
        node - The node which opacity will be animated
      • FadeTransition

        public FadeTransition​(Duration duration)
        The constructor of FadeTransition
        Parameters:
        duration - The duration of the FadeTransition
      • FadeTransition

        public FadeTransition()
        The constructor of FadeTransition
    • Method Detail

      • setNode

        public final void setNode​(Node value)
        Sets the value of the property node.
        Property description:
        The target node of this 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

        public final Node getNode()
        Gets the value of the property node.
        Property description:
        The target node of this 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.

      • nodeProperty

        public final ObjectProperty<Node> nodeProperty()
        The target node of this 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.

        See Also:
        getNode(), setNode(Node)
      • setDuration

        public final void setDuration​(Duration value)
        Sets the value of the property duration.
        Property description:
        The duration of this 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.

        Default value:
        400ms
      • getDuration

        public final Duration getDuration()
        Gets the value of the property duration.
        Property description:
        The duration of this 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.

        Default value:
        400ms
      • durationProperty

        public final ObjectProperty<Duration> durationProperty()
        The duration of this 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.

        Default value:
        400ms
        See Also:
        getDuration(), setDuration(Duration)
      • setFromValue

        public final void setFromValue​(double value)
        Sets the value of the property fromValue.
        Property description:
        Specifies the start opacity value for this 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.

        Default value:
        Double.NaN
      • getFromValue

        public final double getFromValue()
        Gets the value of the property fromValue.
        Property description:
        Specifies the start opacity value for this 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.

        Default value:
        Double.NaN
      • fromValueProperty

        public final DoubleProperty fromValueProperty()
        Specifies the start opacity value for this 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.

        Default value:
        Double.NaN
        See Also:
        getFromValue(), setFromValue(double)
      • setToValue

        public final void setToValue​(double value)
        Sets the value of the property toValue.
        Property description:
        Specifies the stop opacity value for this 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.

        Default value:
        Double.NaN
      • getToValue

        public final double getToValue()
        Gets the value of the property toValue.
        Property description:
        Specifies the stop opacity value for this 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.

        Default value:
        Double.NaN
      • toValueProperty

        public final DoubleProperty toValueProperty()
        Specifies the stop opacity value for this 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.

        Default value:
        Double.NaN
        See Also:
        getToValue(), setToValue(double)
      • setByValue

        public final void setByValue​(double value)
        Sets the value of the property byValue.
        Property description:
        Specifies the incremented stop opacity value, from the start, of this 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

        public final double getByValue()
        Gets the value of the property byValue.
        Property description:
        Specifies the incremented stop opacity value, from the start, of this 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.

      • byValueProperty

        public final DoubleProperty byValueProperty()
        Specifies the incremented stop opacity value, from the start, of this 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.

        See Also:
        getByValue(), setByValue(double)
      • interpolate

        protected void interpolate​(double frac)
        The method 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.
        Specified by:
        interpolate in class Transition
        Parameters:
        frac - The relative position