Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

NavigationMeshSourceGeometryData3D

實驗性： This class may be changed or removed in future versions.

繼承： Resource < RefCounted < Object

存放解析所得的源幾何體資料的容器，用於導覽網格的烘焙。

說明

存放解析所得的源幾何體資料的容器，用於導覽網格的烘焙。

方法

void	add_faces(faces: PackedVector3Array, xform: Transform3D)
void	add_mesh(mesh: Mesh, xform: Transform3D)
void	add_mesh_array(mesh_array: Array, xform: Transform3D)
void	add_projected_obstruction(vertices: PackedVector3Array, elevation: float, height: float, carve: bool)
void	append_arrays(vertices: PackedFloat32Array, indices: PackedInt32Array)
void	clear()
void	clear_projected_obstructions()
AABB	get_bounds()
PackedInt32Array	get_indices() const
Array	get_projected_obstructions() const
PackedFloat32Array	get_vertices() const
bool	has_data()
void	merge(other_geometry: NavigationMeshSourceGeometryData3D)
void	set_indices(indices: PackedInt32Array)
void	set_projected_obstructions(projected_obstructions: Array)
void	set_vertices(vertices: PackedFloat32Array)

---

方法說明

void add_faces(faces: PackedVector3Array, xform: Transform3D) 🔗

Adds an array of vertex positions to the geometry data for navigation mesh baking to form triangulated faces. For each face the array must have three vertex positions in clockwise winding order. Since NavigationMesh resources have no transform, all vertex positions need to be offset by the node's transform using xform.

---

void add_mesh(mesh: Mesh, xform: Transform3D) 🔗

Adds the geometry data of a Mesh resource to the navigation mesh baking data. The mesh must have valid triangulated mesh data to be considered. Since NavigationMesh resources have no transform, all vertex positions need to be offset by the node's transform using xform.

---

void add_mesh_array(mesh_array: Array, xform: Transform3D) 🔗

Adds an Array the size of Mesh.ARRAY_MAX and with vertices at index Mesh.ARRAY_VERTEX and indices at index Mesh.ARRAY_INDEX to the navigation mesh baking data. The array must have valid triangulated mesh data to be considered. Since NavigationMesh resources have no transform, all vertex positions need to be offset by the node's transform using xform.

---

void add_projected_obstruction(vertices: PackedVector3Array, elevation: float, height: float, carve: bool) 🔗

Adds a projected obstruction shape to the source geometry. The vertices are considered projected on an xz-axes plane, placed at the global y-axis elevation and extruded by height. If carve is true the carved shape will not be affected by additional offsets (e.g. agent radius) of the navigation mesh baking process.

---

void append_arrays(vertices: PackedFloat32Array, indices: PackedInt32Array) 🔗

Appends arrays of vertices and indices at the end of the existing arrays. Adds the existing index as an offset to the appended indices.

---

void clear() 🔗

清除內部資料。

---

void clear_projected_obstructions() 🔗

Clears all projected obstructions.

---

AABB get_bounds() 🔗

Returns an axis-aligned bounding box that covers all the stored geometry data. The bounds are calculated when calling this function with the result cached until further geometry changes are made.

---

PackedInt32Array get_indices() const 🔗

返回解析得到的源幾何體資料索引資料。

---

Array get_projected_obstructions() const 🔗

Returns the projected obstructions as an Array of dictionaries. Each Dictionary contains the following entries:

• vertices - A PackedFloat32Array that defines the outline points of the projected shape.

• elevation - A float that defines the projected shape placement on the y-axis.

• height - A float that defines how much the projected shape is extruded along the y-axis.

• carve - A bool that defines how the obstacle affects the navigation mesh baking. If true the projected shape will not be affected by addition offsets, e.g. agent radius.

---

PackedFloat32Array get_vertices() const 🔗

返回解析得到的源幾何體資料頂點資料。

---

bool has_data() 🔗

如果存在解析得到的源幾何體資料，則返回 true。

---

void merge(other_geometry: NavigationMeshSourceGeometryData3D) 🔗

Adds the geometry data of another NavigationMeshSourceGeometryData3D to the navigation mesh baking data.

---

void set_indices(indices: PackedInt32Array) 🔗

設定解析得到的源幾何體資料索引。索引需要與正確的頂點相配對。

警告：資料不正確會導致相關協力廠商庫在烘焙過程中當機。

---

void set_projected_obstructions(projected_obstructions: Array) 🔗

Sets the projected obstructions with an Array of Dictionaries with the following key value pairs:

GDScript

"vertices" : PackedFloat32Array
"elevation" : float
"height" : float
"carve" : bool

---

void set_vertices(vertices: PackedFloat32Array) 🔗

設定解析得到的源幾何體資料頂點。頂點需要與正確的索引相配對。

警告：資料不正確會導致相關協力廠商庫在烘焙過程中當機。