Класс PathTransition

javafx.animation.PathTransition

public final class PathTransition
extends 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`	Продолжительность этой анимации.
`ObjectProperty<Node>`	`node`	Целевой узел этой анимации.
`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()`	Продолжительность этой анимации.
`Duration`	`getDuration()`	Возвращает значение свойства duration.
`Node`	`getNode()`	Возвращает значение свойства node.
`PathTransition.OrientationType`	`getOrientation()`	Возвращает значение свойства orientation.
`Shape`	`getPath()`	Возвращает значение свойства path.
`ObjectProperty<Node>`	`nodeProperty()`	Целевой узел этой анимации.
`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, interpolate, 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

Целевой узел этой анимации.

Невозможно изменить целевой узел во время выполнения анимации. Если значение узла изменяется для выполняющейся анимации, необходимо остановить и перезапустить анимацию, чтобы она приняла новое значение.

См. также:: getNode(), setNode(Node)

duration

public final ObjectProperty<Duration> durationProperty

Продолжительность этой анимации.

Невозможно изменить продолжительность во время выполнения анимации. Если значение продолжительности изменяется для выполняющейся анимации, необходимо остановить и перезапустить анимацию, чтобы она приняла новое значение.

Примечание: хотя единицей измерения продолжительности является миллисекунда, точность зависит от базовой операционной системы и, как правило, будет больше. Например, анимации на настольных системах обычно выполняются с максимальной частотой 60 кадров в секунду, что дает точность ~17 мс. Установка продолжительности значения меньше Duration.ZERO приведет к IllegalArgumentException.

Значение по умолчанию:: 400мс
См. также:: getDuration(), setDuration(Duration)

path

public final ObjectProperty<Shape> pathProperty

Форма, по которой должен анимироваться контур узла.

Невозможно изменить траекторию во время выполнения анимации. Если значение траектории изменяется для выполняющейся анимации, необходимо остановить и перезапустить анимацию, чтобы она приняла новое значение.

Значение по умолчанию:: null
См. также:: getPath(), setPath(Shape)

orientation

public final ObjectProperty<PathTransition.OrientationType> orientationProperty

Определяет вертикальную ориентацию узла вдоль траектории. По умолчанию ориентация установлена в PathTransition.OrientationType.NONE.

Невозможно изменить ориентацию во время выполнения анимации. Если значение ориентации изменяется для выполняющейся анимации, необходимо остановить и перезапустить анимацию, чтобы она приняла новое значение.

Значение по умолчанию:: NONE
См. также:: getOrientation(), setOrientation(PathTransition.OrientationType)

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

PathTransition

public PathTransition(Duration duration, Shape path, Node node)

Конструктор класса PathTransition.

Параметры:: duration - Продолжительность этой анимации; path - Форма, по которой должен анимироваться контур узла; node - Целевой узел этой анимации

PathTransition

public PathTransition(Duration duration, Shape path)

Конструктор класса PathTransition.

Параметры:: duration - Продолжительность этой анимации; path - Форма, по которой должен анимироваться контур узла

PathTransition

public PathTransition()

Конструктор класса PathTransition.

Подробное описание методов

setNode

public final void setNode(Node value)

Устанавливает значение свойства node.

Описание свойства:: Целевой узел этой анимации.
Невозможно изменить целевой узел во время выполнения анимации. Если значение узла изменяется для выполняющейся анимации, необходимо остановить и перезапустить анимацию, чтобы она приняла новое значение.

getNode

public final Node getNode()

Получает значение свойства node.

Описание свойства:: Целевой узел этой анимации.
Невозможно изменить целевой узел во время выполнения анимации. Если значение узла изменяется для выполняющейся анимации, необходимо остановить и перезапустить анимацию, чтобы она приняла новое значение.

nodeProperty

public final ObjectProperty<Node> nodeProperty()

Целевой узел этой анимации.

См. также:: getNode(), setNode(Node)

setDuration

public final void setDuration(Duration value)

Устанавливает значение свойства duration.

Описание свойства:

Продолжительность этой анимации.

Значение по умолчанию:

400мс

getDuration

public final Duration getDuration()

Получает значение свойства duration.

Описание свойства:

Продолжительность этой анимации.

Значение по умолчанию:

400мс

durationProperty

public final ObjectProperty<Duration> durationProperty()

Продолжительность этой анимации.

Значение по умолчанию:: 400мс
См. также:: getDuration(), setDuration(Duration)

setPath

public final void setPath(Shape value)

Устанавливает значение свойства path.

Описание свойства:: Форма, по которой должен анимироваться контур узла.
Невозможно изменить траекторию во время выполнения анимации. Если значение траектории изменяется для выполняющейся анимации, необходимо остановить и перезапустить анимацию, чтобы она приняла новое значение.
Значение по умолчанию:: 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)

© 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.