Initializer

init(toFollow:maxPredictionTime:forward:)

Creates a goal whose effect is to both maintain position on and traverse the specified path.

Declaration

convenience init(toFollow path: GKPath, maxPredictionTime: TimeInterval, forward: Bool)

Parameters

path

A path object.

maxPredictionTime

The amount of time for which to predict an affected agent’s movement.

forward

true to traverse in the order the path’s verties are defined; false to traverse the path in the opposite order.

Return Value

A new goal object.

Discussion

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 false), 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 isCyclical property is true.

The maxPredictionTime 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).

See Also

Creating Goals for Path-Following Behavior

init(toStayOn: GKPath, maxPredictionTime: TimeInterval)

Creates a goal whose effect is to maintain an agent’s position within the specified path.