NavigationPathQueryParameters3D

Inherits: RefCounted < Object

Provides parameters for 3D navigation path queries.

Description

By changing various properties of this object, such as the start and target position, you can configure path queries to the NavigationServer3D.

Tutorials

Properties

RID

map

RID()

BitField<PathMetadataFlags>

metadata_flags

7

int

navigation_layers

1

PathPostProcessing

path_postprocessing

0

PathfindingAlgorithm

pathfinding_algorithm

0

Vector3

start_position

Vector3(0, 0, 0)

Vector3

target_position

Vector3(0, 0, 0)


Enumerations

enum PathfindingAlgorithm:

PathfindingAlgorithm PATHFINDING_ALGORITHM_ASTAR = 0

The path query uses the default A* pathfinding algorithm.


enum PathPostProcessing:

PathPostProcessing PATH_POSTPROCESSING_CORRIDORFUNNEL = 0

Applies a funnel algorithm to the raw path corridor found by the pathfinding algorithm. This will result in the shortest path possible inside the path corridor. This postprocessing very much depends on the navigation mesh polygon layout and the created corridor. Especially tile- or gridbased layouts can face artificial corners with diagonal movement due to a jagged path corridor imposed by the cell shapes.

PathPostProcessing PATH_POSTPROCESSING_EDGECENTERED = 1

Centers every path position in the middle of the traveled navigation mesh polygon edge. This creates better paths for tile- or gridbased layouts that restrict the movement to the cells center.


flags PathMetadataFlags:

PathMetadataFlags PATH_METADATA_INCLUDE_NONE = 0

Don’t include any additional metadata about the returned path.

PathMetadataFlags PATH_METADATA_INCLUDE_TYPES = 1

Include the type of navigation primitive (region or link) that each point of the path goes through.

PathMetadataFlags PATH_METADATA_INCLUDE_RIDS = 2

Include the RIDs of the regions and links that each point of the path goes through.

PathMetadataFlags PATH_METADATA_INCLUDE_OWNERS = 4

Include the ObjectIDs of the Objects which manage the regions and links each point of the path goes through.

PathMetadataFlags PATH_METADATA_INCLUDE_ALL = 7

Include all available metadata about the returned path.


Property Descriptions

RID map = RID()

  • void set_map ( RID value )

  • RID get_map ( )

The navigation map RID used in the path query.


BitField<PathMetadataFlags> metadata_flags = 7

Additional information to include with the navigation path.


int navigation_layers = 1

  • void set_navigation_layers ( int value )

  • int get_navigation_layers ( )

The navigation layers the query will use (as a bitmask).


PathPostProcessing path_postprocessing = 0

The path postprocessing applied to the raw path corridor found by the pathfinding_algorithm.


PathfindingAlgorithm pathfinding_algorithm = 0

The pathfinding algorithm used in the path query.


Vector3 start_position = Vector3(0, 0, 0)

  • void set_start_position ( Vector3 value )

  • Vector3 get_start_position ( )

The pathfinding start position in global coordinates.


Vector3 target_position = Vector3(0, 0, 0)

  • void set_target_position ( Vector3 value )

  • Vector3 get_target_position ( )

The pathfinding target position in global coordinates.

Previous Next


© Copyright 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision 53e837c6.

Built with Sphinx using a theme provided by Read the Docs.