PathTransition

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

public final class PathTransition
extends Transition

Этот Transition создаёт анимацию по пути, которая охватывает весь свой период duration. Перемещение по пути происходит путём обновления переменных translateX и translateY у node, а переменная rotate будет обновляться, если orientation установлено в значение OrientationType.ORTHOGONAL_TO_TANGENT, с регулярными интервалами.

Анимируемый путь определяется контуром фигуры.

Пример фрагмента кода:

 
 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);


     Path path = new Path();
     path.getElements().add (new MoveTo (0f, 50f));
     path.getElements().add (new CubicCurveTo (40f, 10f, 390f, 240f, 1904, 50f));

     pathTransition.setDuration(Duration.millis(10000));
     pathTransition.setNode(rect);
     pathTransition.setPath(path);
     pathTransition.setOrientation(OrientationType.ORTHOGONAL_TO_TANGENT);
     pathTransition.setCycleCount(4f);
     pathTransition.setAutoReverse(true);

     pathTransition.play();

 ...

Since:: JavaFX 2.0
См. также:: Transition, Animation

Краткое описание свойств

Свойства
Тип	Свойство	Описание
`ObjectProperty<Duration>`	`duration`	Продолжительность этого `Transition`.
`ObjectProperty<Node>`	`node`	Целевой узел этого `PathTransition`.
`ObjectProperty<PathTransition.OrientationType>`	`orientation`	Устанавливает вертикальную ориентацию `node` вдоль `path`.
`ObjectProperty<Shape>`	`path`	Фигура, контур которой будет анимирован узел.

Свойства, унаследованные от класса javafx.animation.Transition
interpolator

Свойства, унаследованные от класса javafx.animation.Animation
autoReverse, currentRate, currentTime, cycleCount, cycleDuration, delay, onFinished, rate, status, totalDuration

Краткое описание вложенных классов

Вложенные классы
Модификатор и тип	Класс	Описание
`static class`	`PathTransition.OrientationType`	Устанавливает вертикальную ориентацию `node` вдоль `path`.

Вложенные классы/интерфейсы, унаследованные от класса javafx.animation.Animation
Animation.Status

Краткое описание полей
- Поля, унаследованные от класса javafx.animation.Animation
  INDEFINITE

Краткое описание конструкторов

Конструкторы
Конструктор	Описание
`PathTransition()`	Конструктор `PathTransition`.
`PathTransition(Duration duration, Shape path)`	Конструктор `PathTransition`.
`PathTransition(Duration duration, Shape path, Node node)`	Конструктор `PathTransition`.

Краткое описание методов

Все методыМетоды экземпляровКонкретные методы
Модификатор и тип	Метод	Описание
`ObjectProperty<Duration>`	`durationProperty()`	Продолжительность этого `Transition`.
`Duration`	`getDuration()`	Получает значение свойства duration.
`Node`	`getNode()`	Получает значение свойства node.
`PathTransition.OrientationType`	`getOrientation()`	Получает значение свойства orientation.
`Shape`	`getPath()`	Получает значение свойства path.
`void`	`interpolate(double frac)`	Метод `interpolate()` должен быть предоставлен реализациями `Transition`.
`ObjectProperty<Node>`	`nodeProperty()`	Целевой узел этого `PathTransition`.
`ObjectProperty<PathTransition.OrientationType>`	`orientationProperty()`	Устанавливает вертикальную ориентацию `node` вдоль `path`.
`ObjectProperty<Shape>`	`pathProperty()`	Фигура, контур которой будет анимирован узел.
`void`	`setDuration(Duration value)`	Устанавливает значение свойства duration.
`void`	`setNode(Node value)`	Устанавливает значение свойства node.
`void`	`setOrientation(PathTransition.OrientationType value)`	Устанавливает значение свойства orientation.
`void`	`setPath(Shape value)`	Устанавливает значение свойства path.

Методы, унаследованные от класса javafx.animation.Transition
getCachedInterpolator, getInterpolator, getParentTargetNode, interpolatorProperty, setInterpolator

Методы, унаследованные от класса 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

Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробности свойств
- node
```
public final ObjectProperty<Node> nodeProperty
```
  Узел назначения данного PathTransition.
  Невозможно изменить целевой node работающего PathTransition. Если значение node изменяется для работающего PathTransition, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.
  
  См. также:
  
  getNode(), setNode(Node)
- duration
```
public final ObjectProperty<Duration> durationProperty
```
  Длительность данного Transition.
  Невозможно изменить длительность duration работающего PathTransition. Если значение duration изменяется для работающего PathTransition, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.
  
  Примечание: Хотя единица измерения duration — миллисекунда, точность зависит от базовой операционной системы и, как правило, будет больше. Например, анимации на настольных системах обычно выполняются с максимальной частотой 60 кадров в секунду, что обеспечивает точность ~17 мс. Установка длительности на значение меньше Duration.ZERO приведет к IllegalArgumentException.
  
  Значение по умолчанию:
  
  400 мс
  
  См. также:
  
  getDuration(), setDuration(Duration)
- path
```
public final ObjectProperty<Shape> pathProperty
```
  Фигура, по которой должен анимироваться контур узла.
  Невозможно изменить path работающего PathTransition. Если значение path изменяется для работающего PathTransition, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.
  
  Значение по умолчанию:
  
  null
  
  См. также:
  
  getPath(), setPath(Shape)
- orientation
```
public final ObjectProperty<PathTransition.OrientationType> orientationProperty
```
  Определяет вертикальную ориентацию node вдоль path. По умолчанию ориентация установлена в PathTransition.OrientationType.NONE.
  Невозможно изменить orientation работающего PathTransition. Если значение orientation изменяется для работающего PathTransition, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.
  
  Значение по умолчанию:
  
  NONE
  
  См. также:
  
  getOrientation(), setOrientation(PathTransition.OrientationType)

Подробности конструкторов
- PathTransition
```
public PathTransition(Duration duration,
                      Shape path,
                      Node node)
```
  Конструктор PathTransition.
  
  Параметры:
  
  duration - duration этого PathTransition
  
  path - path этого PathTransition
  
  node - node этого PathTransition
- PathTransition
```
public PathTransition(Duration duration,
                      Shape path)
```
  Конструктор PathTransition.
  
  Параметры:
  
  duration - duration этого PathTransition
  
  path - path этого PathTransition
- PathTransition
```
public PathTransition()
```
  Конструктор PathTransition.

Методы
- setNode
```
public final void setNode(Node value)
```
  Устанавливает значение свойства node.
  
  Описание свойства:
  
  Целевой узел этого PathTransition.
  Невозможно изменить целевой node выполняющейся анимации PathTransition. Если значение node изменяется для выполняющейся анимации PathTransition, анимацию необходимо остановить и запустить снова, чтобы она приняла новое значение.
- getNode
```
public final Node getNode()
```
  Возвращает значение свойства node.
  
  Описание свойства:
  
  Целевой узел этого PathTransition.
  Невозможно изменить целевой node выполняющейся анимации PathTransition. Если значение node изменяется для выполняющейся анимации PathTransition, анимацию необходимо остановить и запустить снова, чтобы она приняла новое значение.
- nodeProperty
```
public final ObjectProperty<Node> nodeProperty()
```
  Целевой узел этого PathTransition.
  Невозможно изменить целевой node выполняющейся анимации PathTransition. Если значение node изменяется для выполняющейся анимации PathTransition, анимацию необходимо остановить и запустить снова, чтобы она приняла новое значение.
  
  См. также:
  
  getNode(), setNode(Node)
- setDuration
```
public final void setDuration(Duration value)
```
  Устанавливает значение свойства duration.
  
  Описание свойства:
  
  Продолжительность этой анимации Transition.
  Невозможно изменить duration выполняющейся анимации PathTransition. Если значение duration изменяется для выполняющейся анимации PathTransition, анимацию необходимо остановить и запустить снова, чтобы она приняла новое значение.
  
  Примечание: Хотя единица измерения duration — миллисекунда, точность зависит от базовой операционной системы и, как правило, выше. Например, анимации на настольных системах обычно выполняются с максимальной частотой 60 кадров в секунду, что даёт точность около 17 мс. Установка продолжительности ниже Duration.ZERO приведёт к IllegalArgumentException.
  
  Значение по умолчанию:
  
  400мс
- getDuration
```
public final Duration getDuration()
```
  Возвращает значение свойства duration.
  
  Описание свойства:
  
  Продолжительность этой анимации Transition.
  Невозможно изменить duration выполняющейся анимации PathTransition. Если значение duration изменяется для выполняющейся анимации PathTransition, анимацию необходимо остановить и запустить снова, чтобы она приняла новое значение.
  
  Примечание: Хотя единица измерения duration — миллисекунда, точность зависит от базовой операционной системы и, как правило, выше. Например, анимации на настольных системах обычно выполняются с максимальной частотой 60 кадров в секунду, что даёт точность около 17 мс. Установка продолжительности ниже Duration.ZERO приведёт к IllegalArgumentException.
  
  Значение по умолчанию:
  
  400мс
- durationProperty
```
public final ObjectProperty<Duration> durationProperty()
```
  Продолжительность этой анимации Transition.
  Невозможно изменить duration выполняющейся анимации PathTransition. Если значение duration изменяется для выполняющейся анимации PathTransition, анимацию необходимо остановить и запустить снова, чтобы она приняла новое значение.
  
  Примечание: Хотя единица измерения duration — миллисекунда, точность зависит от базовой операционной системы и, как правило, выше. Например, анимации на настольных системах обычно выполняются с максимальной частотой 60 кадров в секунду, что даёт точность около 17 мс. Установка продолжительности ниже Duration.ZERO приведёт к IllegalArgumentException.
  
  Значение по умолчанию:
  
  400мс
  
  См. также:
  
  getDuration(), setDuration(Duration)
- setPath
```
public final void setPath(Shape value)
```
  Устанавливает значение свойства path.
  
  Описание свойства:
  
  Фигура, по которой должен анимироваться контур узла.
  Невозможно изменить path выполняющейся анимации PathTransition. Если значение path изменяется для выполняющейся анимации PathTransition, анимацию необходимо остановить и запустить снова, чтобы она приняла новое значение.
  
  Значение по умолчанию:
  
  null
- getPath
```
public final Shape getPath()
```
  Возвращает значение свойства path.
  
  Описание свойства:
  
  Фигура, по которой должен анимироваться контур узла.
  Невозможно изменить path выполняющейся анимации PathTransition. Если значение path изменяется для выполняющейся анимации PathTransition, анимацию необходимо остановить и запустить снова, чтобы она приняла новое значение.
  
  Значение по умолчанию:
  
  null
- pathProperty
```
public final ObjectProperty<Shape> pathProperty()
```
  Фигура, по которой должен анимироваться контур узла.
  Невозможно изменить path выполняющейся анимации PathTransition. Если значение path изменяется для выполняющейся анимации PathTransition, анимацию необходимо остановить и запустить снова, чтобы она приняла новое значение.
  
  Значение по умолчанию:
  
  null
  
  См. также:
  
  getPath(), setPath(Shape)
- setOrientation
```
public final void setOrientation(PathTransition.OrientationType value)
```
  Устанавливает значение свойства orientation.
  
  Описание свойства:
  
  Определяет вертикальную ориентацию node вдоль path. По умолчанию установлено значение PathTransition.OrientationType.NONE.
  Невозможно изменить orientation выполняющейся анимации PathTransition. Если значение orientation изменяется для выполняющейся анимации PathTransition, анимацию необходимо остановить и запустить снова, чтобы она приняла новое значение.
  
  Значение по умолчанию:
  
  NONE
- getOrientation
```
public final PathTransition.OrientationType getOrientation()
```
  Возвращает значение свойства orientation.
  
  Описание свойства:
  
  Определяет вертикальную ориентацию node вдоль path. По умолчанию установлено значение PathTransition.OrientationType.NONE.
  Невозможно изменить orientation выполняющейся анимации PathTransition. Если значение orientation изменяется для выполняющейся анимации PathTransition, анимацию необходимо остановить и запустить снова, чтобы она приняла новое значение.
  
  Значение по умолчанию:
  
  NONE
- orientationProperty
```
public final ObjectProperty<PathTransition.OrientationType> orientationProperty()
```
  Определяет вертикальную ориентацию node вдоль path. По умолчанию установлено значение PathTransition.OrientationType.NONE.
  Невозможно изменить orientation выполняющейся анимации PathTransition. Если значение orientation изменяется для выполняющейся анимации PathTransition, анимацию необходимо остановить и запустить снова, чтобы она приняла новое значение.
  
  Значение по умолчанию:
  
  NONE
  
  См. также:
  
  getOrientation(), setOrientation(PathTransition.OrientationType)
- interpolate
```
public void interpolate(double frac)
```
  Метод interpolate() должен быть предоставлен реализациями Transition. Во время выполнения анимации Transition этот метод вызывается в каждом кадре. Параметр определяет текущее положение в анимации. В начале анимации дробь будет 0.0, а в конце — 1.0. Как увеличивается параметр, зависит от interpolator, например, если интерполятор interpolator равен Interpolator.LINEAR, дробь будет увеличиваться линейно. Этот метод не должен вызываться пользователем напрямую.
  
  Унаследованно от:
  
  interpolate в классе Transition
  
  Параметры:
  
  frac - Относительное положение

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Класс PathTransition

Краткое описание свойств

Свойства, унаследованные от класса javafx.animation.Transition

Свойства, унаследованные от класса javafx.animation.Animation

Краткое описание вложенных классов

Вложенные классы/интерфейсы, унаследованные от класса javafx.animation.Animation

Краткое описание полей

Поля, унаследованные от класса javafx.animation.Animation

Краткое описание конструкторов

Краткое описание методов

Методы, унаследованные от класса javafx.animation.Transition

Методы, унаследованные от класса javafx.animation.Animation

Методы, унаследованные от класса java.lang.Object

Подробности свойств

node

duration

path

orientation

Подробности конструкторов

PathTransition

PathTransition

Методы

setNode

getNode

nodeProperty

setDuration

getDuration

durationProperty

setPath

getPath

pathProperty

setOrientation

getOrientation

orientationProperty

interpolate