PathTransition

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

public final class PathTransition
extends Transition

This Transition creates a path animation that spans its duration. The translation along the path is done by updating the translateX and translateY variables of the node, and the rotate variable will get updated if orientation is set to OrientationType.ORTHOGONAL_TO_TANGENT, at regular interval.

The animated path is defined by the outline of a shape.

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


     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

Property Summary

All Methods Instance Methods Concrete Methods
Type	Property and Description
`<any>`	`duration` The duration of this `Transition`.
`<any>`	`node` The target node of this `PathTransition`.
`<any>`	`orientation` Specifies the upright orientation of `node` along the `path`.
`<any>`	`path` The shape on which outline the node should be animated.

Properties inherited from class javafx.animation.Transition
interpolatorProperty

Properties inherited from class javafx.animation.Animation
autoReverseProperty, currentRateProperty, currentTimeProperty, cycleCountProperty, cycleDurationProperty, delayProperty, onFinishedProperty, rateProperty, statusProperty, totalDurationProperty

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`PathTransition.OrientationType` Specifies the upright orientation of `node` along the `path`.
`private static class`	`PathTransition.Segment`

Nested classes/interfaces inherited from class javafx.animation.Animation
Animation.Status

Field Summary

Fields
Modifier and Type	Field and Description
`private boolean`	`cachedIsNormalRequired`
`private Node`	`cachedNode`
`private static Duration`	`DEFAULT_DURATION`
`private static Node`	`DEFAULT_NODE`
`private static PathTransition.OrientationType`	`DEFAULT_ORIENTATION`
`private static Shape`	`DEFAULT_PATH`
`private <any>`	`duration` The duration of this `Transition`.
`private <any>`	`node` The target node of this `PathTransition`.
`private <any>`	`orientation` Specifies the upright orientation of `node` along the `path`.
`private <any>`	`path` The shape on which outline the node should be animated.
`private java.util.ArrayList<PathTransition.Segment>`	`segments`
`private static int`	`SMOOTH_ZONE`
`private double`	`totalLength`

Fields inherited from class javafx.animation.Animation
clipEnvelope, INDEFINITE, parent, pulseReceiver

Constructor Summary

Constructors
Constructor and Description
`PathTransition()` The constructor of `PathTransition`.
`PathTransition(Duration duration, Shape path)` The constructor of `PathTransition`.
`PathTransition(Duration duration, Shape path, Node node)` The constructor of `PathTransition`.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`<any>`	`durationProperty()` The duration of this `Transition`.
`private int`	`findSegment(int begin, int end, double length)` Returns the index of the first segment having accumulated length from the path beginning, greater than `length`
`Duration`	`getDuration()` Gets the value of the property duration.
`Node`	`getNode()` Gets the value of the property node.
`PathTransition.OrientationType`	`getOrientation()` Gets the value of the property orientation.
`Shape`	`getPath()` Gets the value of the property path.
`private Node`	`getTargetNode()`
`void`	`interpolate(double frac)` The method `interpolate()` has to be provided by implementations of `Transition`.
`private static double`	`interpolate(double fromAngle, double toAngle, double ratio)` Interpolates angle according to rate, with correct 0->360 and 360->0 transitions
`<any>`	`nodeProperty()` The target node of this `PathTransition`.
`private static double`	`normalize(double angle)` Converts angle to range 0-360
`<any>`	`orientationProperty()` Specifies the upright orientation of `node` along the `path`.
`<any>`	`pathProperty()` The shape on which outline the node should be animated.
`private void`	`recomputeSegments()`
`void`	`setDuration(Duration value)` Sets the value of the property duration.
`void`	`setNode(Node value)` Sets the value of the property node.
`void`	`setOrientation(PathTransition.OrientationType value)` Sets the value of the property orientation.
`void`	`setPath(Shape value)` Sets the value of the property path.
`(package private) boolean`	`startable(boolean forceSync)`
`(package private) void`	`sync(boolean forceSync)`

Methods inherited from class javafx.animation.Transition
doJumpTo, doPlayTo, getCachedInterpolator, getInterpolator, getParentTargetNode, interpolatorProperty, setInterpolator

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Property Detail
  - node
```
public final <any> nodeProperty
```
    The target node of this PathTransition.
    It is not possible to change the target node of a running PathTransition. If the value of node is changed for a running PathTransition, the animation has to be stopped and started again to pick up the new value.
    
    See Also:
    
    getNode(), setNode(Node)
  - duration
```
public final <any> durationProperty
```
    The duration of this Transition.
    It is not possible to change the duration of a running PathTransition. If the value of duration is changed for a running PathTransition, 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.
    
    See Also:
    
    getDuration(), setDuration(Duration)
  - path
```
public final <any> pathProperty
```
    The shape on which outline the node should be animated.
    It is not possible to change the path of a running PathTransition. If the value of path is changed for a running PathTransition, the animation has to be stopped and started again to pick up the new value.
    
    See Also:
    
    getPath(), setPath(Shape)
  - orientation
```
public final <any> orientationProperty
```
    Specifies the upright orientation of node along the path. The default orientation is set to PathTransition.OrientationType.NONE.
    It is not possible to change the orientation of a running PathTransition. If the value of orientation is changed for a running PathTransition, the animation has to be stopped and started again to pick up the new value.
    
    See Also:
    
    getOrientation(), setOrientation(OrientationType)
- Field Detail
  - node
```
private <any> node
```
    The target node of this PathTransition.
    It is not possible to change the target node of a running PathTransition. If the value of node is changed for a running PathTransition, the animation has to be stopped and started again to pick up the new value.
  - totalLength
```
private double totalLength
```
  - segments
```
private final java.util.ArrayList<PathTransition.Segment> segments
```
  - DEFAULT_NODE
```
private static final Node DEFAULT_NODE
```
  - SMOOTH_ZONE
```
private static final int SMOOTH_ZONE
```
    See Also:
    
    Constant Field Values
  - cachedNode
```
private Node cachedNode
```
  - duration
```
private <any> duration
```
    The duration of this Transition.
    It is not possible to change the duration of a running PathTransition. If the value of duration is changed for a running PathTransition, 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_DURATION
```
private static final Duration DEFAULT_DURATION
```
  - path
```
private <any> path
```
    The shape on which outline the node should be animated.
    It is not possible to change the path of a running PathTransition. If the value of path is changed for a running PathTransition, the animation has to be stopped and started again to pick up the new value.
  - DEFAULT_PATH
```
private static final Shape DEFAULT_PATH
```
  - orientation
```
private <any> orientation
```
    Specifies the upright orientation of node along the path. The default orientation is set to PathTransition.OrientationType.NONE.
    It is not possible to change the orientation of a running PathTransition. If the value of orientation is changed for a running PathTransition, the animation has to be stopped and started again to pick up the new value.
  - DEFAULT_ORIENTATION
```
private static final PathTransition.OrientationType DEFAULT_ORIENTATION
```
  - cachedIsNormalRequired
```
private boolean cachedIsNormalRequired
```
- Constructor Detail
  - PathTransition
```
public PathTransition(Duration duration,
                      Shape path,
                      Node node)
```
    The constructor of PathTransition.
    
    Parameters:
    
    duration - The duration of this PathTransition
    
    path - The path of this PathTransition
    
    node - The node of this PathTransition
  - PathTransition
```
public PathTransition(Duration duration,
                      Shape path)
```
    The constructor of PathTransition.
    
    Parameters:
    
    duration - The duration of this PathTransition
    
    path - The path of this PathTransition
  - PathTransition
```
public PathTransition()
```
    The constructor of PathTransition.
- Method Detail
  - setNode
```
public final void setNode(Node value)
```
    Sets the value of the property node.
  - getNode
```
public final Node getNode()
```
    Gets the value of the property node.
  - nodeProperty
```
public final <any> nodeProperty()
```
    The target node of this PathTransition.
    It is not possible to change the target node of a running PathTransition. If the value of node is changed for a running PathTransition, 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.
  - getDuration
```
public final Duration getDuration()
```
    Gets the value of the property duration.
  - durationProperty
```
public final <any> durationProperty()
```
    The duration of this Transition.
    It is not possible to change the duration of a running PathTransition. If the value of duration is changed for a running PathTransition, 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.
    
    See Also:
    
    getDuration(), setDuration(Duration)
  - setPath
```
public final void setPath(Shape value)
```
    Sets the value of the property path.
  - getPath
```
public final Shape getPath()
```
    Gets the value of the property path.
  - pathProperty
```
public final <any> pathProperty()
```
    The shape on which outline the node should be animated.
    It is not possible to change the path of a running PathTransition. If the value of path is changed for a running PathTransition, the animation has to be stopped and started again to pick up the new value.
    
    See Also:
    
    getPath(), setPath(Shape)
  - setOrientation
```
public final void setOrientation(PathTransition.OrientationType value)
```
    Sets the value of the property orientation.
  - getOrientation
```
public final PathTransition.OrientationType getOrientation()
```
    Gets the value of the property orientation.
  - orientationProperty
```
public final <any> orientationProperty()
```
    Specifies the upright orientation of node along the path. The default orientation is set to PathTransition.OrientationType.NONE.
    It is not possible to change the orientation of a running PathTransition. If the value of orientation is changed for a running PathTransition, the animation has to be stopped and started again to pick up the new value.
    
    See Also:
    
    getOrientation(), setOrientation(OrientationType)
  - interpolate
```
public void interpolate(double frac)
```
    The method interpolate() has to be provided by implementations of Transition. While a Transition is running, this method is called in every frame. The parameter defines the current position with the animation. At the start, the fraction will be 0.0 and at the end it will be 1.0. How the parameter increases, depends on the interpolator, e.g. if the interpolator is Interpolator.LINEAR, the fraction will increase linear. This method must not be called by the user directly.
    
    Specified by:
    
    interpolate in class Transition
    
    Parameters:
    
    frac - The relative position
  - getTargetNode
```
private Node getTargetNode()
```
  - startable
```
boolean startable(boolean forceSync)
```
    Overrides:
    
    startable in class Transition
  - sync
```
void sync(boolean forceSync)
```
    Overrides:
    
    sync in class Transition
  - recomputeSegments
```
private void recomputeSegments()
```
  - findSegment
```
private int findSegment(int begin,
                        int end,
                        double length)
```
    Returns the index of the first segment having accumulated length from the path beginning, greater than length
  - interpolate
```
private static double interpolate(double fromAngle,
                                  double toAngle,
                                  double ratio)
```
    Interpolates angle according to rate, with correct 0->360 and 360->0 transitions
  - normalize
```
private static double normalize(double angle)
```
    Converts angle to range 0-360

Class PathTransition

Property Summary

Properties inherited from class javafx.animation.Transition

Properties inherited from class javafx.animation.Animation

Nested Class Summary

Nested classes/interfaces inherited from class javafx.animation.Animation

Field Summary

Fields inherited from class javafx.animation.Animation

Constructor Summary

Method Summary

Methods inherited from class javafx.animation.Transition

Methods inherited from class javafx.animation.Animation

Methods inherited from class java.lang.Object

Property Detail

node

duration

path

orientation

Field Detail

node

totalLength

segments

DEFAULT_NODE

SMOOTH_ZONE

cachedNode

duration

DEFAULT_DURATION

path

DEFAULT_PATH

orientation

DEFAULT_ORIENTATION

cachedIsNormalRequired

Constructor Detail

PathTransition

PathTransition

PathTransition

Method Detail

setNode

getNode

nodeProperty

setDuration

getDuration

durationProperty

setPath

getPath

pathProperty

setOrientation

getOrientation

orientationProperty

interpolate

getTargetNode

startable

sync

recomputeSegments

findSegment

interpolate

normalize