godotengine · smix8 · Dec 16, 2022
@@ -20,6 +20,7 @@
 			<param index="0" name="on_thread" type="bool" default="true" />
 			<description>
 				Bakes the [NavigationMesh]. If [param on_thread] is set to [code]true[/code] (default), the baking is done on a separate thread. Baking on separate thread is useful because navigation baking is not a cheap operation. When it is completed, it automatically sets the new [NavigationMesh]. Please note that baking on separate thread may be very slow if geometry is parsed from meshes as async access to each mesh involves heavy synchronization. Also, please note that baking on a separate thread is automatically disabled on operating systems that cannot use threads (such as Web with threads disabled).
+				[b]Note:[/b] Only functional in Godot builds with NavigationMeshGenerator module enabled.
 			</description>
 		</method>
 		<method name="get_navigation_layer_value" qualifiers="const">

@@ -433,14 +433,6 @@
 				Queries a path in a given navigation map. Start and target position and other parameters are defined through [NavigationPathQueryParameters3D]. Updates the provided [NavigationPathQueryResult3D] result object with the path among other results requested by the query.
 			</description>
 		</method>
-		<method name="region_bake_navigation_mesh" qualifiers="const">
-			<return type="void" />
-			<param index="0" name="navigation_mesh" type="NavigationMesh" />
-			<param index="1" name="root_node" type="Node" />
-			<description>
-				Bakes the [param navigation_mesh] with bake source geometry collected starting from the [param root_node].
-			</description>
-		</method>
 		<method name="region_create" qualifiers="const">
 			<return type="RID" />
 			<description>

@@ -9,30 +9,6 @@ env_navigation = env_modules.Clone()
 
 thirdparty_obj = []
 
-# Recast Thirdparty source files
-if env["builtin_recast"]:
-    thirdparty_dir = "#thirdparty/recastnavigation/Recast/"
-    thirdparty_sources = [
-        "Source/Recast.cpp",
-        "Source/RecastAlloc.cpp",
-        "Source/RecastArea.cpp",
-        "Source/RecastAssert.cpp",
-        "Source/RecastContour.cpp",
-        "Source/RecastFilter.cpp",
-        "Source/RecastLayers.cpp",
-        "Source/RecastMesh.cpp",
-        "Source/RecastMeshDetail.cpp",
-        "Source/RecastRasterization.cpp",
-        "Source/RecastRegion.cpp",
-    ]
-    thirdparty_sources = [thirdparty_dir + file for file in thirdparty_sources]
-
-    env_navigation.Prepend(CPPPATH=[thirdparty_dir + "Include"])
-
-    env_thirdparty = env_navigation.Clone()
-    env_thirdparty.disable_warnings()
-    env_thirdparty.add_source_files(thirdparty_obj, thirdparty_sources)
-
 # RVO Thirdparty source files
 if env["builtin_rvo2"]:
     thirdparty_dir = "#thirdparty/rvo2/"
@@ -57,8 +33,6 @@ env.modules_sources += thirdparty_obj
 module_obj = []
 
 env_navigation.add_source_files(module_obj, "*.cpp")
-if env.editor_build:
-    env_navigation.add_source_files(module_obj, "editor/*.cpp")
 env.modules_sources += module_obj
 
 # Needed to force rebuilding the module files when the thirdparty library is updated.

@@ -32,10 +32,6 @@
 
 #include "core/os/mutex.h"
 
-#ifndef _3D_DISABLED
-#include "navigation_mesh_generator.h"
-#endif
-
 using namespace NavigationUtilities;
 
 /// Creates a struct for each function and a function that once called creates
@@ -430,16 +426,6 @@ COMMAND_2(region_set_navigation_mesh, RID, p_region, Ref<NavigationMesh>, p_navi
 	region->set_mesh(p_navigation_mesh);
 }
 
-void GodotNavigationServer::region_bake_navigation_mesh(Ref<NavigationMesh> p_navigation_mesh, Node *p_root_node) const {
-	ERR_FAIL_COND(p_navigation_mesh.is_null());
-	ERR_FAIL_COND(p_root_node == nullptr);
-
-#ifndef _3D_DISABLED
-	NavigationMeshGenerator::get_singleton()->clear(p_navigation_mesh);
-	NavigationMeshGenerator::get_singleton()->bake(p_navigation_mesh, p_root_node);
-#endif
-}
-
 int GodotNavigationServer::region_get_connections_count(RID p_region) const {
 	NavRegion *region = region_owner.get_or_null(p_region);
 	ERR_FAIL_COND_V(!region, 0);

@@ -136,7 +136,6 @@ class GodotNavigationServer : public NavigationServer3D {
 	virtual uint32_t region_get_navigation_layers(RID p_region) const override;
 	COMMAND_2(region_set_transform, RID, p_region, Transform3D, p_transform);
 	COMMAND_2(region_set_navigation_mesh, RID, p_region, Ref<NavigationMesh>, p_navigation_mesh);
-	virtual void region_bake_navigation_mesh(Ref<NavigationMesh> p_navigation_mesh, Node *p_root_node) const override;
 	virtual int region_get_connections_count(RID p_region) const override;
 	virtual Vector3 region_get_connection_pathway_start(RID p_region, int p_connection_id) const override;
 	virtual Vector3 region_get_connection_pathway_end(RID p_region, int p_connection_id) const override;

@@ -30,22 +30,8 @@
 
 #include "register_types.h"
 
-#include "core/config/engine.h"
-#include "servers/navigation_server_3d.h"
-
 #include "godot_navigation_server.h"
-
-#ifndef _3D_DISABLED
-#include "navigation_mesh_generator.h"
-#endif
-
-#ifdef TOOLS_ENABLED
-#include "editor/navigation_mesh_editor_plugin.h"
-#endif
-
-#ifndef _3D_DISABLED
-NavigationMeshGenerator *_nav_mesh_generator = nullptr;
-#endif
+#include "servers/navigation_server_3d.h"
 
 NavigationServer3D *new_server() {
 	return memnew(GodotNavigationServer);
@@ -54,29 +40,8 @@ NavigationServer3D *new_server() {
 void initialize_navigation_module(ModuleInitializationLevel p_level) {
 	if (p_level == MODULE_INITIALIZATION_LEVEL_SERVERS) {
 		NavigationServer3DManager::set_default_server(new_server);
-
-#ifndef _3D_DISABLED
-		_nav_mesh_generator = memnew(NavigationMeshGenerator);
-		GDREGISTER_CLASS(NavigationMeshGenerator);
-		Engine::get_singleton()->add_singleton(Engine::Singleton("NavigationMeshGenerator", NavigationMeshGenerator::get_singleton()));
-#endif
-	}
-
-#ifdef TOOLS_ENABLED
-	if (p_level == MODULE_INITIALIZATION_LEVEL_EDITOR) {
-		EditorPlugins::add_by_type<NavigationMeshEditorPlugin>();
 	}
-#endif
 }
 
 void uninitialize_navigation_module(ModuleInitializationLevel p_level) {
-	if (p_level != MODULE_INITIALIZATION_LEVEL_SERVERS) {
-		return;
-	}
-
-#ifndef _3D_DISABLED
-	if (_nav_mesh_generator) {
-		memdelete(_nav_mesh_generator);
-	}
-#endif
 }
@@ -0,0 +1,48 @@
+#!/usr/bin/env python
+
+Import("env")
+Import("env_modules")
+
+env_navigation_mesh_generator = env_modules.Clone()
+
+# Thirdparty source files
+
+thirdparty_obj = []
+
+# Recast Thirdparty source files
+if env["builtin_recast"]:
+    thirdparty_dir = "#thirdparty/recastnavigation/Recast/"
+    thirdparty_sources = [
+        "Source/Recast.cpp",
+        "Source/RecastAlloc.cpp",
+        "Source/RecastArea.cpp",
+        "Source/RecastAssert.cpp",
+        "Source/RecastContour.cpp",
+        "Source/RecastFilter.cpp",
+        "Source/RecastLayers.cpp",
+        "Source/RecastMesh.cpp",
+        "Source/RecastMeshDetail.cpp",
+        "Source/RecastRasterization.cpp",
+        "Source/RecastRegion.cpp",
+    ]
+    thirdparty_sources = [thirdparty_dir + file for file in thirdparty_sources]
+
+    env_navigation_mesh_generator.Prepend(CPPPATH=[thirdparty_dir + "Include"])
+
+    env_thirdparty = env_navigation_mesh_generator.Clone()
+    env_thirdparty.disable_warnings()
+    env_thirdparty.add_source_files(thirdparty_obj, thirdparty_sources)
+
+env.modules_sources += thirdparty_obj
+
+# Godot source files
+
+module_obj = []
+
+env_navigation_mesh_generator.add_source_files(module_obj, "*.cpp")
+if env.editor_build:
+    env_navigation_mesh_generator.add_source_files(module_obj, "editor/*.cpp")
+env.modules_sources += module_obj
+
+# Needed to force rebuilding the module files when the thirdparty library is updated.
+env.Depends(module_obj, thirdparty_obj)
@@ -0,0 +1,16 @@
+def can_build(env, platform):
+    return True
+
+
+def configure(env):
+    pass
+
+
+def get_doc_classes():
+    return [
+        "NavigationMeshGenerator",
+    ]
+
+
+def get_doc_path():
+    return "doc_classes"
diff --git a/doc/classes/NavigationMeshGenerator.xml → ...r/doc_classes/NavigationMeshGenerator.xml b/doc/classes/NavigationMeshGenerator.xml → ...r/doc_classes/NavigationMeshGenerator.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" ?>
-<class name="NavigationMeshGenerator" inherits="Object" is_experimental="true" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
+<class name="NavigationMeshGenerator" inherits="Object" is_experimental="true" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../doc/class.xsd">
 	<brief_description>
 		Helper class for creating and clearing navigation meshes.
 	</brief_description>

@@ -0,0 +1,5 @@
+#!/usr/bin/env python
+
+Import("env")
+
+env.add_source_files(env.editor_sources, "*.cpp")
diff --git a/.../editor/navigation_mesh_editor_plugin.cpp → .../editor/navigation_mesh_editor_plugin.cpp b/.../editor/navigation_mesh_editor_plugin.cpp → .../editor/navigation_mesh_editor_plugin.cpp
@@ -37,6 +37,7 @@
 #include "core/io/resource_saver.h"
 #include "editor/editor_node.h"
 #include "scene/3d/mesh_instance_3d.h"
+#include "scene/3d/navigation_region_3d.h"
 #include "scene/gui/box_container.h"
 
 void NavigationMeshEditor::_node_removed(Node *p_node) {

diff --git a/...on/editor/navigation_mesh_editor_plugin.h → ...or/editor/navigation_mesh_editor_plugin.h b/...on/editor/navigation_mesh_editor_plugin.h → ...or/editor/navigation_mesh_editor_plugin.h
diff --git a/.../navigation/navigation_mesh_generator.cpp → ...h_generator/navigation_mesh_generator.cpp b/.../navigation/navigation_mesh_generator.cpp → ...h_generator/navigation_mesh_generator.cpp
@@ -28,12 +28,12 @@
 /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.                */
 /*************************************************************************/
 
-#ifndef _3D_DISABLED
-
 #include "navigation_mesh_generator.h"
 
 #include "core/math/convex_hull.h"
 #include "core/os/thread.h"
+
+#ifndef _3D_DISABLED
 #include "scene/3d/mesh_instance_3d.h"
 #include "scene/3d/multimesh_instance_3d.h"
 #include "scene/3d/physics_body_3d.h"
@@ -60,9 +60,21 @@
 #ifdef MODULE_GRIDMAP_ENABLED
 #include "modules/gridmap/grid_map.h"
 #endif
+#endif // _3D_DISABLED
 
 NavigationMeshGenerator *NavigationMeshGenerator::singleton = nullptr;
 
+NavigationMeshGenerator *NavigationMeshGenerator::get_singleton() {
+	return singleton;
+}
+
+NavigationMeshGenerator::NavigationMeshGenerator() {
+	singleton = this;
+}
+
+NavigationMeshGenerator::~NavigationMeshGenerator() {
+}
+
 void NavigationMeshGenerator::_add_vertex(const Vector3 &p_vec3, Vector<float> &p_vertices) {
 	p_vertices.push_back(p_vec3.x);
 	p_vertices.push_back(p_vec3.y);
@@ -162,6 +174,7 @@ void NavigationMeshGenerator::_add_faces(const PackedVector3Array &p_faces, cons
 }
 
 void NavigationMeshGenerator::_parse_geometry(const Transform3D &p_navmesh_transform, Node *p_node, Vector<float> &p_vertices, Vector<int> &p_indices, NavigationMesh::ParsedGeometryType p_generate_from, uint32_t p_collision_mask, bool p_recurse_children) {
+#ifndef _3D_DISABLED
 	if (Object::cast_to<MeshInstance3D>(p_node) && p_generate_from != NavigationMesh::PARSED_GEOMETRY_STATIC_COLLIDERS) {
 		MeshInstance3D *mesh_instance = Object::cast_to<MeshInstance3D>(p_node);
 		Ref<Mesh> mesh = mesh_instance->get_mesh();
@@ -468,8 +481,10 @@ void NavigationMeshGenerator::_parse_geometry(const Transform3D &p_navmesh_trans
 			_parse_geometry(p_navmesh_transform, p_node->get_child(i), p_vertices, p_indices, p_generate_from, p_collision_mask, p_recurse_children);
 		}
 	}
+#endif // _3D_DISABLED
 }
 
+#ifndef _3D_DISABLED
 void NavigationMeshGenerator::_convert_detail_mesh_to_native_navigation_mesh(const rcPolyMeshDetail *p_detail_mesh, Ref<NavigationMesh> p_navigation_mesh) {
 	Vector<Vector3> nav_vertices;
 
@@ -496,7 +511,9 @@ void NavigationMeshGenerator::_convert_detail_mesh_to_native_navigation_mesh(con
 		}
 	}
 }
+#endif // _3D_DISABLED
 
+#ifndef _3D_DISABLED
 void NavigationMeshGenerator::_build_recast_navigation_mesh(
 		Ref<NavigationMesh> p_navigation_mesh,
 #ifdef TOOLS_ENABLED
@@ -717,20 +734,11 @@ void NavigationMeshGenerator::_build_recast_navigation_mesh(
 	rcFreePolyMeshDetail(detail_mesh);
 	detail_mesh = nullptr;
 }
-
-NavigationMeshGenerator *NavigationMeshGenerator::get_singleton() {
-	return singleton;
-}
-
-NavigationMeshGenerator::NavigationMeshGenerator() {
-	singleton = this;
-}
-
-NavigationMeshGenerator::~NavigationMeshGenerator() {
-}
+#endif // _3D_DISABLED
 
 void NavigationMeshGenerator::bake(Ref<NavigationMesh> p_navigation_mesh, Node *p_root_node) {
 	ERR_FAIL_COND_MSG(!p_navigation_mesh.is_valid(), "Invalid navigation mesh.");
+#ifndef _3D_DISABLED
 
 #ifdef TOOLS_ENABLED
 	EditorProgress *ep(nullptr);
@@ -813,7 +821,8 @@ void NavigationMeshGenerator::bake(Ref<NavigationMesh> p_navigation_mesh, Node *
 	if (ep) {
 		memdelete(ep);
 	}
-#endif
+#endif // TOOLS_ENABLED
+#endif // _3D_DISABLED
 }
 
 void NavigationMeshGenerator::clear(Ref<NavigationMesh> p_navigation_mesh) {
@@ -827,5 +836,3 @@ void NavigationMeshGenerator::_bind_methods() {
 	ClassDB::bind_method(D_METHOD("bake", "navigation_mesh", "root_node"), &NavigationMeshGenerator::bake);
 	ClassDB::bind_method(D_METHOD("clear", "navigation_mesh"), &NavigationMeshGenerator::clear);
 }
-
-#endif
diff --git a/...es/navigation/navigation_mesh_generator.h → ...esh_generator/navigation_mesh_generator.h b/...es/navigation/navigation_mesh_generator.h → ...esh_generator/navigation_mesh_generator.h
@@ -31,11 +31,12 @@
 #ifndef NAVIGATION_MESH_GENERATOR_H
 #define NAVIGATION_MESH_GENERATOR_H
 
+#include "scene/resources/navigation_mesh.h"
 #ifndef _3D_DISABLED
-
-#include "scene/3d/navigation_region_3d.h"
-
 #include <Recast.h>
+#else
+#include "scene/main/node.h"
+#endif // _3D_DISABLED
 
 #ifdef TOOLS_ENABLED
 struct EditorProgress;
@@ -55,6 +56,7 @@ class NavigationMeshGenerator : public Object {
 	static void _add_faces(const PackedVector3Array &p_faces, const Transform3D &p_xform, Vector<float> &p_vertices, Vector<int> &p_indices);
 	static void _parse_geometry(const Transform3D &p_navmesh_transform, Node *p_node, Vector<float> &p_vertices, Vector<int> &p_indices, NavigationMesh::ParsedGeometryType p_generate_from, uint32_t p_collision_mask, bool p_recurse_children);
 
+#ifndef _3D_DISABLED
 	static void _convert_detail_mesh_to_native_navigation_mesh(const rcPolyMeshDetail *p_detail_mesh, Ref<NavigationMesh> p_navigation_mesh);
 	static void _build_recast_navigation_mesh(
 			Ref<NavigationMesh> p_navigation_mesh,
@@ -68,6 +70,7 @@ class NavigationMeshGenerator : public Object {
 			rcPolyMeshDetail *detail_mesh,
 			Vector<float> &vertices,
 			Vector<int> &indices);
+#endif // _3D_DISABLED
 
 public:
 	static NavigationMeshGenerator *get_singleton();
@@ -79,6 +82,4 @@ class NavigationMeshGenerator : public Object {
 	void clear(Ref<NavigationMesh> p_navigation_mesh);
 };
 
-#endif
-
 #endif // NAVIGATION_MESH_GENERATOR_H