Creates a goal whose effect is to both maintain position on and traverse the specified path.
- iOS 9.0+
- macOS 10.11+
- tvOS 9.0+
A path object.
The amount of time for which to predict an affected agent’s movement.
YESto traverse in the order the path’s verties are defined;
NOto traverse the path in the opposite order.
A new goal object.
This goal uses the shape and the
radius property of the specified path to define the agent’s desired movement. The agent first attempts to reach a location near the path’s start point (or end point if the forward parameter is
NO), to a tolerance determined by the path’s radius. Then, the agent attemps to move toward the next point in the path, again with a tolerance determined by the path’s radius. This sequence continues until the path terminates, or repeats indefinitely if the path’s
cyclical property is
max parameter determines how far ahead of time the agent will predict its own movement to fulfill this goal. For example, with a larger value, an agent moving toward the path will begin to slow gradually so as to stop gently within the path’s radius. With a smaller value, the agent will attempt to stop more abruptly as it reaches the path (and depending on its properties, it might not be able to stop quickly enough to avoid overshooting).