Spec-Zone.ru › OpenJavaFX 21

Класс 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
See Also:
  • Transition
  • Animation

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

Тип Свойство Описание
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

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

Модификатор и тип Класс Описание
static enum  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.

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

Модификатор и тип Метод Описание
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, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.

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

duration

public final ObjectProperty<Duration> durationProperty
Продолжительность этой Transition.

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

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

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

path

public final ObjectProperty<Shape> pathProperty
Фигура, по которой должен анимироваться контур узла.

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

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

orientation

public final ObjectProperty<PathTransition.OrientationType> orientationProperty
Указывает прямое направление node вдоль path. По умолчанию ориентация задана как PathTransition.OrientationType.NONE.

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

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

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

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, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.

Параметры:
value - значение для свойства node
См. также:
  • getNode()
  • nodeProperty()

getNode

public final Node getNode()
Получает значение свойства node.
Описание свойства:
Целевой узел этого PathTransition.

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

Возвращает:
значение свойства node
См. также:
  • setNode(Node)
  • nodeProperty()

nodeProperty

public final ObjectProperty<Node> nodeProperty()
Целевой узел этого PathTransition.

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

Возвращает:
свойство node
См. также:
  • getNode()
  • setNode(Node)

setDuration

public final void setDuration(Duration value)
Устанавливает значение свойства duration.
Описание свойства:
Продолжительность этой Transition.

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

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

Значение по умолчанию:
400мс
Параметры:
value - значение для свойства duration
См. также:
  • getDuration()
  • durationProperty()

getDuration

public final Duration getDuration()
Получает значение свойства duration.
Описание свойства:
Продолжительность этой Transition.

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

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

Значение по умолчанию:
400мс
Возвращает:
значение свойства duration
См. также:
  • setDuration(Duration)
  • durationProperty()

durationProperty

public final ObjectProperty<Duration> durationProperty()
Продолжительность этого Transition.

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

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

Значение по умолчанию:
400мс
Возвращает:
свойство duration
См. также:
  • getDuration()
  • setDuration(Duration)

setPath

public final void setPath(Shape value)
Устанавливает значение свойства path.
Описание свойства:
Фигура, по контуру которой должна быть анимирована нода.

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

Значение по умолчанию:
null
Параметры:
value - значение для свойства path
См. также:
  • getPath()
  • pathProperty()

getPath

public final Shape getPath()
Получает значение свойства path.
Описание свойства:
Фигура, по контуру которой должна быть анимирована нода.

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

Значение по умолчанию:
null
Возвращает:
значение свойства path
См. также:
  • setPath(Shape)
  • pathProperty()

pathProperty

public final ObjectProperty<Shape> pathProperty()
Фигура, по контуру которой должна быть анимирована нода.

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

Значение по умолчанию:
null
Возвращает:
свойство path
См. также:
  • getPath()
  • setPath(Shape)

setOrientation

public final void setOrientation(PathTransition.OrientationType value)
Устанавливает значение свойства orientation.
Описание свойства:
Определяет вертикальную ориентацию node вдоль path. По умолчанию ориентация установлена в PathTransition.OrientationType.NONE.

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

Значение по умолчанию:
NONE
Параметры:
value - значение для свойства orientation
См. также:
  • getOrientation()
  • orientationProperty()

getOrientation

public final PathTransition.OrientationType getOrientation()
Получает значение свойства orientation.
Описание свойства:
Определяет вертикальную ориентацию node вдоль path. По умолчанию ориентация установлена в PathTransition.OrientationType.NONE.

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

Значение по умолчанию:
NONE
Возвращает:
значение свойства orientation
См. также:
  • setOrientation(PathTransition.OrientationType)
  • orientationProperty()

orientationProperty

public final ObjectProperty<PathTransition.OrientationType> orientationProperty()
Определяет вертикальную ориентацию node вдоль path. По умолчанию ориентация установлена в PathTransition.OrientationType.NONE.

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

Значение по умолчанию:
NONE
Возвращает:
свойство orientation
См. также:
  • 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API