NavigationPathQueryParameters3D

实验性： This class may be changed or removed in future versions.

继承： RefCounted < Object

为3D导航路径查询提供参数。

描述

通过更改此对象的各种属性，例如开始和目标位置，您可以将路径查询配置到NavigationServer3D。

属性

RID	map	RID()
BitField[PathMetadataFlags]	metadata_flags	7
int	navigation_layers	1
PathPostProcessing	path_postprocessing	0
PathfindingAlgorithm	pathfinding_algorithm	0
float	simplify_epsilon	0.0
bool	simplify_path	false
Vector3	start_position	Vector3(0, 0, 0)
Vector3	target_position	Vector3(0, 0, 0)

---

枚举

enum PathfindingAlgorithm: 🔗

PathfindingAlgorithm PATHFINDING_ALGORITHM_ASTAR = 0

路径查询使用默认的A*路径查找算法。

---

enum PathPostProcessing: 🔗

PathPostProcessing PATH_POSTPROCESSING_CORRIDORFUNNEL = 0

将漏斗算法应用于寻路算法找到的原始路径走廊。这将导致路径走廊内可能的最短路径。这种后处理非常依赖于导航网格多边形布局和创建的走廊。特别是基于瓷砖或网格的布局，由于单元格形状强加的锯齿状路径走廊，可以面对对角线移动的人工角落。

PathPostProcessing PATH_POSTPROCESSING_EDGECENTERED = 1

在移动的导航网格多边形边缘中间的每个路径位置居中。这为限制移动到单元格中心的基于瓷砖或网格的布局创建了更好的路径。

PathPostProcessing PATH_POSTPROCESSING_NONE = 2

不应用后处理并返回寻路算法找到的原始路径走廊。

---

flags PathMetadataFlags: 🔗

PathMetadataFlags PATH_METADATA_INCLUDE_NONE = 0

不要包含关于返回路径的任何其他元数据。

PathMetadataFlags PATH_METADATA_INCLUDE_TYPES = 1

包括路径的每个点经过的导航原语（区域或链接）的类型。

PathMetadataFlags PATH_METADATA_INCLUDE_RIDS = 2

包括路径的每个点经过的区域和链接的RID。

PathMetadataFlags PATH_METADATA_INCLUDE_OWNERS = 4

包括Object的ObjectIDs，用于管理路径的每个点经过的区域和链接。

PathMetadataFlags PATH_METADATA_INCLUDE_ALL = 7

包括关于返回路径的所有可用元数据。

---

属性说明

RID map = RID() 🔗

• void set_map(value: RID)

• RID get_map()

路径查询中使用的导航地图RID。

---

BitField[PathMetadataFlags] metadata_flags = 7 🔗

• void set_metadata_flags(value: BitField[PathMetadataFlags])

• BitField[PathMetadataFlags] get_metadata_flags()

要包含在导航路径中的附加信息。

---

int navigation_layers = 1 🔗

• void set_navigation_layers(value: int)

• int get_navigation_layers()

查询将使用的导航层（作为位掩码）。

---

PathPostProcessing path_postprocessing = 0 🔗

• void set_path_postprocessing(value: PathPostProcessing)

• PathPostProcessing get_path_postprocessing()

应用于pathfinding_algorithm找到的原始路径走廊的路径后处理。

---

PathfindingAlgorithm pathfinding_algorithm = 0 🔗

• void set_pathfinding_algorithm(value: PathfindingAlgorithm)

• PathfindingAlgorithm get_pathfinding_algorithm()

路径查询中使用的寻路算法。

---

float simplify_epsilon = 0.0 🔗

• void set_simplify_epsilon(value: float)

• float get_simplify_epsilon()

以世界为单位的路径简化量。

---

bool simplify_path = false 🔗

• void set_simplify_path(value: bool)

• bool get_simplify_path()

如果true将返回路径的简化版本，其中删除了较少的关键路径点。简化量由simplify_epsilon控制。简化使用Ramer-Douglas-Peucker算法的变体进行曲线点抽取。

路径简化有助于缓解某些代理类型和脚本行为可能出现的各种路径跟踪问题。例如。“引导”代理或在“开放领域”中回避。

---

Vector3 start_position = Vector3(0, 0, 0) 🔗

• void set_start_position(value: Vector3)

• Vector3 get_start_position()

全局坐标中的寻路起始位置。

---

Vector3 target_position = Vector3(0, 0, 0) 🔗

• void set_target_position(value: Vector3)

• Vector3 get_target_position()

全局坐标中的寻路目标位置。