Up to date
This page is up to date for Godot 4.0
.
If you still find outdated information, please open an issue.
AStarGrid2D¶
Inherits: RefCounted < Object
A* (or "A-Star") pathfinding tailored to find the shortest paths on 2D grids.
Description¶
Compared to AStar2D you don't need to manually create points or connect them together. It also supports multiple type of heuristics and modes for diagonal movement. This class also provides a jumping mode which is faster to calculate than without it in the AStar2D class.
In contrast to AStar2D, you only need set the size of the grid, optionally set the cell_size and then call the update method:
var astar_grid = AStarGrid2D.new()
astar_grid.size = Vector2i(32, 32)
astar_grid.cell_size = Vector2(16, 16)
astar_grid.update()
print(astar_grid.get_id_path(Vector2i(0, 0), Vector2i(3, 4))) # prints (0, 0), (1, 1), (2, 2), (3, 3), (3, 4)
print(astar_grid.get_point_path(Vector2i(0, 0), Vector2i(3, 4))) # prints (0, 0), (16, 16), (32, 32), (48, 48), (48, 64)
AStarGrid2D astarGrid = new AStarGrid2D();
astarGrid.Size = new Vector2I(32, 32);
astarGrid.CellSize = new Vector2I(16, 16);
astarGrid.Update();
GD.Print(astarGrid.GetIdPath(Vector2I.Zero, new Vector2I(3, 4))); // prints (0, 0), (1, 1), (2, 2), (3, 3), (3, 4)
GD.Print(astarGrid.GetPointPath(Vector2I.Zero, new Vector2I(3, 4))); // prints (0, 0), (16, 16), (32, 32), (48, 48), (48, 64)
Properties¶
|
||
|
||
|
||
|
||
|
||
|
||
|
Methods¶
_compute_cost ( Vector2i from_id, Vector2i to_id ) virtual const |
|
_estimate_cost ( Vector2i from_id, Vector2i to_id ) virtual const |
|
void |
clear ( ) |
get_id_path ( Vector2i from_id, Vector2i to_id ) |
|
get_point_path ( Vector2i from_id, Vector2i to_id ) |
|
get_point_position ( Vector2i id ) const |
|
get_point_weight_scale ( Vector2i id ) const |
|
is_dirty ( ) const |
|
is_in_bounds ( int x, int y ) const |
|
is_in_boundsv ( Vector2i id ) const |
|
is_point_solid ( Vector2i id ) const |
|
void |
set_point_solid ( Vector2i id, bool solid=true ) |
void |
set_point_weight_scale ( Vector2i id, float weight_scale ) |
void |
update ( ) |
Enumerations¶
enum Heuristic:
Heuristic HEURISTIC_EUCLIDEAN = 0
The Euclidean heuristic to be used for the pathfinding using the following formula:
dx = abs(to_id.x - from_id.x)
dy = abs(to_id.y - from_id.y)
result = sqrt(dx * dx + dy * dy)
Note: This is also the internal heuristic used in AStar3D and AStar2D by default (with the inclusion of possible z-axis coordinate).
Heuristic HEURISTIC_MANHATTAN = 1
The Manhattan heuristic to be used for the pathfinding using the following formula:
dx = abs(to_id.x - from_id.x)
dy = abs(to_id.y - from_id.y)
result = dx + dy
Note: This heuristic is intended to be used with 4-side orthogonal movements, provided by setting the diagonal_mode to DIAGONAL_MODE_NEVER.
Heuristic HEURISTIC_OCTILE = 2
The Octile heuristic to be used for the pathfinding using the following formula:
dx = abs(to_id.x - from_id.x)
dy = abs(to_id.y - from_id.y)
f = sqrt(2) - 1
result = (dx < dy) ? f * dx + dy : f * dy + dx;
Heuristic HEURISTIC_CHEBYSHEV = 3
The Chebyshev heuristic to be used for the pathfinding using the following formula:
dx = abs(to_id.x - from_id.x)
dy = abs(to_id.y - from_id.y)
result = max(dx, dy)
Heuristic HEURISTIC_MAX = 4
Represents the size of the Heuristic enum.
enum DiagonalMode:
DiagonalMode DIAGONAL_MODE_ALWAYS = 0
The pathfinding algorithm will ignore solid neighbors around the target cell and allow passing using diagonals.
DiagonalMode DIAGONAL_MODE_NEVER = 1
The pathfinding algorithm will ignore all diagonals and the way will be always orthogonal.
DiagonalMode DIAGONAL_MODE_AT_LEAST_ONE_WALKABLE = 2
The pathfinding algorithm will avoid using diagonals if at least two obstacles have been placed around the neighboring cells of the specific path segment.
DiagonalMode DIAGONAL_MODE_ONLY_IF_NO_OBSTACLES = 3
The pathfinding algorithm will avoid using diagonals if any obstacle has been placed around the neighboring cells of the specific path segment.
DiagonalMode DIAGONAL_MODE_MAX = 4
Represents the size of the DiagonalMode enum.
Property Descriptions¶
Vector2 cell_size = Vector2(1, 1)
The size of the point cell which will be applied to calculate the resulting point position returned by get_point_path. If changed, update needs to be called before finding the next path.
Heuristic default_compute_heuristic = 0
The default Heuristic which will be used to calculate the cost between two points if _compute_cost was not overridden.
Heuristic default_estimate_heuristic = 0
void set_default_estimate_heuristic ( Heuristic value )
Heuristic get_default_estimate_heuristic ( )
The default Heuristic which will be used to calculate the cost between the point and the end point if _estimate_cost was not overridden.
DiagonalMode diagonal_mode = 0
void set_diagonal_mode ( DiagonalMode value )
DiagonalMode get_diagonal_mode ( )
A specific DiagonalMode mode which will force the path to avoid or accept the specified diagonals.
bool jumping_enabled = false
Enables or disables jumping to skip up the intermediate points and speeds up the searching algorithm.
Note: Currently, toggling it on disables the consideration of weight scaling in pathfinding.
Vector2 offset = Vector2(0, 0)
The offset of the grid which will be applied to calculate the resulting point position returned by get_point_path. If changed, update needs to be called before finding the next path.
Vector2i size = Vector2i(0, 0)
The size of the grid (number of cells of size cell_size on each axis). If changed, update needs to be called before finding the next path.
Method Descriptions¶
float _compute_cost ( Vector2i from_id, Vector2i to_id ) virtual const
Called when computing the cost between two connected points.
Note that this function is hidden in the default AStarGrid2D
class.
float _estimate_cost ( Vector2i from_id, Vector2i to_id ) virtual const
Called when estimating the cost between a point and the path's ending point.
Note that this function is hidden in the default AStarGrid2D
class.
void clear ( )
Clears the grid and sets the size to Vector2i.ZERO.
Vector2i[] get_id_path ( Vector2i from_id, Vector2i to_id )
Returns an array with the IDs of the points that form the path found by AStar2D between the given points. The array is ordered from the starting point to the ending point of the path.
PackedVector2Array get_point_path ( Vector2i from_id, Vector2i to_id )
Returns an array with the points that are in the path found by AStarGrid2D between the given points. The array is ordered from the starting point to the ending point of the path.
Note: This method is not thread-safe. If called from a Thread, it will return an empty PackedVector3Array and will print an error message.
Vector2 get_point_position ( Vector2i id ) const
Returns the position of the point associated with the given id
.
float get_point_weight_scale ( Vector2i id ) const
Returns the weight scale of the point associated with the given id
.
bool is_dirty ( ) const
Indicates that the grid parameters were changed and update needs to be called.
bool is_in_bounds ( int x, int y ) const
Returns true
if the x
and y
is a valid grid coordinate (id).
bool is_in_boundsv ( Vector2i id ) const
Returns true
if the id
vector is a valid grid coordinate.
bool is_point_solid ( Vector2i id ) const
Returns true
if a point is disabled for pathfinding. By default, all points are enabled.
void set_point_solid ( Vector2i id, bool solid=true )
Disables or enables the specified point for pathfinding. Useful for making an obstacle. By default, all points are enabled.
Note: Calling update is not needed after the call of this function.
void set_point_weight_scale ( Vector2i id, float weight_scale )
Sets the weight_scale
for the point with the given id
. The weight_scale
is multiplied by the result of _compute_cost when determining the overall cost of traveling across a segment from a neighboring point to this point.
Note: Calling update is not needed after the call of this function.
void update ( )
Updates the internal state of the grid according to the parameters to prepare it to search the path. Needs to be called if parameters like size, cell_size or offset are changed. is_dirty will return true
if this is the case and this needs to be called.