Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Integrated the new NavigationServer and NavigationServer2D #34776

Merged
merged 2 commits into from
Feb 10, 2020
Merged

Integrated the new NavigationServer and NavigationServer2D #34776

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e6be3f6
- Integrated NavigationServer and Navigation2DServer.
AndreaCatania Jan 10, 2020
383c583
Documented the new NavigationServer and all its associated nodes (2D …
Duroxxigar Feb 10, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions COPYRIGHT.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -332,6 +332,11 @@ Comment: Recast
Copyright: 2009, Mikko Mononen
License: Zlib

Files: ./thirdparty/rvo2/
Comment: RVO2
Copyright: 2016, University of North Carolina at Chapel Hill
License: Apache 2.0

Files: ./thirdparty/squish/
Comment: libSquish
Copyright: 2006, Simon Brown
Expand Down
1 change: 1 addition & 0 deletions SConstruct
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -152,6 +152,7 @@ opts.Add(BoolVariable('builtin_opus', "Use the built-in Opus library", True))
opts.Add(BoolVariable('builtin_pcre2', "Use the built-in PCRE2 library", True))
opts.Add(BoolVariable('builtin_pcre2_with_jit', "Use JIT compiler for the built-in PCRE2 library", True))
opts.Add(BoolVariable('builtin_recast', "Use the built-in Recast library", True))
opts.Add(BoolVariable('builtin_rvo2', "Use the built-in RVO2 library", True))
opts.Add(BoolVariable('builtin_squish', "Use the built-in squish library", True))
opts.Add(BoolVariable('builtin_xatlas', "Use the built-in xatlas library", True))
opts.Add(BoolVariable('builtin_zlib', "Use the built-in zlib library", True))
Expand Down
274 changes: 274 additions & 0 deletions doc/classes/Navigation2DServer.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,274 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="Navigation2DServer" inherits="Object" category="Core" version="3.2">
<brief_description>
Server interface for low-level 2D navigation access
</brief_description>
<description>
Navigation2DServer is the server responsible for all 2D navigation. It creates the agents, maps, and regions for navigation to work as expected. This keeps tracks of any call and executes them during the sync phase. This means that you can request any change to the map, using any thread, without worrying.
</description>
<tutorials>
</tutorials>
<methods>
<method name="agent_create" qualifiers="const">
<return type="RID">
</return>
<description>
Creates the agent.
</description>
</method>
<method name="agent_is_map_changed">
<return type="bool" qualifiers="const">
</return>
<argument index="0" name="agent" type="RID">
</argument>
<description>
Returns true if the map got changed the previous frame.
</description>
</method>
<method name="agent_set_callback" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="agent" type="RID">
</argument>
<argument index="1" name="receiver" type="Object">
</argument>
<argument index="2" name="method" type="String">
</argument>
<argument index="3" name="userdata" type="Variant" default="null">
</argument>
<description>
Callback called at the end of the RVO process.
</description>
</method>
<method name="agent_set_map" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="agent" type="RID">
</argument>
<argument index="1" name="map" type="RID">
</argument>
<description>
Puts the agent in the map.
</description>
</method>
<method name="agent_set_max_neighbors" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="agent" type="RID">
</argument>
<argument index="1" name="count" type="int">
</argument>
<description>
Sets the maximum number of other agents the agent takes into account in the navigation. The larger this number, the longer the running time of the simulation. If the number is too low, the simulation will not be safe.
</description>
</method>
<method name="agent_set_max_speed" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="agent" type="RID">
</argument>
<argument index="1" name="max_speed" type="float">
</argument>
<description>
Sets the maximum speed of the agent. Must be positive.
</description>
</method>
<method name="agent_set_neighbor_dist" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="agent" type="RID">
</argument>
<argument index="1" name="dist" type="float">
</argument>
<description>
Sets the maximum distance to other agents this agent takes into account in the navigation. The larger this number, the longer the running time of the simulation. If the number is too low, the simulation will not be safe.
</description>
</method>
<method name="agent_set_position" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="agent" type="RID">
</argument>
<argument index="1" name="position" type="Vector3">
</argument>
<description>
Sets the position of the agent in world space.
</description>
</method>
<method name="agent_set_radius" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="agent" type="RID">
</argument>
<argument index="1" name="radius" type="float">
</argument>
<description>
Sets the radius of the agent.
</description>
</method>
<method name="agent_set_target_velocity" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="agent" type="RID">
</argument>
<argument index="1" name="target_velocity" type="Vector3">
</argument>
<description>
Sets the new target velocity.
</description>
</method>
<method name="agent_set_time_horizon" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="agent" type="RID">
</argument>
<argument index="1" name="time" type="float">
</argument>
<description>
The minimal amount of time for which the agent's velocities that are computed by the simulation are safe with respect to other agents. The larger this number, the sooner this agent will respond to the presence of other agents, but the less freedom this agent has in choosing its velocities. Must be positive.
</description>
</method>
<method name="agent_set_velocity" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="agent" type="RID">
</argument>
<argument index="1" name="velocity" type="Vector3">
</argument>
<description>
Sets the current velocity of the agent.
</description>
</method>
<method name="free" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="object" type="RID">
</argument>
<description>
Destroy the RID
</description>
</method>
<method name="map_create" qualifiers="const">
<return type="RID">
</return>
<description>
Create a new map.
</description>
</method>
<method name="map_get_cell_size">
<return type="float">
</return>
<argument index="0" name="map" type="RID">
</argument>
<description>
Returns the map cell size.
</description>
</method>
<method name="map_get_edge_connection_margin" qualifiers="const">
<return type="float">
</return>
<argument index="0" name="map" type="RID">
</argument>
<description>
Returns the edge connection margin of the map. The edge connection margin is a distance used to connect two regions.
</description>
</method>
<method name="map_get_path" qualifiers="const">
<return type="PoolVector2Array">
</return>
<argument index="0" name="map" type="RID">
</argument>
<argument index="1" name="origin" type="Vector2">
</argument>
<argument index="2" name="destination" type="Vector2">
</argument>
<argument index="3" name="optimize" type="bool">
</argument>
<description>
Returns the navigation path to reach the destination from the origin, while avoiding static obstacles.
</description>
</method>
<method name="map_is_active" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="map" type="RID">
</argument>
<description>
Returns true if the map is active.
</description>
</method>
<method name="map_set_active" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="map" type="RID">
</argument>
<argument index="1" name="active" type="bool">
</argument>
<description>
Sets the map active.
</description>
</method>
<method name="map_set_cell_size" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="map" type="RID">
</argument>
<argument index="1" name="cell_size" type="float">
</argument>
<description>
Set the map cell size used to weld the navigation mesh polygons.
</description>
</method>
<method name="map_set_edge_connection_margin" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="map" type="RID">
</argument>
<argument index="1" name="margin" type="float">
</argument>
<description>
Set the map edge connection margin used to weld the compatible region edges.
</description>
</method>
<method name="region_create" qualifiers="const">
<return type="RID">
</return>
<description>
Creates a new region.
</description>
</method>
<method name="region_set_map" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="region" type="RID">
</argument>
<argument index="1" name="map" type="RID">
</argument>
<description>
Sets the map for the region.
</description>
</method>
<method name="region_set_navpoly" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="region" type="RID">
</argument>
<argument index="1" name="nav_poly" type="NavigationPolygon">
</argument>
<description>
Sets the navigation mesh for the region.
</description>
</method>
<method name="region_set_transform" qualifiers="const">
<return type="void">
</return>
<argument index="0" name="region" type="RID">
</argument>
<argument index="1" name="transform" type="Transform">
</argument>
<description>
Sets the global transformation for the region.
</description>
</method>
</methods>
</class>
Loading