ScaleTransition (JavaFX 17)

Module javafx.graphics
Package javafx.animation

## Class ScaleTransition

- java.lang.Object
- - javafx.animation.Animation
  - - javafx.animation.Transition
    - - javafx.animation.ScaleTransition

-     public final class ScaleTransition
      extends Transition

  This `Transition` creates a scale animation that spans its `duration`. This is done by updating the `scaleX`, `scaleY` and `scaleZ` variables of the `node` at regular interval.

  It starts from the (`fromX`, `fromY`, `fromZ`) value if provided else uses the `node`'s (`scaleX`, `scaleY`, `scaleZ`) 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);

           ScaleTransition st = new ScaleTransition(Duration.millis(2000), rect);
           st.setByX(1.5f);
           st.setByY(1.5f);
           st.setCycleCount(4f);
           st.setAutoReverse(true);

           st.play();

       ...

  Since:
    JavaFX 2.0
  See Also:
    `Transition`, `Animation`

- - ### Property Summary

    Properties
    Type | Property | Description
    --- | --- | ---
    `DoubleProperty` | `byX` | Specifies the incremented stop X scale value, from the start, of this `ScaleTransition`.
    `DoubleProperty` | `byY` | Specifies the incremented stop Y scale value, from the start, of this `ScaleTransition`.
    `DoubleProperty` | `byZ` | Specifies the incremented stop Z scale value, from the start, of this `ScaleTransition`.
    `ObjectProperty<Duration>` | `duration` | The duration of this `ScaleTransition`.
    `DoubleProperty` | `fromX` | Specifies the start X scale value of this `ScaleTransition`.
    `DoubleProperty` | `fromY` | Specifies the start Y scale value of this `ScaleTransition`.
    `DoubleProperty` | `fromZ` | Specifies the start Z scale value of this `ScaleTransition`.
    `ObjectProperty<Node>` | `node` | The target node of this `ScaleTransition`.
    `DoubleProperty` | `toX` | Specifies the stop X scale value of this `ScaleTransition`.
    `DoubleProperty` | `toY` | The stop Y scale value of this `ScaleTransition`.
    `DoubleProperty` | `toZ` | The stop Z scale value of this `ScaleTransition`.

    - ### 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

    Constructors
    Constructor | Description
    --- | ---
    `ScaleTransition()` | The constructor of `ScaleTransition`
    `ScaleTransition​(Duration duration)` | The constructor of `ScaleTransition`
    `ScaleTransition​(Duration duration, Node node)` | The constructor of `ScaleTransition`

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `DoubleProperty` | `byXProperty()` | Specifies the incremented stop X scale value, from the start, of this `ScaleTransition`.
    `DoubleProperty` | `byYProperty()` | Specifies the incremented stop Y scale value, from the start, of this `ScaleTransition`.
    `DoubleProperty` | `byZProperty()` | Specifies the incremented stop Z scale value, from the start, of this `ScaleTransition`.
    `ObjectProperty<Duration>` | `durationProperty()` | The duration of this `ScaleTransition`.
    `DoubleProperty` | `fromXProperty()` | Specifies the start X scale value of this `ScaleTransition`.
    `DoubleProperty` | `fromYProperty()` | Specifies the start Y scale value of this `ScaleTransition`.
    `DoubleProperty` | `fromZProperty()` | Specifies the start Z scale value of this `ScaleTransition`.
    `double` | `getByX()` | Gets the value of the property byX.
    `double` | `getByY()` | Gets the value of the property byY.
    `double` | `getByZ()` | Gets the value of the property byZ.
    `Duration` | `getDuration()` | Gets the value of the property duration.
    `double` | `getFromX()` | Gets the value of the property fromX.
    `double` | `getFromY()` | Gets the value of the property fromY.
    `double` | `getFromZ()` | Gets the value of the property fromZ.
    `Node` | `getNode()` | Gets the value of the property node.
    `double` | `getToX()` | Gets the value of the property toX.
    `double` | `getToY()` | Gets the value of the property toY.
    `double` | `getToZ()` | Gets the value of the property toZ.
    `ObjectProperty<Node>` | `nodeProperty()` | The target node of this `ScaleTransition`.
    `void` | `setByX​(double value)` | Sets the value of the property byX.
    `void` | `setByY​(double value)` | Sets the value of the property byY.
    `void` | `setByZ​(double value)` | Sets the value of the property byZ.
    `void` | `setDuration​(Duration value)` | Sets the value of the property duration.
    `void` | `setFromX​(double value)` | Sets the value of the property fromX.
    `void` | `setFromY​(double value)` | Sets the value of the property fromY.
    `void` | `setFromZ​(double value)` | Sets the value of the property fromZ.
    `void` | `setNode​(Node value)` | Sets the value of the property node.
    `void` | `setToX​(double value)` | Sets the value of the property toX.
    `void` | `setToY​(double value)` | Sets the value of the property toY.
    `void` | `setToZ​(double value)` | Sets the value of the property toZ.
    `DoubleProperty` | `toXProperty()` | Specifies the stop X scale value of this `ScaleTransition`.
    `DoubleProperty` | `toYProperty()` | The stop Y scale value of this `ScaleTransition`.
    `DoubleProperty` | `toZProperty()` | The stop Z scale value of this `ScaleTransition`.

    - ### Methods declared in class javafx.animation.Transition

      `getCachedInterpolator, getInterpolator, getParentTargetNode, interpolate, 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`

    - ### Methods declared in class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Property Detail

    - #### node

          public final ObjectProperty<Node> nodeProperty

      The target node of this `ScaleTransition`.

      It is not possible to change the target `node` of a running `ScaleTransition`. If the value of `node` is changed for a running `ScaleTransition`, 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 `ScaleTransition`.

      It is not possible to change the `duration` of a running `ScaleTransition`. If the value of `duration` is changed for a running `ScaleTransition`, 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)`

    - #### fromX

          public final DoubleProperty fromXProperty

      Specifies the start X scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`
      See Also:
        `getFromX()`, `setFromX(double)`

    - #### fromY

          public final DoubleProperty fromYProperty

      Specifies the start Y scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`
      See Also:
        `getFromY()`, `setFromY(double)`

    - #### fromZ

          public final DoubleProperty fromZProperty

      Specifies the start Z scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`
      See Also:
        `getFromZ()`, `setFromZ(double)`

    - #### toX

          public final DoubleProperty toXProperty

      Specifies the stop X scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`
      See Also:
        `getToX()`, `setToX(double)`

    - #### toY

          public final DoubleProperty toYProperty

      The stop Y scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`
      See Also:
        `getToY()`, `setToY(double)`

    - #### toZ

          public final DoubleProperty toZProperty

      The stop Z scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`
      See Also:
        `getToZ()`, `setToZ(double)`

    - #### byX

          public final DoubleProperty byXProperty

      Specifies the incremented stop X scale value, from the start, of this `ScaleTransition`.

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

      See Also:
        `getByX()`, `setByX(double)`

    - #### byY

          public final DoubleProperty byYProperty

      Specifies the incremented stop Y scale value, from the start, of this `ScaleTransition`.

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

      See Also:
        `getByY()`, `setByY(double)`

    - #### byZ

          public final DoubleProperty byZProperty

      Specifies the incremented stop Z scale value, from the start, of this `ScaleTransition`.

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

      See Also:
        `getByZ()`, `setByZ(double)`

  - ### Constructor Detail

    - #### ScaleTransition

          public ScaleTransition​(Duration duration,
                                 Node node)

      The constructor of `ScaleTransition`
      Parameters:
        `duration` - The duration of the `ScaleTransition`
        `node` - The `node` which will be scaled

    - #### ScaleTransition

          public ScaleTransition​(Duration duration)

      The constructor of `ScaleTransition`
      Parameters:
        `duration` - The duration of the `ScaleTransition`

    - #### ScaleTransition

          public ScaleTransition()

      The constructor of `ScaleTransition`

  - ### Method Detail

    - #### setNode

          public final void setNode​(Node value)

      Sets the value of the property node.
      Property description:
        The target node of this `ScaleTransition`.

        It is not possible to change the target `node` of a running `ScaleTransition`. If the value of `node` is changed for a running `ScaleTransition`, 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 `ScaleTransition`.

        It is not possible to change the target `node` of a running `ScaleTransition`. If the value of `node` is changed for a running `ScaleTransition`, 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 `ScaleTransition`.

      It is not possible to change the target `node` of a running `ScaleTransition`. If the value of `node` is changed for a running `ScaleTransition`, 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 `ScaleTransition`.

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

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

      It is not possible to change the `duration` of a running `ScaleTransition`. If the value of `duration` is changed for a running `ScaleTransition`, 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)`

    - #### setFromX

          public final void setFromX​(double value)

      Sets the value of the property fromX.
      Property description:
        Specifies the start X scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`

    - #### getFromX

          public final double getFromX()

      Gets the value of the property fromX.
      Property description:
        Specifies the start X scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`

    - #### fromXProperty

          public final DoubleProperty fromXProperty()

      Specifies the start X scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`
      See Also:
        `getFromX()`, `setFromX(double)`

    - #### setFromY

          public final void setFromY​(double value)

      Sets the value of the property fromY.
      Property description:
        Specifies the start Y scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`

    - #### getFromY

          public final double getFromY()

      Gets the value of the property fromY.
      Property description:
        Specifies the start Y scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`

    - #### fromYProperty

          public final DoubleProperty fromYProperty()

      Specifies the start Y scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`
      See Also:
        `getFromY()`, `setFromY(double)`

    - #### setFromZ

          public final void setFromZ​(double value)

      Sets the value of the property fromZ.
      Property description:
        Specifies the start Z scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`

    - #### getFromZ

          public final double getFromZ()

      Gets the value of the property fromZ.
      Property description:
        Specifies the start Z scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`

    - #### fromZProperty

          public final DoubleProperty fromZProperty()

      Specifies the start Z scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`
      See Also:
        `getFromZ()`, `setFromZ(double)`

    - #### setToX

          public final void setToX​(double value)

      Sets the value of the property toX.
      Property description:
        Specifies the stop X scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`

    - #### getToX

          public final double getToX()

      Gets the value of the property toX.
      Property description:
        Specifies the stop X scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`

    - #### toXProperty

          public final DoubleProperty toXProperty()

      Specifies the stop X scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`
      See Also:
        `getToX()`, `setToX(double)`

    - #### setToY

          public final void setToY​(double value)

      Sets the value of the property toY.
      Property description:
        The stop Y scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`

    - #### getToY

          public final double getToY()

      Gets the value of the property toY.
      Property description:
        The stop Y scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`

    - #### toYProperty

          public final DoubleProperty toYProperty()

      The stop Y scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`
      See Also:
        `getToY()`, `setToY(double)`

    - #### setToZ

          public final void setToZ​(double value)

      Sets the value of the property toZ.
      Property description:
        The stop Z scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`

    - #### getToZ

          public final double getToZ()

      Gets the value of the property toZ.
      Property description:
        The stop Z scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`

    - #### toZProperty

          public final DoubleProperty toZProperty()

      The stop Z scale value of this `ScaleTransition`.

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

      Default value:
        `Double.NaN`
      See Also:
        `getToZ()`, `setToZ(double)`

    - #### setByX

          public final void setByX​(double value)

      Sets the value of the property byX.
      Property description:
        Specifies the incremented stop X scale value, from the start, of this `ScaleTransition`.

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

    - #### getByX

          public final double getByX()

      Gets the value of the property byX.
      Property description:
        Specifies the incremented stop X scale value, from the start, of this `ScaleTransition`.

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

    - #### byXProperty

          public final DoubleProperty byXProperty()

      Specifies the incremented stop X scale value, from the start, of this `ScaleTransition`.

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

      See Also:
        `getByX()`, `setByX(double)`

    - #### setByY

          public final void setByY​(double value)

      Sets the value of the property byY.
      Property description:
        Specifies the incremented stop Y scale value, from the start, of this `ScaleTransition`.

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

    - #### getByY

          public final double getByY()

      Gets the value of the property byY.
      Property description:
        Specifies the incremented stop Y scale value, from the start, of this `ScaleTransition`.

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

    - #### byYProperty

          public final DoubleProperty byYProperty()

      Specifies the incremented stop Y scale value, from the start, of this `ScaleTransition`.

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

      See Also:
        `getByY()`, `setByY(double)`

    - #### setByZ

          public final void setByZ​(double value)

      Sets the value of the property byZ.
      Property description:
        Specifies the incremented stop Z scale value, from the start, of this `ScaleTransition`.

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

    - #### getByZ

          public final double getByZ()

      Gets the value of the property byZ.
      Property description:
        Specifies the incremented stop Z scale value, from the start, of this `ScaleTransition`.

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

    - #### byZProperty

          public final DoubleProperty byZProperty()

      Specifies the incremented stop Z scale value, from the start, of this `ScaleTransition`.

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

      See Also:
        `getByZ()`, `setByZ(double)`