Класс 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

См. также:

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

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

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

Animation.Status

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

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

Свойства, объявленные в классе javafx.animation.Transition

interpolator

Свойства, объявленные в классе javafx.animation.Animation

autoReverse, currentRate, currentTime, cycleCount, cycleDuration, delay, onFinished, rate, status, totalDuration

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

Поля, объявленные в классе javafx.animation.Animation

INDEFINITE

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

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

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

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

См. также:

duration

public final ObjectProperty<Duration> durationProperty

Продолжительность данного Transition.

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

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

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

400 мс

См. также:

path

public final ObjectProperty<Shape> pathProperty

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

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

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

null

См. также:

orientation

public final ObjectProperty<PathTransition.OrientationType> orientationProperty

Устанавливает вертикальное направление node вдоль path. Значение по умолчанию - PathTransition.OrientationType.NONE.

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

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

NONE

См. также:

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

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.

Параметры:

value - значение для свойства node

См. также:

getNode

public final Node getNode()

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

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

Целевой узел данного PathTransition.

Возвращает:

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

См. также:

nodeProperty

public final ObjectProperty<Node> nodeProperty()

Целевой узел данного PathTransition.

Возвращает:

свойство node

См. также:

setDuration

public final void setDuration(Duration value)

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

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

Продолжительность данного Transition.

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

400 мс

Параметры:

value - значение для свойства duration

См. также:

getDuration

public final Duration getDuration()

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

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

Продолжительность данного Transition.

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

400 мс

Возвращает:

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

См. также:

durationProperty

public final ObjectProperty<Duration> durationProperty()

Продолжительность этого Transition.

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

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

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

400мс

Возвращает:

свойство duration

См. также:

setPath

public final void setPath(Shape value)

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

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

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

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

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

null

Параметры:

value - значение для свойства path

См. также:

getPath

public final Shape getPath()

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

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

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

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

null

Возвращает:

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

См. также:

pathProperty

public final ObjectProperty<Shape> pathProperty()

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

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

null

Возвращает:

свойство path

См. также:

setOrientation

public final void setOrientation(PathTransition.OrientationType value)

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

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

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

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

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

NONE

Параметры:

value - значение для свойства orientation

См. также:

getOrientation

public final PathTransition.OrientationType getOrientation()

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

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

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

NONE

Возвращает:

значение свойства orientation

См. также:

orientationProperty

public final ObjectProperty<PathTransition.OrientationType> orientationProperty()

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

NONE

Возвращает:

свойство orientation

См. также:

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.