A* Pathfinding Project  3.6.1
The A* Pathfinding Project for Unity 3D
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Properties Events Macros Groups Pages
AstarData Class Reference

Stores the navigation graphs for the A* Pathfinding System. More...

Detailed Description

Stores the navigation graphs for the A* Pathfinding System.

An instance of this class is assigned to AstarPath.astarData, from it you can access all graphs loaded through the graphs variable.
This class also handles a lot of the high level serialization.

Public Member Functions

NavGraph AddGraph (string type)
 Adds a graph of type type to the graphs array.
 
NavGraph AddGraph (System.Type type)
 Adds a graph of type type to the graphs array.
 
void AddGraph (NavGraph graph)
 Adds the specified graph to the graphs array.
 
void Awake ()
 Loads the graphs from memory, will load cached graphs if any exists.
 
NavGraph CreateGraph (string type)
 Creates a new instance of a graph of type type.
 
NavGraph CreateGraph (System.Type type)
 Creates a new graph instance of type type.
 
void DeserializeGraphs ()
 Deserializes graphs from data.
 
void DeserializeGraphs (byte[] bytes)
 Deserializes graphs from the specified byte array.
 
void DeserializeGraphsAdditive (byte[] bytes)
 Deserializes graphs from the specified byte array additively.
 
void DeserializeGraphsPart (Pathfinding.Serialization.AstarSerializer sr)
 Deserializes common info.
 
void DeserializeGraphsPartAdditive (Pathfinding.Serialization.AstarSerializer sr)
 Deserializes common info additively Common info is what is shared between the editor serialization and the runtime serializer.
 
NavGraph FindGraphOfType (System.Type type)
 Returns the first graph of type type found in the graphs array.
 
IEnumerable FindGraphsOfType (System.Type type)
 Loop through this function to get all graphs of type 'type'.
 
void FindGraphTypes ()
 Find all graph types supported in this build.
 
byte[] GetData ()
 
int GetGraphIndex (NavGraph graph)
 Gets the index of the NavGraph in the graphs array.
 
System.Type GetGraphType (string type)
 
GraphNode GetNode (int graphIndex, int nodeIndex)
 Returns the node at graphs[graphIndex].nodes[nodeIndex].
 
GraphNode GetNode (int graphIndex, int nodeIndex, NavGraph[] graphs)
 Returns the node at graphs[graphIndex].nodes[nodeIndex].
 
IEnumerable GetRaycastableGraphs ()
 All graphs which implements the UpdateableGraph interface.
 
IEnumerable GetUpdateableGraphs ()
 All graphs which implements the UpdateableGraph interface.
 
void LoadFromCache ()
 Load from data from file_cachedStartup.
 
void OnDestroy ()
 
bool RemoveGraph (NavGraph graph)
 Removes the specified graph from the graphs array and Destroys it in a safe manner.
 
byte[] SerializeGraphs ()
 Serializes all graphs settings to a byte array.
 
byte[] SerializeGraphs (Pathfinding.Serialization.SerializeSettings settings)
 Serializes all graphs settings and optionally node data to a byte array.
 
byte[] SerializeGraphs (Pathfinding.Serialization.SerializeSettings settings, out uint checksum)
 Main serializer function.
 
void SerializeGraphsPart (Pathfinding.Serialization.AstarSerializer sr)
 Serializes common info to the serializer.
 
void SetData (byte[] data)
 
void UpdateShortcuts ()
 Updates shortcuts to the first graph of different types.
 

Static Public Member Functions

static NavGraph GetGraph (GraphNode node)
 Returns the graph which contains the specified node.
 

Public Attributes

bool cacheStartup = false
 Should graph-data be cached.
 
byte[] data_backup
 Backup data if deserialization failed.
 
byte[] data_cachedStartup
 Serialized data for cached startup.
 
TextAsset file_cachedStartup
 Serialized data for cached startup.
 
NavGraph[] graphs = new NavGraph[0]
 All graphs this instance holds.
 
UserConnection[] userConnections = new UserConnection[0]
 Links placed by the user in the scene view.
 

Properties

AstarPath active [get]
 Shortcut to AstarPath.active.
 
byte[] data [get, set]
 Serialized data for all graphs and settings.
 
System.Type[] graphTypes [get, set]
 All supported graph types.
 
GridGraph gridGraph [get, set]
 Shortcut to the first GridGraph.
 
NavMeshGraph navmesh [get, set]
 Shortcut to the first NavMeshGraph.
 
PointGraph pointGraph [get, set]
 Shortcut to the first PointGraph.
 
RecastGraph recastGraph [get, set]
 Shortcut to the first RecastGraph.
 

Private Member Functions

void ClearGraphs ()
 Destroys all graphs and sets graphs to null.
 

Private Attributes

string dataString
 Serialized data for all graphs and settings.
 
byte[] upgradeData
 Data from versions from before 3.6.1.
 

Member Function Documentation

NavGraph AddGraph ( string  type)

Adds a graph of type type to the graphs array.

NavGraph AddGraph ( System.Type  type)

Adds a graph of type type to the graphs array.

void AddGraph ( NavGraph  graph)

Adds the specified graph to the graphs array.

void Awake ( )

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

void ClearGraphs ( )
private

Destroys all graphs and sets graphs to null.

NavGraph CreateGraph ( string  type)

Creates a new instance of a graph of type type.

If no matching graph type was found, an error is logged and null is returned

Returns
The created graph
See Also
CreateGraph(System.Type)
NavGraph CreateGraph ( System.Type  type)

Creates a new graph instance of type type.

See Also
CreateGraph(string)
void DeserializeGraphs ( )

Deserializes graphs from data.

void DeserializeGraphs ( byte[]  bytes)

Deserializes graphs from the specified byte array.

If an error occured, it will try to deserialize using the old deserializer. A warning will be logged if all deserializers failed.

void DeserializeGraphsAdditive ( byte[]  bytes)

Deserializes graphs from the specified byte array additively.

If an error ocurred, it will try to deserialize using the old deserializer. A warning will be logged if all deserializers failed. This function will add loaded graphs to the current ones

void DeserializeGraphsPart ( Pathfinding.Serialization.AstarSerializer  sr)

Deserializes common info.

Common info is what is shared between the editor serialization and the runtime serializer. This is mostly everything except the graph inspectors which serialize some extra data in the editor

void DeserializeGraphsPartAdditive ( Pathfinding.Serialization.AstarSerializer  sr)

Deserializes common info additively Common info is what is shared between the editor serialization and the runtime serializer.

This is mostly everything except the graph inspectors which serialize some extra data in the editor

NavGraph FindGraphOfType ( System.Type  type)

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

Returns null if none was found

IEnumerable FindGraphsOfType ( System.Type  type)

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

foreach (GridGraph graph in AstarPath.astarData.FindGraphsOfType (typeof(GridGraph))) {
//Do something with the graph
}
See Also
AstarPath.RegisterSafeNodeUpdate
void FindGraphTypes ( )

Find all graph types supported in this build.

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

byte [] GetData ( )
static NavGraph GetGraph ( GraphNode  node)
static

Returns the graph which contains the specified node.

The graph must be in the graphs array.

Returns
Returns the graph which contains the node. Null if the graph wasn't found
int GetGraphIndex ( NavGraph  graph)

Gets the index of the NavGraph in the graphs array.

System.Type GetGraphType ( string  type)
Returns
A System.Type which matches the specified type string. If no mathing graph type was found, null is returned
GraphNode GetNode ( int  graphIndex,
int  nodeIndex 
)

Returns the node at graphs[graphIndex].nodes[nodeIndex].

All kinds of error checking is done to make sure no exceptions are thrown.

Deprecated:
Use graph specific methods instead
GraphNode GetNode ( int  graphIndex,
int  nodeIndex,
NavGraph[]  graphs 
)

Returns the node at graphs[graphIndex].nodes[nodeIndex].

The graphIndex refers to the specified graphs array.
All kinds of error checking is done to make sure no exceptions are thrown.

Use graph specific methods instead

IEnumerable GetRaycastableGraphs ( )

All graphs which implements the UpdateableGraph interface.

foreach (IRaycastableGraph graph in AstarPath.astarData.GetRaycastableGraphs ()) {
//Do something with the graph
}
See Also
Pathfinding.IRaycastableGraph
IEnumerable GetUpdateableGraphs ( )

All graphs which implements the UpdateableGraph interface.

foreach (IUpdatableGraph graph in AstarPath.astarData.GetUpdateableGraphs ()) {
//Do something with the graph
}
See Also
AstarPath.RegisterSafeNodeUpdate
Pathfinding.IUpdatableGraph
void LoadFromCache ( )

Load from data from file_cachedStartup.

void OnDestroy ( )
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.

Returns
True if the graph was sucessfully removed (i.e it did exist in the graphs array). False otherwise.
Version
Changed in 3.2.5 to call SafeOnDestroy before removing and nulling it in the array instead of removing the element completely in the graphs array.
byte [] SerializeGraphs ( )

Serializes all graphs settings to a byte array.

See Also
DeserializeGraphs(byte[])
byte [] SerializeGraphs ( Pathfinding.Serialization.SerializeSettings  settings)

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

See Also
DeserializeGraphs(byte[])
Pathfinding.Serialization.SerializeSettings
byte [] SerializeGraphs ( Pathfinding.Serialization.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 SerializeGraphsPart ( Pathfinding.Serialization.AstarSerializer  sr)

Serializes common info to the serializer.

Common info is what is shared between the editor serialization and the runtime serializer. This is mostly everything except the graph inspectors which serialize some extra data in the editor

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.

Member Data Documentation

bool cacheStartup = false

Should graph-data be cached.

Caching the startup means saving the whole graphs, not only the settings to an internal array (data_cachedStartup) which can be loaded faster than scanning all graphs at startup. This is setup from the editor.

byte [] data_backup

Backup data if deserialization failed.

byte [] data_cachedStartup

Serialized data for cached startup.

Deprecated:
Deprecated since 3.6, file_cachedStartup is now used instead
string dataString
private

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.

Since
3.6.1
TextAsset file_cachedStartup

Serialized data for cached startup.

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

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.

byte [] upgradeData
private

Data from versions from before 3.6.1.

Used for handling upgrades

Since
3.6.1
UserConnection [] userConnections = new UserConnection[0]

Links placed by the user in the scene view.

Deprecated:

Property Documentation

AstarPath active
get

Shortcut to AstarPath.active.

byte [] data
getsetprivate

Serialized data for all graphs and settings.

System.Type [] graphTypes
getset

All supported graph types.

Populated through reflection search

GridGraph gridGraph
getset

Shortcut to the first GridGraph.

Updated at scanning time

NavMeshGraph navmesh
getset

Shortcut to the first NavMeshGraph.

Updated at scanning time

PointGraph pointGraph
getset

Shortcut to the first PointGraph.

Updated at scanning time

RecastGraph recastGraph
getset

Shortcut to the first RecastGraph.

Updated at scanning time.

A* Pro Feature:
This is an A* Pathfinding Project Pro feature only. This function/class/variable might not exist in the Free version of the A* Pathfinding Project or the functionality might be limited
The Pro version can be bought here

The documentation for this class was generated from the following file: