Class TranslateTransition


public final class TranslateTransition extends Transition
This Transition creates a move/translate animation that spans its duration. This is done by updating the translateX, translateY and translateZ variables of the node at regular interval.

It starts from the (fromX, fromY, fromZ) value if provided else uses the node's (translateX, translateY, translateZ) value.

It stops at the (toX, toY, toZ) value if provided else it will use start value plus (byX, byY, byZ) value.

The (toX, toY, toZ) value takes precedence if both ( toX, toY, toZ) and (byX, byY, byZ) values 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);

     TranslateTransition tt = new TranslateTransition(Duration.millis(2000), rect);
     tt.setByX(200f);
     tt.setCycleCount(4f);
     tt.setAutoReverse(true);

     tt.play();

 ...

 
 
Since:
JavaFX 2.0
See Also:
  • Property Details

    • node

      public final ObjectProperty<Node> nodeProperty
      The target node of this TranslateTransition.

      It is not possible to change the target node of a running TranslateTransition. If the value of node is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      See Also:
    • duration

      public final ObjectProperty<Duration> durationProperty
      The duration of this TranslateTransition.

      It is not possible to change the duration of a running TranslateTransition. If the value of duration is changed for a running TranslateTransition, 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:
    • fromX

      public final DoubleProperty fromXProperty
      Specifies the start X coordinate value of this TranslateTransition.

      It is not possible to change fromX of a running TranslateTransition. If the value of fromX is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      See Also:
    • fromY

      public final DoubleProperty fromYProperty
      Specifies the start Y coordinate value of this TranslateTransition.

      It is not possible to change fromY of a running TranslateTransition. If the value of fromY is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      See Also:
    • fromZ

      public final DoubleProperty fromZProperty
      Specifies the start Z coordinate value of this TranslateTransition.

      It is not possible to change fromZ of a running TranslateTransition. If the value of fromZ is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      See Also:
    • toX

      public final DoubleProperty toXProperty
      Specifies the stop X coordinate value of this TranslateTransition.

      It is not possible to change toX of a running TranslateTransition. If the value of toX is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      See Also:
    • toY

      public final DoubleProperty toYProperty
      Specifies the stop Y coordinate value of this TranslateTransition.

      It is not possible to change toY of a running TranslateTransition. If the value of toY is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      See Also:
    • toZ

      public final DoubleProperty toZProperty
      Specifies the stop Z coordinate value of this TranslateTransition.

      It is not possible to change toZ of a running TranslateTransition. If the value of toZ is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      See Also:
    • byX

      public final DoubleProperty byXProperty
      Specifies the incremented stop X coordinate value, from the start, of this TranslateTransition.

      It is not possible to change byX of a running TranslateTransition. If the value of byX is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      See Also:
    • byY

      public final DoubleProperty byYProperty
      Specifies the incremented stop Y coordinate value, from the start, of this TranslateTransition.

      It is not possible to change byY of a running TranslateTransition. If the value of byY is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      See Also:
    • byZ

      public final DoubleProperty byZProperty
      Specifies the incremented stop Z coordinate value, from the start, of this TranslateTransition.

      It is not possible to change byZ of a running TranslateTransition. If the value of byZ is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      See Also:
  • Constructor Details

    • TranslateTransition

      public TranslateTransition(Duration duration, Node node)
      The constructor of TranslateTransition
      Parameters:
      duration - The duration of the TranslateTransition
      node - The node which will be translated
    • TranslateTransition

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

      public TranslateTransition()
      The constructor of TranslateTransition
  • Method Details

    • setNode

      public final void setNode(Node value)
      Sets the value of the node property.
      Property description:
      The target node of this TranslateTransition.

      It is not possible to change the target node of a running TranslateTransition. If the value of node is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Parameters:
      value - the value for the node property
      See Also:
    • getNode

      public final Node getNode()
      Gets the value of the node property.
      Property description:
      The target node of this TranslateTransition.

      It is not possible to change the target node of a running TranslateTransition. If the value of node is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Returns:
      the value of the node property
      See Also:
    • nodeProperty

      public final ObjectProperty<Node> nodeProperty()
      The target node of this TranslateTransition.

      It is not possible to change the target node of a running TranslateTransition. If the value of node is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Returns:
      the node property
      See Also:
    • setDuration

      public final void setDuration(Duration value)
      Sets the value of the duration property.
      Property description:
      The duration of this TranslateTransition.

      It is not possible to change the duration of a running TranslateTransition. If the value of duration is changed for a running TranslateTransition, 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
      Parameters:
      value - the value for the duration property
      See Also:
    • getDuration

      public final Duration getDuration()
      Gets the value of the duration property.
      Property description:
      The duration of this TranslateTransition.

      It is not possible to change the duration of a running TranslateTransition. If the value of duration is changed for a running TranslateTransition, 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
      Returns:
      the value of the duration property
      See Also:
    • durationProperty

      public final ObjectProperty<Duration> durationProperty()
      The duration of this TranslateTransition.

      It is not possible to change the duration of a running TranslateTransition. If the value of duration is changed for a running TranslateTransition, 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
      Returns:
      the duration property
      See Also:
    • setFromX

      public final void setFromX(double value)
      Sets the value of the fromX property.
      Property description:
      Specifies the start X coordinate value of this TranslateTransition.

      It is not possible to change fromX of a running TranslateTransition. If the value of fromX is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Parameters:
      value - the value for the fromX property
      See Also:
    • getFromX

      public final double getFromX()
      Gets the value of the fromX property.
      Property description:
      Specifies the start X coordinate value of this TranslateTransition.

      It is not possible to change fromX of a running TranslateTransition. If the value of fromX is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Returns:
      the value of the fromX property
      See Also:
    • fromXProperty

      public final DoubleProperty fromXProperty()
      Specifies the start X coordinate value of this TranslateTransition.

      It is not possible to change fromX of a running TranslateTransition. If the value of fromX is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Returns:
      the fromX property
      See Also:
    • setFromY

      public final void setFromY(double value)
      Sets the value of the fromY property.
      Property description:
      Specifies the start Y coordinate value of this TranslateTransition.

      It is not possible to change fromY of a running TranslateTransition. If the value of fromY is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Parameters:
      value - the value for the fromY property
      See Also:
    • getFromY

      public final double getFromY()
      Gets the value of the fromY property.
      Property description:
      Specifies the start Y coordinate value of this TranslateTransition.

      It is not possible to change fromY of a running TranslateTransition. If the value of fromY is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Returns:
      the value of the fromY property
      See Also:
    • fromYProperty

      public final DoubleProperty fromYProperty()
      Specifies the start Y coordinate value of this TranslateTransition.

      It is not possible to change fromY of a running TranslateTransition. If the value of fromY is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Returns:
      the fromY property
      See Also:
    • setFromZ

      public final void setFromZ(double value)
      Sets the value of the fromZ property.
      Property description:
      Specifies the start Z coordinate value of this TranslateTransition.

      It is not possible to change fromZ of a running TranslateTransition. If the value of fromZ is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Parameters:
      value - the value for the fromZ property
      See Also:
    • getFromZ

      public final double getFromZ()
      Gets the value of the fromZ property.
      Property description:
      Specifies the start Z coordinate value of this TranslateTransition.

      It is not possible to change fromZ of a running TranslateTransition. If the value of fromZ is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Returns:
      the value of the fromZ property
      See Also:
    • fromZProperty

      public final DoubleProperty fromZProperty()
      Specifies the start Z coordinate value of this TranslateTransition.

      It is not possible to change fromZ of a running TranslateTransition. If the value of fromZ is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Returns:
      the fromZ property
      See Also:
    • setToX

      public final void setToX(double value)
      Sets the value of the toX property.
      Property description:
      Specifies the stop X coordinate value of this TranslateTransition.

      It is not possible to change toX of a running TranslateTransition. If the value of toX is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Parameters:
      value - the value for the toX property
      See Also:
    • getToX

      public final double getToX()
      Gets the value of the toX property.
      Property description:
      Specifies the stop X coordinate value of this TranslateTransition.

      It is not possible to change toX of a running TranslateTransition. If the value of toX is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Returns:
      the value of the toX property
      See Also:
    • toXProperty

      public final DoubleProperty toXProperty()
      Specifies the stop X coordinate value of this TranslateTransition.

      It is not possible to change toX of a running TranslateTransition. If the value of toX is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Returns:
      the toX property
      See Also:
    • setToY

      public final void setToY(double value)
      Sets the value of the toY property.
      Property description:
      Specifies the stop Y coordinate value of this TranslateTransition.

      It is not possible to change toY of a running TranslateTransition. If the value of toY is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Parameters:
      value - the value for the toY property
      See Also:
    • getToY

      public final double getToY()
      Gets the value of the toY property.
      Property description:
      Specifies the stop Y coordinate value of this TranslateTransition.

      It is not possible to change toY of a running TranslateTransition. If the value of toY is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Returns:
      the value of the toY property
      See Also:
    • toYProperty

      public final DoubleProperty toYProperty()
      Specifies the stop Y coordinate value of this TranslateTransition.

      It is not possible to change toY of a running TranslateTransition. If the value of toY is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Returns:
      the toY property
      See Also:
    • setToZ

      public final void setToZ(double value)
      Sets the value of the toZ property.
      Property description:
      Specifies the stop Z coordinate value of this TranslateTransition.

      It is not possible to change toZ of a running TranslateTransition. If the value of toZ is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Parameters:
      value - the value for the toZ property
      See Also:
    • getToZ

      public final double getToZ()
      Gets the value of the toZ property.
      Property description:
      Specifies the stop Z coordinate value of this TranslateTransition.

      It is not possible to change toZ of a running TranslateTransition. If the value of toZ is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Returns:
      the value of the toZ property
      See Also:
    • toZProperty

      public final DoubleProperty toZProperty()
      Specifies the stop Z coordinate value of this TranslateTransition.

      It is not possible to change toZ of a running TranslateTransition. If the value of toZ is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Default value:
      Double.NaN
      Returns:
      the toZ property
      See Also:
    • setByX

      public final void setByX(double value)
      Sets the value of the byX property.
      Property description:
      Specifies the incremented stop X coordinate value, from the start, of this TranslateTransition.

      It is not possible to change byX of a running TranslateTransition. If the value of byX is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Parameters:
      value - the value for the byX property
      See Also:
    • getByX

      public final double getByX()
      Gets the value of the byX property.
      Property description:
      Specifies the incremented stop X coordinate value, from the start, of this TranslateTransition.

      It is not possible to change byX of a running TranslateTransition. If the value of byX is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Returns:
      the value of the byX property
      See Also:
    • byXProperty

      public final DoubleProperty byXProperty()
      Specifies the incremented stop X coordinate value, from the start, of this TranslateTransition.

      It is not possible to change byX of a running TranslateTransition. If the value of byX is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Returns:
      the byX property
      See Also:
    • setByY

      public final void setByY(double value)
      Sets the value of the byY property.
      Property description:
      Specifies the incremented stop Y coordinate value, from the start, of this TranslateTransition.

      It is not possible to change byY of a running TranslateTransition. If the value of byY is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Parameters:
      value - the value for the byY property
      See Also:
    • getByY

      public final double getByY()
      Gets the value of the byY property.
      Property description:
      Specifies the incremented stop Y coordinate value, from the start, of this TranslateTransition.

      It is not possible to change byY of a running TranslateTransition. If the value of byY is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Returns:
      the value of the byY property
      See Also:
    • byYProperty

      public final DoubleProperty byYProperty()
      Specifies the incremented stop Y coordinate value, from the start, of this TranslateTransition.

      It is not possible to change byY of a running TranslateTransition. If the value of byY is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Returns:
      the byY property
      See Also:
    • setByZ

      public final void setByZ(double value)
      Sets the value of the byZ property.
      Property description:
      Specifies the incremented stop Z coordinate value, from the start, of this TranslateTransition.

      It is not possible to change byZ of a running TranslateTransition. If the value of byZ is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Parameters:
      value - the value for the byZ property
      See Also:
    • getByZ

      public final double getByZ()
      Gets the value of the byZ property.
      Property description:
      Specifies the incremented stop Z coordinate value, from the start, of this TranslateTransition.

      It is not possible to change byZ of a running TranslateTransition. If the value of byZ is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Returns:
      the value of the byZ property
      See Also:
    • byZProperty

      public final DoubleProperty byZProperty()
      Specifies the incremented stop Z coordinate value, from the start, of this TranslateTransition.

      It is not possible to change byZ of a running TranslateTransition. If the value of byZ is changed for a running TranslateTransition, the animation has to be stopped and started again to pick up the new value.

      Returns:
      the byZ property
      See Also:
    • interpolate

      public 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