Class AstarData

T AddGraph<T> ()

Adds a graph of type T to the graphs array.

NavGraph AddGraph (

System.Type

type

)

Adds a graph of type type to the graphs array.

void ClearGraphs ()

Destroys all graphs and sets graphs to null.

void DeserializeGraphs ()

Deserializes graphs from data.

void DeserializeGraphs (

byte[]

bytes

)

Deserializes graphs from the specified byte array.

An error will be logged if deserialization fails.

void DeserializeGraphsAdditive (

byte[]

bytes

)

Deserializes graphs from the specified byte array additively.

An error will be logged if deserialization fails. This function will add loaded graphs to the current ones.

void DisposeUnmanagedData ()

NavGraph FindGraph (

System.Func<NavGraph, bool>

predicate

)

Returns the first graph which satisfies the predicate.

Returns null if no graph was found.

NavGraph FindGraphOfType (

System.Type

type

)

Returns the first graph of type type found in the graphs array.

Returns null if no graph was found.

void FindGraphTypes ()

Find all graph types supported in this build.

Using reflection, the assembly is searched for types which inherit from NavGraph.

NavGraph FindGraphWhichInheritsFrom (

System.Type

type

)

Returns the first graph which inherits from the type type.

Returns null if no graph was found.

IEnumerable FindGraphsOfType (

System.Type

type

)

Loop through this function to get all graphs of type 'type'.

foreach (GridGraph graph in AstarPath.data.FindGraphsOfType (typeof(GridGraph))) {
//Do something with the graph
}


byte[] GetData ()

int GetGraphIndex (

NavGraph

graph

)

Gets the index of the NavGraph in the graphs array.

void GetNodes (

System.Action<GraphNode>

callback

)

Calls the callback with every node in all graphs.

This is the easiest way to iterate through every existing node.

AstarPath.active.data.GetNodes(node => {
Debug.Log("I found a node at position " + (Vector3)node.position);
});


IEnumerable GetUpdateableGraphs ()

All graphs which implements the UpdateableGraph interface.

foreach (IUpdatableGraph graph in AstarPath.data.GetUpdateableGraphs ()) {
//Do something with the graph
}


void LoadFromCache ()

Load from data from file_cachedStartup.

void OnDestroy ()

void OnEnable ()

Loads the graphs from memory, will load cached graphs if any exists.

bool RemoveGraph (

NavGraph

graph

)

Removes the specified graph from the graphs array and Destroys it in a safe manner.

To avoid changing graph indices for the other graphs, the graph is simply nulled in the array instead of actually removing it from the array. The empty position will be reused if a new graph is added.

byte[] SerializeGraphs ()

Serializes all graphs settings to a byte array.

byte[] SerializeGraphs (

SerializeSettings

settings

)

Serializes all graphs settings and optionally node data to a byte array.

byte[] SerializeGraphs (

SerializeSettings	settings
out uint	checksum

)

Main serializer function.

Serializes all graphs to a byte array A similar function exists in the AstarPathEditor.cs script to save additional info

void SetData (

byte[]

data

)

void UpdateShortcuts ()

Updates shortcuts to the first graph of different types.

Hard coding references to some graph types is not really a good thing imo. I want to keep it dynamic and flexible. But these references ease the use of the system, so I decided to keep them.

NavGraph GetGraph (

GraphNode

node

)

Returns the graph which contains the specified node.

The graph must be in the graphs array.

bool cacheStartup

Should graph-data be cached.

Caching the startup means saving the whole graphs - not only the settings - to a file (file_cachedStartup) which can be loaded when the game starts. This is usually much faster than scanning the graphs when the game starts. This is configured from the editor under the "Save & Load" tab.

TextAsset file_cachedStartup

Serialized data for cached startup.

If set, on start the graphs will be deserialized from this file.

System.Type[] graphTypes

All supported graph types.

Populated through reflection search

NavGraph[] graphs = new NavGraph[0]

All graphs this instance holds.

This will be filled only after deserialization has completed. May contain null entries if graph have been removed.

GridGraph gridGraph

Shortcut to the first GridGraph.

Updated at scanning time

LayerGridGraph layerGridGraph

Shortcut to the first LayerGridGraph.

Updated at scanning time.

NavMeshGraph navmesh

Shortcut to the first NavMeshGraph.

Updated at scanning time

PointGraph pointGraph

Shortcut to the first PointGraph.

Updated at scanning time

RecastGraph recastGraph

Shortcut to the first RecastGraph.

Updated at scanning time.

void AddGraph (

NavGraph

graph

)

Adds the specified graph to the graphs array.

PathProcessor.GraphUpdateLock AssertSafe (

bool

onlyAddingGraph=false

)

AstarData (

AstarPath

active

)

void ClearGraphsInternal ()

NavGraph CreateGraph (

System.Type

type

)

Creates a new graph instance of type type.

void DeserializeGraphsPartAdditive (

AstarSerializer

sr

)

Helper function for deserializing graphs.

void DestroyAllNodes ()

Makes all graphs become unscanned.

void LockGraphStructure (

bool

allowAddingGraphs=false

)

Prevent the graph structure from changing during the time this lock is held.

This prevents graphs from being added or removed and also prevents graphs from being serialized or deserialized. This is used when e.g an async scan is happening to ensure that for example a graph that is being scanned is not destroyed.

Each call to this method *must* be paired with exactly one call to UnlockGraphStructure. The calls may be nested.

void UnlockGraphStructure ()

Allows the graph structure to change again.

AstarPath active

The AstarPath component which owns this AstarData.

byte[]?? data

Serialized data for all graphs and settings.

string dataString

Serialized data for all graphs and settings.

Stored as a base64 encoded string because otherwise Unity's Undo system would sometimes corrupt the byte data (because it only stores deltas).

This can be accessed as a byte array from the data property.

List<bool> graphStructureLocked = new List<bool>()

byte[] upgradeData

Data from versions from before 3.6.1.

Used for handling upgrades

byte[] data_cachedStartup

Serialized data for cached startup.