From fe56b4c6b5b77a10595ffd84fe44be67ade570c1 Mon Sep 17 00:00:00 2001 From: Relintai Date: Tue, 13 Jun 2023 18:19:02 +0200 Subject: [PATCH] Fixed up the remaining newly extracted class doc xmls. --- doc/classes/Navigation2DServer.xml | 48 +++++---- doc/classes/NavigationAgent.xml | 48 ++++----- doc/classes/NavigationAgent2D.xml | 56 +++++------ doc/classes/NavigationGeometryParser2D.xml | 8 +- doc/classes/NavigationGeometryParser3D.xml | 8 +- doc/classes/NavigationLink2D.xml | 8 +- doc/classes/NavigationLink3D.xml | 8 +- doc/classes/NavigationMesh.xml | 34 ++----- doc/classes/NavigationMeshGenerator.xml | 16 +-- .../NavigationMeshSourceGeometryData2D.xml | 4 +- .../NavigationMeshSourceGeometryData3D.xml | 10 +- doc/classes/NavigationObstacle.xml | 18 ++-- doc/classes/NavigationObstacle2D.xml | 21 +--- .../NavigationPathQueryParameters2D.xml | 38 +++---- .../NavigationPathQueryParameters3D.xml | 35 +++---- doc/classes/NavigationPathQueryResult2D.xml | 10 +- doc/classes/NavigationPathQueryResult3D.xml | 10 +- doc/classes/NavigationPolygon.xml | 99 ++++++++++--------- doc/classes/NavigationPolygonInstance.xml | 32 +++--- doc/classes/NavigationServer.xml | 33 ++++--- 20 files changed, 258 insertions(+), 286 deletions(-) diff --git a/doc/classes/Navigation2DServer.xml b/doc/classes/Navigation2DServer.xml index d6bc9320a..f2b0754e7 100644 --- a/doc/classes/Navigation2DServer.xml +++ b/doc/classes/Navigation2DServer.xml @@ -1,5 +1,5 @@ - + Server interface for low-level 2D navigation access. @@ -458,6 +458,22 @@ Set the map edge connection margin used to weld the compatible region edges. + + + + + + Set the map's link connection radius used to connect links to navigation polygons. + + + + + + + + Set the navigation [param map] edge connection use. If [param enabled] the navigation map allows navigation regions to use edge connections to connect with other navigation regions within proximity of the navigation map edge connection margin. + + @@ -502,30 +518,6 @@ Sets the outline vertices for the obstacle. If the vertices are winded in clockwise order agents will be pushed in by the obstacle, else they will be pushed out. - - - - - - Queries a path in a given navigation map. Start and target position and other parameters are defined through [NavigationPathQueryParameters2D]. Updates the provided [NavigationPathQueryResult2D] result object with the path among other results requested by the query. - - - - - - - - Set the map's link connection radius used to connect links to navigation polygons. - - - - - - - - Set the navigation [param map] edge connection use. If [param enabled] the navigation map allows navigation regions to use edge connections to connect with other navigation regions within proximity of the navigation map edge connection margin. - - @@ -671,6 +663,12 @@ If [param enabled] the navigation [param region] will use edge connections to connect with other navigation regions within proximity of the navigation map edge connection margin. + + + + + + diff --git a/doc/classes/NavigationAgent.xml b/doc/classes/NavigationAgent.xml index 090e5a824..ac6332421 100644 --- a/doc/classes/NavigationAgent.xml +++ b/doc/classes/NavigationAgent.xml @@ -1,5 +1,5 @@ - + 3D agent used in navigation for collision avoidance. @@ -30,18 +30,6 @@ Returns whether or not the specified mask of the [member avoidance_mask] bitmask is enabled, given a [param mask_number] between 1 and 32. - - - - Returns the path query result for the path the agent is currently following. - - - - - - Returns the reachable final position of the current navigation path in global coordinates. This position can change if the navigation path is altered in any way. Because of this, it would be best to check this each frame. - - @@ -54,6 +42,18 @@ Returns which index the agent is currently on in the navigation path's [PoolVector3Array]. + + + + Returns the path query result for the path the agent is currently following. + + + + + + Returns the reachable final position of the current navigation path in global coordinates. This position can change if the navigation path is altered in any way. Because of this, it would be best to check this each frame. + + @@ -103,13 +103,6 @@ Returns [code]true[/code] if [member target_position] is reached. It may not always be possible to reach the target position. It should always be possible to reach the final position though. See [method get_final_position]. - - - - - Sets the [Navigation] node used by the agent. Useful when you don't want to make the agent a child of a [Navigation] node. - - @@ -126,6 +119,13 @@ Based on [param value], enables or disables the specified mask in the [member avoidance_mask] bitmask, given a [param mask_number] between 1 and 32. + + + + + Sets the [Navigation] node used by the agent. Useful when you don't want to make the agent a child of a [Navigation] node. + + @@ -165,7 +165,7 @@ If [code]true[/code] shows debug visuals for this agent. - + If [member debug_use_custom] is [code]true[/code] uses this color for this agent instead of global color. @@ -186,7 +186,7 @@ A bitfield determining all navigation map layers the [NavigationAgent] belongs to. On path requests the agent will ignore navmeshes without at least one matching layer. - + The distance to search for other agents. @@ -198,7 +198,7 @@ The maximum distance the agent is allowed away from the ideal path to the final position. This can happen due to trying to avoid collisions. When the maximum distance is exceeded, it recalculates the ideal path. - + Additional information to return with the navigation path. @@ -221,7 +221,7 @@ If [code]true[/code] the agent calculates avoidance velocities in 3D for the xyz-axis, e.g. for games that take place in air, unterwater or space. The 3D using agent only avoids other 3D avoidance using agent's. The 3D using agent only reacts to radius based avoidance obstacles. The 3D using agent ignores any vertices based obstacles. The 3D using agent only avoids other 3D using agent's. If [code]false[/code] the agent calculates avoidance velocities in 2D along the xz-axis ignoring the y-axis. The 2D using agent only avoids other 2D avoidance using agent's. The 2D using agent reacts to radius avoidance obstacles. The 2D using agent reacts to vertices based avoidance obstacles. The 2D using agent only avoids other 2D using agent's. 2D using agents will ignore other 2D using agents or obstacles that are below their current position or above their current position including [member height] in 2D avoidance. - + Sets the new wanted velocity for the agent. The avoidance simulation will try to fulfil this velocity if possible but will modify it to avoid collision with other agent's and obstacles. When an agent is teleported to a new position use [method set_velocity_forced] as well to reset the internal simulation velocity. diff --git a/doc/classes/NavigationAgent2D.xml b/doc/classes/NavigationAgent2D.xml index ee357b887..1e32b542a 100644 --- a/doc/classes/NavigationAgent2D.xml +++ b/doc/classes/NavigationAgent2D.xml @@ -1,5 +1,5 @@ - + 2D agent used in navigation for collision avoidance. @@ -30,18 +30,6 @@ Returns whether or not the specified mask of the [member avoidance_mask] bitmask is enabled, given a [param mask_number] between 1 and 32. - - - - Returns the path query result for the path the agent is currently following. - - - - - - Returns the reachable final position of the current navigation path in global coordinates. This can change if the navigation path is altered in any way. Because of this, it would be best to check this each frame. - - @@ -54,6 +42,18 @@ Returns which index the agent is currently on in the navigation path's [PoolVector2Array]. + + + + Returns the path query result for the path the agent is currently following. + + + + + + Returns the reachable final position of the current navigation path in global coordinates. This can change if the navigation path is altered in any way. Because of this, it would be best to check this each frame. + + @@ -103,13 +103,6 @@ Returns [code]true[/code] if [member target_position] is reached. It may not always be possible to reach the target position. It should always be possible to reach the final position though. See [method get_final_position]. - - - - - Sets the [Navigation2D] node used by the agent. Useful when you don't want to make the agent a child of a [Navigation2D] node. - - @@ -126,6 +119,13 @@ Based on [param value], enables or disables the specified mask in the [member avoidance_mask] bitmask, given a [param mask_number] between 1 and 32. + + + + + Sets the [Navigation2D] node used by the agent. Useful when you don't want to make the agent a child of a [Navigation2D] node. + + @@ -165,7 +165,7 @@ If [code]true[/code] shows debug visuals for this agent. - + If [member debug_use_custom] is [code]true[/code] uses this color for this agent instead of global color. @@ -177,16 +177,16 @@ If [code]true[/code] uses the defined [member debug_path_custom_color] for this agent instead of global color. - + The maximum number of neighbors for the agent to consider. - + The maximum speed that an agent can move. A bitfield determining all navigation map layers the [NavigationAgent2D] belongs to. On path requests the agent will ignore navmeshes without at least one matching layer. - + The distance to search for other agents. @@ -195,10 +195,10 @@ The maximum distance the agent is allowed away from the ideal path to the final position. This can happen due to trying to avoid collisions. When the maximum distance is exceeded, it recalculates the ideal path. - + Additional information to return with the navigation path. - + The radius of the avoidance agent. This is the "body" of the avoidance agent and not the avoidance maneuver starting radius (which is controlled by [member neighbor_distance]). Does not affect normal pathfinding. To change an actor's pathfinding radius bake [NavigationMesh] resources with a different [member NavigationMesh.agent_radius] property and use different navigation maps for each actor size. @@ -211,10 +211,10 @@ The minimal amount of time for which this agent's velocities, that are computed with the collision avoidance algorithm, are safe with respect to other agents. The larger the number, the sooner the agent will respond to other agents, but less freedom in choosing its velocities. A too high value will slow down agents movement considerably. Must be positive. - + The minimal amount of time for which this agent's velocities, that are computed with the collision avoidance algorithm, are safe with respect to static avoidance obstacles. The larger the number, the sooner the agent will respond to static avoidance obstacles, but less freedom in choosing its velocities. A too high value will slow down agents movement considerably. Must be positive. - + Sets the new wanted velocity for the agent. The avoidance simulation will try to fulfil this velocity if possible but will modify it to avoid collision with other agent's and obstacles. When an agent is teleported to a new position use [method set_velocity_forced] as well to reset the internal simulation velocity. diff --git a/doc/classes/NavigationGeometryParser2D.xml b/doc/classes/NavigationGeometryParser2D.xml index 764660ca2..f173409b4 100644 --- a/doc/classes/NavigationGeometryParser2D.xml +++ b/doc/classes/NavigationGeometryParser2D.xml @@ -1,5 +1,5 @@ - + Parser to contribute a node's geometry data for [NavigationPolygon] baking. @@ -9,7 +9,7 @@ - + @@ -18,7 +18,7 @@ Called when overridden and the [NavigationMeshGenerator] is parsing geometry for [NavigationPolygon] baking. Custom 2D geometry can be added to the [param source_geometry]. - + @@ -26,4 +26,6 @@ + + diff --git a/doc/classes/NavigationGeometryParser3D.xml b/doc/classes/NavigationGeometryParser3D.xml index a87a51643..631713ac7 100644 --- a/doc/classes/NavigationGeometryParser3D.xml +++ b/doc/classes/NavigationGeometryParser3D.xml @@ -1,5 +1,5 @@ - + Parser to contribute a node's geometry data for [NavigationMesh] baking. @@ -9,7 +9,7 @@ - + @@ -18,7 +18,7 @@ Called when overridden and the [NavigationMeshGenerator] is parsing geometry for [NavigationMesh] baking. Custom 3D geometry can be added to the [param source_geometry]. - + @@ -26,4 +26,6 @@ + + diff --git a/doc/classes/NavigationLink2D.xml b/doc/classes/NavigationLink2D.xml index 5448f8c2c..f9454562b 100644 --- a/doc/classes/NavigationLink2D.xml +++ b/doc/classes/NavigationLink2D.xml @@ -1,5 +1,5 @@ - + A link between two positions on [NavigationRegion2D]s that agents can be routed through. @@ -59,7 +59,7 @@ Whether this link is currently active. If [code]false[/code], [method NavigationServer2D.map_get_path] will ignore this link. - + Ending position of the link. This position will search out the nearest polygon in the navigation mesh to attach to. The distance the link will search is controlled by [method NavigationServer2D.map_set_link_connection_radius]. @@ -70,7 +70,7 @@ A bitfield determining all navigation layers the link belongs to. These navigation layers will be checked when requesting a path with [method NavigationServer2D.map_get_path]. - + Starting position of the link. This position will search out the nearest polygon in the navigation mesh to attach to. The distance the link will search is controlled by [method NavigationServer2D.map_set_link_connection_radius]. @@ -79,4 +79,6 @@ When pathfinding moves along the link the traveled distance is multiplied with [member travel_cost] for determining the shortest path. + + diff --git a/doc/classes/NavigationLink3D.xml b/doc/classes/NavigationLink3D.xml index efe6c1690..b394768b3 100644 --- a/doc/classes/NavigationLink3D.xml +++ b/doc/classes/NavigationLink3D.xml @@ -1,5 +1,5 @@ - + A link between two positions on [NavigationRegion3D]s that agents can be routed through. @@ -59,7 +59,7 @@ Whether this link is currently active. If [code]false[/code], [method NavigationServer3D.map_get_path] will ignore this link. - + Ending position of the link. This position will search out the nearest polygon in the navigation mesh to attach to. The distance the link will search is controlled by [method NavigationServer3D.map_set_link_connection_radius]. @@ -70,7 +70,7 @@ A bitfield determining all navigation layers the link belongs to. These navigation layers will be checked when requesting a path with [method NavigationServer3D.map_get_path]. - + Starting position of the link. This position will search out the nearest polygon in the navigation mesh to attach to. The distance the link will search is controlled by [method NavigationServer3D.map_set_link_connection_radius]. @@ -79,4 +79,6 @@ When pathfinding moves along the link the traveled distance is multiplied with [member travel_cost] for determining the shortest path. + + diff --git a/doc/classes/NavigationMesh.xml b/doc/classes/NavigationMesh.xml index 36e01c2f9..c62ebf7d7 100644 --- a/doc/classes/NavigationMesh.xml +++ b/doc/classes/NavigationMesh.xml @@ -1,5 +1,5 @@ - + A mesh that defines the areas traversable by navigation agents that are safe from obstructions. @@ -24,31 +24,18 @@ Clears both the internal polygons and vertices arrays. - - - - Applies all changes to vertices and polygons and synchronizes with the NavigationServer. - - - - - - Returns the array of polygons used by the internal navigation mesh. Each polygon array consists of the indices for the vertices that make the polygon. - - - - - - - Sets the navigation mesh polygons. Each polygon array needs to consist of the indices for the vertices that make the polygon. - - Clears the array of polygons, but it doesn't clear the array of vertices. + + + + Applies all changes to vertices and polygons and synchronizes with the NavigationServer. + + @@ -134,10 +121,10 @@ The maximum allowed length for contour edges along the border of the mesh. [b]Note:[/b] While baking, this value will be rounded up to the nearest multiple of [member cell_size]. - + If the baking [AABB] has a volume the navigation mesh baking will be restricted to its enclosing area. - + The position offset applied to the [member filter_baking_aabb] [AABB]. @@ -199,8 +186,7 @@ Represents the size of the [enum ParsedGeometryType] enum. - - Scans the child nodes of [NavigationMeshInstance] recursively for geometry. + Scans nodes in a group and their child nodes recursively for geometry. The group is specified by [member geometry_source_group_name]. diff --git a/doc/classes/NavigationMeshGenerator.xml b/doc/classes/NavigationMeshGenerator.xml index c555bb950..55b063304 100644 --- a/doc/classes/NavigationMeshGenerator.xml +++ b/doc/classes/NavigationMeshGenerator.xml @@ -1,5 +1,5 @@ - + Server for navigation mesh baking and source geometry parsing. @@ -16,7 +16,7 @@ - + Bakes the provided [param navigation_polygon] with the data from the provided [param source_geometry_data]. After the process is finished the optional [param callback] will be called. @@ -25,7 +25,7 @@ - + Bakes the provided [param navigation_mesh] with the data from the provided [param source_geometry_data]. After the process is finished the optional [param callback] will be called. @@ -48,7 +48,7 @@ - + Parses the [SceneTree] (not thread-safe) for source geometry according to the properties of [param navigation_polygon] and returns a [NavigationMeshSourceGeometryData2D] that can be used to bake a navigation mesh. After the process is finished the optional [param callback] will be called. @@ -57,7 +57,7 @@ - + Parses the [SceneTree] (not thread-safe) for source geometry according to the properties of [param navigation_mesh] and returns a [NavigationMeshSourceGeometryData2D] that can be used to bake a navigation mesh. After the process is finished the optional [param callback] will be called. @@ -66,7 +66,7 @@ - + Uses both [method parse_2d_source_geometry_data] and [method bake_2d_from_source_geometry_data] in sequence. After the process is finished the optional [param callback] will be called. @@ -75,7 +75,7 @@ - + Uses both [method parse_3d_source_geometry_data] and [method bake_3d_from_source_geometry_data] in sequence. After the process is finished the optional [param callback] will be called. @@ -109,4 +109,6 @@ + + diff --git a/doc/classes/NavigationMeshSourceGeometryData2D.xml b/doc/classes/NavigationMeshSourceGeometryData2D.xml index 469a39c4b..7c53b1ea4 100644 --- a/doc/classes/NavigationMeshSourceGeometryData2D.xml +++ b/doc/classes/NavigationMeshSourceGeometryData2D.xml @@ -1,5 +1,5 @@ - + Contains parsed source geometry data for use in [NavigationPolygon] baking with the [NavigationMeshGenerator]. @@ -62,4 +62,6 @@ + + diff --git a/doc/classes/NavigationMeshSourceGeometryData3D.xml b/doc/classes/NavigationMeshSourceGeometryData3D.xml index 8877124df..1499546cc 100644 --- a/doc/classes/NavigationMeshSourceGeometryData3D.xml +++ b/doc/classes/NavigationMeshSourceGeometryData3D.xml @@ -1,5 +1,5 @@ - + Contains parsed source geometry data for use in [NavigationMesh] baking with the [NavigationMeshGenerator]. @@ -12,7 +12,7 @@ - + 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] resource have no transform all vertex positions need to be offset by the node's transform using the [code]xform[/code] parameter. @@ -20,7 +20,7 @@ - + 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] resource have no transform all vertex positions need to be offset by the node's transform using the [code]xform[/code] parameter. @@ -28,7 +28,7 @@ - + Adds an [Array] the size of [constant Mesh.ARRAY_MAX] and with vertices at index [constant Mesh.ARRAY_VERTEX] and indices at index [constant Mesh.ARRAY_INDEX] to the navigation mesh baking data. The array must have valid triangulated mesh data to be considered. Since [NavigationMesh] resource have no transform all vertex positions need to be offset by the node's transform using the [code]xform[/code] parameter. @@ -74,4 +74,6 @@ + + diff --git a/doc/classes/NavigationObstacle.xml b/doc/classes/NavigationObstacle.xml index a5024b902..958922fb4 100644 --- a/doc/classes/NavigationObstacle.xml +++ b/doc/classes/NavigationObstacle.xml @@ -1,5 +1,5 @@ - + 3D Obstacle used in navigation to constrain avoidance controlled agents outside or inside an area. @@ -25,18 +25,18 @@ Returns whether or not the specified layer of the [member avoidance_layers] bitmask is enabled, given a [param layer_number] between 1 and 32. - - - - Returns the [RID] of the navigation map for this NavigationObstacle node. This function returns always the map set on the NavigationObstacle node and not the map of the abstract obstacle on the NavigationServer. If the obstacle map is changed directly with the NavigationServer API the NavigationObstacle node will not be aware of the map change. Use [method set_navigation_map] to change the navigation map for the NavigationObstacle and also update the obstacle on the NavigationServer. - - Returns the [Navigation] node that the obstacle is using for its navigation system. + + + + Returns the [RID] of the navigation map for this NavigationObstacle node. This function returns always the map set on the NavigationObstacle node and not the map of the abstract obstacle on the NavigationServer. If the obstacle map is changed directly with the NavigationServer API the NavigationObstacle node will not be aware of the map change. Use [method set_navigation_map] to change the navigation map for the NavigationObstacle and also update the obstacle on the NavigationServer. + + @@ -80,10 +80,10 @@ If [code]true[/code] the obstacle affects 3D avoidance using agent's with obstacle [member radius]. If [code]false[/code] the obstacle affects 2D avoidance using agent's with both obstacle [member vertices] as well as obstacle [member radius]. - + Sets the wanted velocity for the obstacle so other agent's can better predict the obstacle if it is moved with a velocity regularly (every frame) instead of warped to a new position. Does only affect avoidance for the obstacles [member radius]. Does nothing for the obstacles static vertices. - + The outline vertices of the obstacle. If the vertices are winded in clockwise order agents will be pushed in by the obstacle, else they will be pushed out. Outlines can not be crossed or overlap. Should the vertices using obstacle be warped to a new position agent's can not predict this movement and may get trapped inside the obstacle. diff --git a/doc/classes/NavigationObstacle2D.xml b/doc/classes/NavigationObstacle2D.xml index c1f5f0ea3..a91145826 100644 --- a/doc/classes/NavigationObstacle2D.xml +++ b/doc/classes/NavigationObstacle2D.xml @@ -1,5 +1,5 @@ - + 2D Obstacle used in navigation to constrain avoidance controlled agents outside or inside an area. @@ -12,7 +12,7 @@ - + Returns the [RID] of this agent on the [NavigationServer2D]. This [RID] is used for the moving avoidance "obstacle" component (using a fake avoidance agent) which size is defined by [member radius] and velocity set by using [member velocity]. @@ -25,12 +25,6 @@ Returns whether or not the specified layer of the [member avoidance_layers] bitmask is enabled, given a [param layer_number] between 1 and 32. - - - - Returns the [RID] of the navigation map for this NavigationObstacle node. This function returns always the map set on the NavigationObstacle node and not the map of the abstract obstacle on the NavigationServer. If the obstacle map is changed directly with the NavigationServer API the NavigationObstacle node will not be aware of the map change. Use [method set_navigation_map] to change the navigation map for the NavigationObstacle and also update the obstacle on the NavigationServer. - - @@ -58,13 +52,6 @@ Sets the [Navigation2D] node used by the obstacle. Useful when you don't want to make the obstacle a child of a [Navigation2D] node. - - - - - Sets the [RID] of the navigation map this NavigationObstacle node should use and also updates the [code]obstacle[/code] on the NavigationServer. - - @@ -73,10 +60,10 @@ Sets the avoidance radius for the obstacle. - + Sets the wanted velocity for the obstacle so other agent's can better predict the obstacle if it is moved with a velocity regularly (every frame) instead of warped to a new position. Does only affect avoidance for the obstacles [member radius]. Does nothing for the obstacles static vertices. - + The outline vertices of the obstacle. If the vertices are winded in clockwise order agents will be pushed in by the obstacle, else they will be pushed out. Outlines can not be crossed or overlap. Should the vertices using obstacle be warped to a new position agent's can not predict this movement and may get trapped inside the obstacle. diff --git a/doc/classes/NavigationPathQueryParameters2D.xml b/doc/classes/NavigationPathQueryParameters2D.xml index 5c5854efb..6a133274e 100644 --- a/doc/classes/NavigationPathQueryParameters2D.xml +++ b/doc/classes/NavigationPathQueryParameters2D.xml @@ -1,5 +1,5 @@ - + Provides parameters for 2D navigation path queries. @@ -9,14 +9,13 @@ $DOCS_URL/tutorials/navigation/navigation_using_navigationpathqueryobjects.html + + The navigation [code]map[/code] [RID] used in the path query. - - Additional information to include with the navigation path. - - + Additional information to include with the navigation path. @@ -28,10 +27,10 @@ The pathfinding algorithm used in the path query. - + The pathfinding start position in global coordinates. - + The pathfinding target position in global coordinates. @@ -45,34 +44,19 @@ Centers every path position in the middle of the traveled navigation mesh polygon edge. This creates better paths for tile- or gridbased layouts that restrict the movement to the cells center. - + Don't include any additional metadata about the returned path. - + Include the type of navigation primitive (region or link) that each point of the path goes through. - + Include the [RID]s of the regions and links that each point of the path goes through. - + Include the [code]ObjectID[/code]s of the [Object]s which manage the regions and links each point of the path goes through. - - Include all available metadata about the returned path. - - - Don't include any additional metadata about the returned path. - - - Include the type of navigation primitive (region or link) that each point of the path goes through. - - - Include the [RID]s of the regions and links that each point of the path goes through. - - - Include the [code]ObjectID[/code]s of the [Object]s which manage the regions and links each point of the path goes through. - - + Include all available metadata about the returned path. diff --git a/doc/classes/NavigationPathQueryParameters3D.xml b/doc/classes/NavigationPathQueryParameters3D.xml index 29e2b821d..99a1862a4 100644 --- a/doc/classes/NavigationPathQueryParameters3D.xml +++ b/doc/classes/NavigationPathQueryParameters3D.xml @@ -1,5 +1,5 @@ - + Provides parameters for 3D navigation path queries. @@ -9,11 +9,13 @@ $DOCS_URL/tutorials/navigation/navigation_using_navigationpathqueryobjects.html + + The navigation [code]map[/code] [RID] used in the path query. - + Additional information to include with the navigation path. @@ -25,10 +27,10 @@ The pathfinding algorithm used in the path query. - + The pathfinding start position in global coordinates. - + The pathfinding target position in global coordinates. @@ -42,34 +44,19 @@ Centers every path position in the middle of the traveled navigation mesh polygon edge. This creates better paths for tile- or gridbased layouts that restrict the movement to the cells center. - + Don't include any additional metadata about the returned path. - + Include the type of navigation primitive (region or link) that each point of the path goes through. - + Include the [RID]s of the regions and links that each point of the path goes through. - + Include the [code]ObjectID[/code]s of the [Object]s which manage the regions and links each point of the path goes through. - - Include all available metadata about the returned path. - - - Don't include any additional metadata about the returned path. - - - Include the type of navigation primitive (region or link) that each point of the path goes through. - - - Include the [RID]s of the regions and links that each point of the path goes through. - - - Include the [code]ObjectID[/code]s of the [Object]s which manage the regions and links each point of the path goes through. - - + Include all available metadata about the returned path. diff --git a/doc/classes/NavigationPathQueryResult2D.xml b/doc/classes/NavigationPathQueryResult2D.xml index 8bca8f745..089df8e0e 100644 --- a/doc/classes/NavigationPathQueryResult2D.xml +++ b/doc/classes/NavigationPathQueryResult2D.xml @@ -1,5 +1,5 @@ - + Represents the result of a 2D pathfinding query. @@ -18,16 +18,16 @@ - + The resulting path array from the navigation query. All path array positions are in global coordinates. Without customized query parameters this is the same path as returned by [method NavigationServer2D.map_get_path]. - + The [code]ObjectID[/code]s of the [Object]s which manage the regions and links each point of the path goes through. - + The [RID]s of the regions and links that each point of the path goes through. - + The type of navigation primitive (region or link) that each point of the path goes through. diff --git a/doc/classes/NavigationPathQueryResult3D.xml b/doc/classes/NavigationPathQueryResult3D.xml index 82fb17ee4..79e1f66d7 100644 --- a/doc/classes/NavigationPathQueryResult3D.xml +++ b/doc/classes/NavigationPathQueryResult3D.xml @@ -1,5 +1,5 @@ - + Represents the result of a 3D pathfinding query. @@ -18,16 +18,16 @@ - + The resulting path array from the navigation query. All path array positions are in global coordinates. Without customized query parameters this is the same path as returned by [method NavigationServer3D.map_get_path]. - + The [code]ObjectID[/code]s of the [Object]s which manage the regions and links each point of the path goes through. - + The [RID]s of the regions and links that each point of the path goes through. - + The type of navigation primitive (region or link) that each point of the path goes through. diff --git a/doc/classes/NavigationPolygon.xml b/doc/classes/NavigationPolygon.xml index 9f69d89f2..19bf64823 100644 --- a/doc/classes/NavigationPolygon.xml +++ b/doc/classes/NavigationPolygon.xml @@ -1,5 +1,5 @@ - + A NavigationPolygon is used in pathfinding to describe the traversable area that is safe from collision and other obstructions, assuming an agent's center position at zero radius. @@ -64,10 +64,28 @@ Clears the array of polygons, but it doesn't clear the array of outlines and vertices. - + + + + Applies all changes to vertices and polygons and synchronizes with the [NavigationServer2D]. + + + + + + Returns the array of baked outlines. The baked outlines are the result of a finished [NavigationMeshGenerator] baking process and primarily used for debugging purposes. + + + + + + + Returns whether or not the specified layer of the [member geometry_collision_mask] is enabled, given a [param layer_number] between 1 and 32. + + + - Returns the [NavigationMesh] resulting from this navigation polygon. This navmesh can be used to update the navmesh of a region with the [method NavigationServer.region_set_navmesh] API directly (as 2D uses the 3D server behind the scene). @@ -83,6 +101,11 @@ Returns the number of outlines that were created in the editor or by script. + + + + + @@ -102,27 +125,6 @@ Returns the array of polygons used by the internal navigation mesh. Each polygon array consists of the indices for the vertices that make the polygon. - - - - - Sets the array of baked outlines. The baked outlines are the result of a finished [NavigationMeshGenerator] baking process and primarily used for debugging purposes. - - - - - - - Sets the outline arrays. The outlines need to be baked to actual navigation mesh polygons by using the [NavigationMeshGenerator]. - - - - - - - Sets the navigation mesh polygons. Each polygon array needs to consist of the indices for the vertices that make the polygon. - - @@ -142,6 +144,20 @@ Removes an outline created in the editor or by script. + + + + + Sets the array of baked outlines. The baked outlines are the result of a finished [NavigationMeshGenerator] baking process and primarily used for debugging purposes. + + + + + + + + + @@ -150,6 +166,20 @@ Changes an outline created in the editor or by script. + + + + + Sets the outline arrays. The outlines need to be baked to actual navigation mesh polygons by using the [NavigationMeshGenerator]. + + + + + + + Sets the navigation mesh polygons. Each polygon array needs to consist of the indices for the vertices that make the polygon. + + @@ -157,25 +187,6 @@ Sets the vertices that need to be indexed with the [method add_polygon] or [method set_polygons] methods. When finished changing the navigation polygon call [method commit_changes] in order to synchronize the changes with the [Navigation2DServer]. - - - - Applies all changes to vertices and polygons and synchronizes with the [NavigationServer2D]. - - - - - - Returns the array of baked outlines. The baked outlines are the result of a finished [NavigationMeshGenerator] baking process and primarily used for debugging purposes. - - - - - - - Returns whether or not the specified layer of the [member geometry_collision_mask] is enabled, given a [param layer_number] between 1 and 32. - - @@ -190,7 +201,7 @@ The source of the geometry used when baking. See [enum SourceGeometryMode] for possible values. - + The name of the group to scan for geometry. Only used when [member geometry_source_geometry_mode] is [constant SOURCE_GEOMETRY_GROUPS_WITH_CHILDREN] or [constant SOURCE_GEOMETRY_GROUPS_EXPLICIT]. diff --git a/doc/classes/NavigationPolygonInstance.xml b/doc/classes/NavigationPolygonInstance.xml index cfdd97955..a903442c3 100644 --- a/doc/classes/NavigationPolygonInstance.xml +++ b/doc/classes/NavigationPolygonInstance.xml @@ -1,5 +1,5 @@ - + A region of the 2D navigation map. @@ -15,6 +15,13 @@ + + + + + Bakes the [NavigationPolygon]. If [param on_thread] is set to [code]true[/code] (default), the baking is done on a separate thread. + + @@ -29,25 +36,18 @@ Returns whether or not the specified layer of the [member navigation_layers] bitmask is enabled, given a [code]layer_number[/code] between 1 and 32. - - - - Returns the [RID] of this region on the [Navigation2DServer]. Combined with [method Navigation2DServer.map_get_closest_point_owner] can be used to identify the [NavigationPolygonInstance] closest to a point on the merged navigation map. - - - - - - - Bakes the [NavigationPolygon]. If [param on_thread] is set to [code]true[/code] (default), the baking is done on a separate thread. - - Returns the current navigation map [RID] use by this region. + + + + Returns the [RID] of this region on the [Navigation2DServer]. Combined with [method Navigation2DServer.map_get_closest_point_owner] can be used to identify the [NavigationPolygonInstance] closest to a point on the merged navigation map. + + @@ -99,8 +99,6 @@ If enabled the navigation region will use edge connections to connect with other navigation regions within proximity of the navigation map edge connection margin. - - @@ -113,4 +111,6 @@ + + diff --git a/doc/classes/NavigationServer.xml b/doc/classes/NavigationServer.xml index ca1fad02d..81b356005 100644 --- a/doc/classes/NavigationServer.xml +++ b/doc/classes/NavigationServer.xml @@ -1,5 +1,5 @@ - + Server interface for low-level 3D navigation access. @@ -200,11 +200,9 @@ Destroys the given RID. - - - + + - If [code]true[/code] enables debug mode on the NavigationServer. @@ -215,7 +213,7 @@ - + Returns information about the current state of the NavigationServer. See [enum ProcessInfo] for a list of available states. @@ -532,6 +530,14 @@ Sets the map up direction. + + + + + + Set the navigation [param map] edge connection use. If [param enabled] the navigation map allows navigation regions to use edge connections to connect with other navigation regions within proximity of the navigation map edge connection margin. + + @@ -585,14 +591,6 @@ Sets the outline vertices for the obstacle. If the vertices are winded in clockwise order agents will be pushed in by the obstacle, else they will be pushed out. - - - - - - Set the navigation [param map] edge connection use. If [param enabled] the navigation map allows navigation regions to use edge connections to connect with other navigation regions within proximity of the navigation map edge connection margin. - - @@ -762,6 +760,13 @@ Control activation of this server. + + + + + If [code]true[/code] enables debug mode on the NavigationServer. + +