godot/modules/navigation_3d/nav_map_3d.h

/**************************************************************************/
/*  nav_map_3d.h                                                          */
/**************************************************************************/
/*                         This file is part of:                          */
/*                             GODOT ENGINE                               */
/*                        https://godotengine.org                         */
/**************************************************************************/
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur.                  */
/*                                                                        */
/* Permission is hereby granted, free of charge, to any person obtaining  */
/* a copy of this software and associated documentation files (the        */
/* "Software"), to deal in the Software without restriction, including    */
/* without limitation the rights to use, copy, modify, merge, publish,    */
/* distribute, sublicense, and/or sell copies of the Software, and to     */
/* permit persons to whom the Software is furnished to do so, subject to  */
/* the following conditions:                                              */
/*                                                                        */
/* The above copyright notice and this permission notice shall be         */
/* included in all copies or substantial portions of the Software.        */
/*                                                                        */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,        */
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF     */
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY   */
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,   */
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE      */
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.                 */
/**************************************************************************/

#pragma once

#include "3d/nav_map_iteration_3d.h"
#include "3d/nav_mesh_queries_3d.h"
#include "nav_rid_3d.h"
#include "nav_utils_3d.h"

#include "core/math/math_defs.h"
#include "core/object/worker_thread_pool.h"
#include "servers/navigation/navigation_globals.h"

#include <KdTree2d.h>
#include <KdTree3d.h>
#include <RVOSimulator2d.h>
#include <RVOSimulator3d.h>

class NavLink3D;
class NavRegion3D;
class NavAgent3D;
class NavObstacle3D;

class NavMap3D : public NavRid3D {
	/// Map Up
	Vector3 up = Vector3(0, 1, 0);

	/// To find the polygons edges the vertices are displaced in a grid where
	/// each cell has the following cell_size and cell_height.
	real_t cell_size = NavigationDefaults3D::navmesh_cell_size;
	real_t cell_height = NavigationDefaults3D::navmesh_cell_height;

	// For the inter-region merging to work, internal rasterization is performed.
	Vector3 merge_rasterizer_cell_size = Vector3(cell_size, cell_height, cell_size);

	// This value is used to control sensitivity of internal rasterizer.
	float merge_rasterizer_cell_scale = 1.0;

	bool use_edge_connections = true;
	/// This value is used to detect the near edges to connect.
	real_t edge_connection_margin = NavigationDefaults3D::edge_connection_margin;

	/// This value is used to limit how far links search to find polygons to connect to.
	real_t link_connection_radius = NavigationDefaults3D::link_connection_radius;

	bool map_settings_dirty = true;

	/// Map regions
	LocalVector<NavRegion3D *> regions;

	/// Map links
	LocalVector<NavLink3D *> links;

	/// RVO avoidance worlds
	RVO2D::RVOSimulator2D rvo_simulation_2d;
	RVO3D::RVOSimulator3D rvo_simulation_3d;

	/// avoidance controlled agents
	LocalVector<NavAgent3D *> active_2d_avoidance_agents;
	LocalVector<NavAgent3D *> active_3d_avoidance_agents;

	/// dirty flag when one of the agent's arrays are modified
	bool agents_dirty = true;

	/// All the Agents (even the controlled one)
	LocalVector<NavAgent3D *> agents;

	/// All the avoidance obstacles (both static and dynamic)
	LocalVector<NavObstacle3D *> obstacles;

	/// Are rvo obstacles modified?
	bool obstacles_dirty = true;

	/// Physics delta time
	real_t deltatime = 0.0;

	/// Change the id each time the map is updated.
	uint32_t iteration_id = 0;

	bool use_threads = true;
	bool avoidance_use_multiple_threads = true;
	bool avoidance_use_high_priority_threads = true;

	// Performance Monitor
	Nav3D::PerformanceData performance_data;

	struct {
		SelfList<NavRegion3D>::List regions;
		SelfList<NavLink3D>::List links;
		SelfList<NavAgent3D>::List agents;
		SelfList<NavObstacle3D>::List obstacles;
	} sync_dirty_requests;

	int path_query_slots_max = 4;

	bool use_async_iterations = true;

	uint32_t iteration_slot_index = 0;
	LocalVector<NavMapIteration3D> iteration_slots;
	mutable RWLock iteration_slot_rwlock;

	NavMapIterationBuild3D iteration_build;
	bool iteration_build_use_threads = false;
	WorkerThreadPool::TaskID iteration_build_thread_task_id = WorkerThreadPool::INVALID_TASK_ID;
	static void _build_iteration_threaded(void *p_arg);

	bool iteration_dirty = true;
	bool iteration_building = false;
	bool iteration_ready = false;

	void _build_iteration();
	void _sync_iteration();

public:
	NavMap3D();
	~NavMap3D();

	uint32_t get_iteration_id() const { return iteration_id; }

	void set_up(Vector3 p_up);
	Vector3 get_up() const {
		return up;
	}

	void set_cell_size(real_t p_cell_size);
	real_t get_cell_size() const {
		return cell_size;
	}

	void set_cell_height(real_t p_cell_height);
	real_t get_cell_height() const { return cell_height; }

	void set_merge_rasterizer_cell_scale(float p_value);
	float get_merge_rasterizer_cell_scale() const {
		return merge_rasterizer_cell_scale;
	}

	void set_use_edge_connections(bool p_enabled);
	bool get_use_edge_connections() const {
		return use_edge_connections;
	}

	void set_edge_connection_margin(real_t p_edge_connection_margin);
	real_t get_edge_connection_margin() const {
		return edge_connection_margin;
	}

	void set_link_connection_radius(real_t p_link_connection_radius);
	real_t get_link_connection_radius() const {
		return link_connection_radius;
	}

	Nav3D::PointKey get_point_key(const Vector3 &p_pos) const;
	const Vector3 &get_merge_rasterizer_cell_size() const;

	void query_path(NavMeshQueries3D::NavMeshPathQueryTask3D &p_query_task);

	Vector3 get_closest_point_to_segment(const Vector3 &p_from, const Vector3 &p_to, const bool p_use_collision) const;
	Vector3 get_closest_point(const Vector3 &p_point) const;
	Vector3 get_closest_point_normal(const Vector3 &p_point) const;
	Nav3D::ClosestPointQueryResult get_closest_point_info(const Vector3 &p_point) const;
	RID get_closest_point_owner(const Vector3 &p_point) const;

	void add_region(NavRegion3D *p_region);
	void remove_region(NavRegion3D *p_region);
	const LocalVector<NavRegion3D *> &get_regions() const {
		return regions;
	}

	void add_link(NavLink3D *p_link);
	void remove_link(NavLink3D *p_link);
	const LocalVector<NavLink3D *> &get_links() const {
		return links;
	}

	bool has_agent(NavAgent3D *agent) const;
	void add_agent(NavAgent3D *agent);
	void remove_agent(NavAgent3D *agent);
	const LocalVector<NavAgent3D *> &get_agents() const {
		return agents;
	}

	void set_agent_as_controlled(NavAgent3D *agent);
	void remove_agent_as_controlled(NavAgent3D *agent);

	bool has_obstacle(NavObstacle3D *obstacle) const;
	void add_obstacle(NavObstacle3D *obstacle);
	void remove_obstacle(NavObstacle3D *obstacle);
	const LocalVector<NavObstacle3D *> &get_obstacles() const {
		return obstacles;
	}

	Vector3 get_random_point(uint32_t p_navigation_layers, bool p_uniformly) const;

	void sync();
	void step(real_t p_deltatime);
	void dispatch_callbacks();

	// Performance Monitor
	int get_pm_region_count() const { return performance_data.pm_region_count; }
	int get_pm_agent_count() const { return performance_data.pm_agent_count; }
	int get_pm_link_count() const { return performance_data.pm_link_count; }
	int get_pm_polygon_count() const { return performance_data.pm_polygon_count; }
	int get_pm_edge_count() const { return performance_data.pm_edge_count; }
	int get_pm_edge_merge_count() const { return performance_data.pm_edge_merge_count; }
	int get_pm_edge_connection_count() const { return performance_data.pm_edge_connection_count; }
	int get_pm_edge_free_count() const { return performance_data.pm_edge_free_count; }
	int get_pm_obstacle_count() const { return performance_data.pm_obstacle_count; }

	int get_region_connections_count(NavRegion3D *p_region) const;
	Vector3 get_region_connection_pathway_start(NavRegion3D *p_region, int p_connection_id) const;
	Vector3 get_region_connection_pathway_end(NavRegion3D *p_region, int p_connection_id) const;

	void add_region_sync_dirty_request(SelfList<NavRegion3D> *p_sync_request);
	void add_link_sync_dirty_request(SelfList<NavLink3D> *p_sync_request);
	void add_agent_sync_dirty_request(SelfList<NavAgent3D> *p_sync_request);
	void add_obstacle_sync_dirty_request(SelfList<NavObstacle3D> *p_sync_request);

	void remove_region_sync_dirty_request(SelfList<NavRegion3D> *p_sync_request);
	void remove_link_sync_dirty_request(SelfList<NavLink3D> *p_sync_request);
	void remove_agent_sync_dirty_request(SelfList<NavAgent3D> *p_sync_request);
	void remove_obstacle_sync_dirty_request(SelfList<NavObstacle3D> *p_sync_request);

	void set_use_async_iterations(bool p_enabled);
	bool get_use_async_iterations() const;

private:
	void _sync_dirty_map_update_requests();
	void _sync_dirty_avoidance_update_requests();

	void compute_single_step(uint32_t index, NavAgent3D **agent);

	void compute_single_avoidance_step_2d(uint32_t index, NavAgent3D **agent);
	void compute_single_avoidance_step_3d(uint32_t index, NavAgent3D **agent);

	void _sync_avoidance();
	void _update_rvo_simulation();
	void _update_rvo_obstacles_tree_2d();
	void _update_rvo_agents_tree_2d();
	void _update_rvo_agents_tree_3d();

	void _update_merge_rasterizer_cell_dimensions();
};