Class Seeker Extends VersionedMonoBehaviour

void CancelCurrentPathRequest (

bool

pool=true

If true then the path will be pooled when the pathfinding system is done with it.

)

Stop calculating the current path request.

If this Seeker is currently calculating a path it will be canceled. The callback (usually to a method named OnPathComplete) will soon be called with a path that has the 'error' field set to true.

This does not stop the character from moving, it just aborts the path calculation.

void DeregisterModifier (

IPathModifier

modifier

)

Called by modifiers when they are disabled or destroyed.

Path GetCurrentPath ()

Path that is currently being calculated or was last calculated.

You should rarely have to use this. Instead get the path when the path callback is called.

bool IsDone ()

Is the current path done calculating.

Returns true if the current path has been returned or if the path is null.

void OnDestroy ()

Cleans up some variables.

Releases any eventually claimed paths. Calls OnDestroy on the startEndModifier.

void OnDrawGizmos ()

Draws gizmos for the Seeker.

PathResult PostProcess (

Path

path

)

Post Processes the path.

This will run any modifiers attached to this GameObject on the path. This is identical to calling RunModifiers(ModifierPass.PostProcess, path)

void RegisterModifier (

IPathModifier

modifier

)

Called by modifiers to register themselves.

void RunModifiers (

ModifierPass	pass
Path	path

)

Runs modifiers on a path.

Seeker ()

void SetModifiers (

Path

path

)

Makes the path use the modifiers associated with this Seeker.

Normally you do not need to do this, however if you are calculating paths without using the Seeker, but nonetheless want to use modifiers to post process the path then you can use this method to make the path use the same modifiers as the Seeker.

MultiTargetPath StartMultiTargetPath (

Vector3	start
Vector3 []	endPoints
bool	pathsForAll
Action<MultiTargetPathResult>	callback

)

MultiTargetPath StartMultiTargetPath (

Vector3 []	startPoints
Vector3	end
bool	pathsForAll
Action<MultiTargetPathResult>	callback

)

MultiTargetPath StartMultiTargetPath (

Vector3	start	The start point of the path
Vector3 []	endPoints	The end points of the path
bool	pathsForAll	Indicates whether or not a path to all end points should be searched for or only to the closest one
OnPathDelegate	callback=null	The function to call when the path has been calculated
int	graphMask=-1	Mask used to specify which graphs should be searched for close nodes. See Pathfinding.NNConstraint.graphMask.

)

Starts a Multi Target Path from one start point to multiple end points.

A Multi Target Path will search for all the end points in one search and will return all paths if pathsForAll is true, or only the shortest one if pathsForAll is false.
callback and pathCallback will be called when the path has completed. Callback will not be called if the path is canceled (e.g when a new path is requested before the previous one has completed)

MultiTargetPath StartMultiTargetPath (

Vector3 []	startPoints	The start points of the path
Vector3	end	The end point of the path
bool	pathsForAll	Indicates whether or not a path from all start points should be searched for or only to the closest one
OnPathDelegate	callback=null	The function to call when the path has been calculated
int	graphMask=-1	Mask used to specify which graphs should be searched for close nodes. See Pathfinding.NNConstraint.graphMask.

)

Starts a Multi Target Path from multiple start points to a single target point.

A Multi Target Path will search from all start points to the target point in one search and will return all paths if pathsForAll is true, or only the shortest one if pathsForAll is false.
callback and pathCallback will be called when the path has completed. Callback will not be called if the path is canceled (e.g when a new path is requested before the previous one has completed)

void StartPath (

ABPath	path
Action<ABPathResult>	callback

)

Path StartPath (

Path	p	The path to start calculating
OnPathDelegate	callback=null	The function to call when the path has been calculated

)

Call this function to start calculating a path.

The callback will be called when the path has been calculated (which may be several frames into the future). The callback will not be called if a new path request is started before this path request has been calculated.

Path StartPath (

Vector3	start	The start point of the path
Vector3	end	The end point of the path
OnPathDelegate	callback=null	The function to call when the path has been calculated

)

Call this function to start calculating a path.

callback will be called when the path has completed. Callback will not be called if the path is canceled (e.g when a new path is requested before the previous one has completed)

void StartPath (

Vector3	start
Vector3	end
Action<ABPathResult>	callback

)

Path StartPath (

Path	path
OnPathDelegate	callback	The function to call when the path has been calculated
int	graphMask	Mask used to specify which graphs should be searched for close nodes. See Pathfinding.NNConstraint.graphMask. This will override graphMask for this path request.

)

Call this function to start calculating a path.

The callback will be called when the path has been calculated (which may be several frames into the future). The callback will not be called if a new path request is started before this path request has been calculated.

Path StartPath (

Vector3	start	The start point of the path
Vector3	end	The end point of the path
OnPathDelegate	callback	The function to call when the path has been calculated
int	graphMask	Mask used to specify which graphs should be searched for close nodes. See Pathfinding.NNConstraint.graphMask. This will override graphMask for this path request.

)

Call this function to start calculating a path.

callback will be called when the path has completed. Callback will not be called if the path is canceled (e.g when a new path is requested before the previous one has completed)

bool detailedGizmos

Enables drawing of the non-postprocessed path using Gizmos.

The path will show up in orange.

Requires that drawGizmos is true.

This will show the path before any post processing such as smoothing is applied.

bool drawGizmos = true

Enables drawing of the last calculated path using Gizmos.

The path will show up in green.

int graphMask = -1

Graphs that this Seeker can use.

This field determines which graphs will be considered when searching for the start and end nodes of a path. It is useful in numerous situations, for example if you want to make one graph for small units and one graph for large units.

This is a bitmask so if you for example want to make the agent only use graph index 3 then you can set this to: seeker.graphMask = 1 << 3;


Note that this field only stores which graph indices that are allowed. This means that if the graphs change their ordering then this mask may no longer be correct.

If you know the name of the graph you can set the mask like this: var name = "My Graph Name";
var graphMask = 1 << (int)AstarPath.active.data.FindGraph(g => g.name == name).graphIndex;

Some overloads of the StartPath methods take a graphMask parameter. If those overloads are used then they will override the graph mask for that path request.

OnPathDelegate pathCallback

Callback for when a path is completed.

Movement scripts should register to this delegate.
A temporary callback can also be set when calling StartPath, but that delegate will only be called for that path

OnPathDelegate postProcessPath

Called after a path has been calculated, right before modifiers are executed.

OnPathDelegate preProcessPath

Called before pathfinding is started.

StartEndModifier startEndModifier = new StartEndModifier()

Path modifier which tweaks the start and end points of a path.

int [] tagPenalties = new int[32]

Penalties for each tag.

Tag 0 which is the default tag, will have added a penalty of tagPenalties[0]. These should only be positive values since the A* algorithm cannot handle negative penalties.

int traversableTags = -1

The tags which the Seeker can traverse.

ModifierPass

void Awake ()

Initializes a few variables.

uint lastPathID

The path ID of the last path queried.

List<IPathModifier> modifiers = new List<IPathModifier>()

Internal list of all modifiers.

OnPathDelegate onPartialPathDelegate

Cached delegate to avoid allocating one every time a path is started.

void OnPathComplete (

Path

p

)

Called when a path has completed.

Will post process it and return it by calling tmpPathCallback and pathCallback

OnPathDelegate onPathDelegate

Cached delegate to avoid allocating one every time a path is started.

int OnUpgradeSerializedData (

int	version
bool	unityThread

)

Handle serialization backwards compatibility.

Path path

The current path.

void SetDefaultGraphMask (

Path

path

)

Set the graph mask only if the user has not changed it from the default value.

void StartPathInternal (

Path	p
OnPathDelegate	callback
Action<PathResult>	callback2=null
Action<ABPathResult>	callback3=null
Action<MultiTargetPathResult>	callback4=null

)

Internal method to start a path and mark it as the currently active path.

OnPathDelegate tmpPathCallback

Temporary callback only called for the current path.

This value is set by the StartPath functions

Action<PathResult> tmpPathCallback2

Temporary callback only called for the current path.

This value is set by the StartPath functions

Action<ABPathResult> tmpPathCallback3

Temporary callback only called for the current path.

This value is set by the StartPath functions

Action<MultiTargetPathResult> tmpPathCallback4

Temporary callback only called for the current path.

This value is set by the StartPath functions

void TryCallAction< T > (

Action<T>	action
T	value

)

ABPath GetNewPath (

Vector3	start
Vector3	end

)

Returns a new path instance.

The path will be taken from the path pool if path recycling is turned on.
This path can be sent to StartPath(Path,OnPathDelegate,int) with no change, but if no change is required StartPath(Vector3,Vector3,OnPathDelegate) does just that. var seeker = GetComponent<Seeker>();
Path p = seeker.GetNewPath (transform.position, transform.position+transform.forward*100);
// Disable heuristics on just this path for example
p.heuristic = Heuristic.None;
seeker.StartPath (p, OnPathComplete);


MultiTargetPath StartMultiTargetPath (

MultiTargetPath	p	The path to start calculating
OnPathDelegate	callback=null	The function to call when the path has been calculated
int	graphMask=-1	Mask used to specify which graphs should be searched for close nodes. See Pathfinding.NNConstraint.graphMask.

)

Starts a Multi Target Path.

Takes a MultiTargetPath and wires everything up for it to send callbacks to the seeker for post-processing.
callback and pathCallback will be called when the path has completed. Callback will not be called if the path is canceled (e.g when a new path is requested before the previous one has completed)