mirror of
https://github.com/godotengine/godot-docs.git
synced 2026-01-04 14:11:02 +03:00
382 lines
20 KiB
ReStructuredText
382 lines
20 KiB
ReStructuredText
:github_url: hide
|
|
|
|
.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
|
|
.. DO NOT EDIT THIS FILE, but the NavigationMesh.xml source instead.
|
|
.. The source is found in doc/classes or modules/<name>/doc_classes.
|
|
|
|
.. _class_NavigationMesh:
|
|
|
|
NavigationMesh
|
|
==============
|
|
|
|
**Inherits:** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
|
|
|
|
**Category:** Core
|
|
|
|
Brief Description
|
|
-----------------
|
|
|
|
|
|
|
|
Properties
|
|
----------
|
|
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`float<class_float>` | :ref:`agent/height<class_NavigationMesh_property_agent/height>` | 2.0 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`float<class_float>` | :ref:`agent/max_climb<class_NavigationMesh_property_agent/max_climb>` | 0.9 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`float<class_float>` | :ref:`agent/max_slope<class_NavigationMesh_property_agent/max_slope>` | 45.0 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`float<class_float>` | :ref:`agent/radius<class_NavigationMesh_property_agent/radius>` | 0.6 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`float<class_float>` | :ref:`cell/height<class_NavigationMesh_property_cell/height>` | 0.2 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`float<class_float>` | :ref:`cell/size<class_NavigationMesh_property_cell/size>` | 0.3 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`float<class_float>` | :ref:`detail/sample_distance<class_NavigationMesh_property_detail/sample_distance>` | 6.0 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`float<class_float>` | :ref:`detail/sample_max_error<class_NavigationMesh_property_detail/sample_max_error>` | 1.0 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`float<class_float>` | :ref:`edge/max_error<class_NavigationMesh_property_edge/max_error>` | 1.3 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`float<class_float>` | :ref:`edge/max_length<class_NavigationMesh_property_edge/max_length>` | 12.0 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`bool<class_bool>` | :ref:`filter/filter_walkable_low_height_spans<class_NavigationMesh_property_filter/filter_walkable_low_height_spans>` | false |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`bool<class_bool>` | :ref:`filter/ledge_spans<class_NavigationMesh_property_filter/ledge_spans>` | false |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`bool<class_bool>` | :ref:`filter/low_hanging_obstacles<class_NavigationMesh_property_filter/low_hanging_obstacles>` | false |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`int<class_int>` | :ref:`geometry/collision_mask<class_NavigationMesh_property_geometry/collision_mask>` | |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`int<class_int>` | :ref:`geometry/parsed_geometry_type<class_NavigationMesh_property_geometry/parsed_geometry_type>` | 0 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`float<class_float>` | :ref:`polygon/verts_per_poly<class_NavigationMesh_property_polygon/verts_per_poly>` | 6.0 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`float<class_float>` | :ref:`region/merge_size<class_NavigationMesh_property_region/merge_size>` | 20.0 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`float<class_float>` | :ref:`region/min_size<class_NavigationMesh_property_region/min_size>` | 8.0 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
| :ref:`int<class_int>` | :ref:`sample_partition_type/sample_partition_type<class_NavigationMesh_property_sample_partition_type/sample_partition_type>` | 0 |
|
|
+---------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------+
|
|
|
|
Methods
|
|
-------
|
|
|
|
+-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`add_polygon<class_NavigationMesh_method_add_polygon>` **(** :ref:`PoolIntArray<class_PoolIntArray>` polygon **)** |
|
|
+-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`clear_polygons<class_NavigationMesh_method_clear_polygons>` **(** **)** |
|
|
+-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`create_from_mesh<class_NavigationMesh_method_create_from_mesh>` **(** :ref:`Mesh<class_Mesh>` mesh **)** |
|
|
+-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`get_collision_mask_bit<class_NavigationMesh_method_get_collision_mask_bit>` **(** :ref:`int<class_int>` bit **)** const |
|
|
+-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`PoolIntArray<class_PoolIntArray>` | :ref:`get_polygon<class_NavigationMesh_method_get_polygon>` **(** :ref:`int<class_int>` idx **)** |
|
|
+-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_polygon_count<class_NavigationMesh_method_get_polygon_count>` **(** **)** const |
|
|
+-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`PoolVector3Array<class_PoolVector3Array>` | :ref:`get_vertices<class_NavigationMesh_method_get_vertices>` **(** **)** const |
|
|
+-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_collision_mask_bit<class_NavigationMesh_method_set_collision_mask_bit>` **(** :ref:`int<class_int>` bit, :ref:`bool<class_bool>` value **)** |
|
|
+-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_vertices<class_NavigationMesh_method_set_vertices>` **(** :ref:`PoolVector3Array<class_PoolVector3Array>` vertices **)** |
|
|
+-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
Constants
|
|
---------
|
|
|
|
.. _class_NavigationMesh_constant_SAMPLE_PARTITION_WATERSHED:
|
|
|
|
.. _class_NavigationMesh_constant_SAMPLE_PARTITION_MONOTONE:
|
|
|
|
.. _class_NavigationMesh_constant_SAMPLE_PARTITION_LAYERS:
|
|
|
|
.. _class_NavigationMesh_constant_PARSED_GEOMETRY_MESH_INSTANCES:
|
|
|
|
.. _class_NavigationMesh_constant_PARSED_GEOMETRY_STATIC_COLLIDERS:
|
|
|
|
.. _class_NavigationMesh_constant_PARSED_GEOMETRY_BOTH:
|
|
|
|
- **SAMPLE_PARTITION_WATERSHED** = **0**
|
|
|
|
- **SAMPLE_PARTITION_MONOTONE** = **1**
|
|
|
|
- **SAMPLE_PARTITION_LAYERS** = **2**
|
|
|
|
- **PARSED_GEOMETRY_MESH_INSTANCES** = **0**
|
|
|
|
- **PARSED_GEOMETRY_STATIC_COLLIDERS** = **1**
|
|
|
|
- **PARSED_GEOMETRY_BOTH** = **2**
|
|
|
|
Property Descriptions
|
|
---------------------
|
|
|
|
.. _class_NavigationMesh_property_agent/height:
|
|
|
|
- :ref:`float<class_float>` **agent/height**
|
|
|
|
+-----------+-------------------------+
|
|
| *Default* | 2.0 |
|
|
+-----------+-------------------------+
|
|
| *Setter* | set_agent_height(value) |
|
|
+-----------+-------------------------+
|
|
| *Getter* | get_agent_height() |
|
|
+-----------+-------------------------+
|
|
|
|
.. _class_NavigationMesh_property_agent/max_climb:
|
|
|
|
- :ref:`float<class_float>` **agent/max_climb**
|
|
|
|
+-----------+----------------------------+
|
|
| *Default* | 0.9 |
|
|
+-----------+----------------------------+
|
|
| *Setter* | set_agent_max_climb(value) |
|
|
+-----------+----------------------------+
|
|
| *Getter* | get_agent_max_climb() |
|
|
+-----------+----------------------------+
|
|
|
|
.. _class_NavigationMesh_property_agent/max_slope:
|
|
|
|
- :ref:`float<class_float>` **agent/max_slope**
|
|
|
|
+-----------+----------------------------+
|
|
| *Default* | 45.0 |
|
|
+-----------+----------------------------+
|
|
| *Setter* | set_agent_max_slope(value) |
|
|
+-----------+----------------------------+
|
|
| *Getter* | get_agent_max_slope() |
|
|
+-----------+----------------------------+
|
|
|
|
.. _class_NavigationMesh_property_agent/radius:
|
|
|
|
- :ref:`float<class_float>` **agent/radius**
|
|
|
|
+-----------+-------------------------+
|
|
| *Default* | 0.6 |
|
|
+-----------+-------------------------+
|
|
| *Setter* | set_agent_radius(value) |
|
|
+-----------+-------------------------+
|
|
| *Getter* | get_agent_radius() |
|
|
+-----------+-------------------------+
|
|
|
|
.. _class_NavigationMesh_property_cell/height:
|
|
|
|
- :ref:`float<class_float>` **cell/height**
|
|
|
|
+-----------+------------------------+
|
|
| *Default* | 0.2 |
|
|
+-----------+------------------------+
|
|
| *Setter* | set_cell_height(value) |
|
|
+-----------+------------------------+
|
|
| *Getter* | get_cell_height() |
|
|
+-----------+------------------------+
|
|
|
|
.. _class_NavigationMesh_property_cell/size:
|
|
|
|
- :ref:`float<class_float>` **cell/size**
|
|
|
|
+-----------+----------------------+
|
|
| *Default* | 0.3 |
|
|
+-----------+----------------------+
|
|
| *Setter* | set_cell_size(value) |
|
|
+-----------+----------------------+
|
|
| *Getter* | get_cell_size() |
|
|
+-----------+----------------------+
|
|
|
|
.. _class_NavigationMesh_property_detail/sample_distance:
|
|
|
|
- :ref:`float<class_float>` **detail/sample_distance**
|
|
|
|
+-----------+-----------------------------------+
|
|
| *Default* | 6.0 |
|
|
+-----------+-----------------------------------+
|
|
| *Setter* | set_detail_sample_distance(value) |
|
|
+-----------+-----------------------------------+
|
|
| *Getter* | get_detail_sample_distance() |
|
|
+-----------+-----------------------------------+
|
|
|
|
.. _class_NavigationMesh_property_detail/sample_max_error:
|
|
|
|
- :ref:`float<class_float>` **detail/sample_max_error**
|
|
|
|
+-----------+------------------------------------+
|
|
| *Default* | 1.0 |
|
|
+-----------+------------------------------------+
|
|
| *Setter* | set_detail_sample_max_error(value) |
|
|
+-----------+------------------------------------+
|
|
| *Getter* | get_detail_sample_max_error() |
|
|
+-----------+------------------------------------+
|
|
|
|
.. _class_NavigationMesh_property_edge/max_error:
|
|
|
|
- :ref:`float<class_float>` **edge/max_error**
|
|
|
|
+-----------+---------------------------+
|
|
| *Default* | 1.3 |
|
|
+-----------+---------------------------+
|
|
| *Setter* | set_edge_max_error(value) |
|
|
+-----------+---------------------------+
|
|
| *Getter* | get_edge_max_error() |
|
|
+-----------+---------------------------+
|
|
|
|
.. _class_NavigationMesh_property_edge/max_length:
|
|
|
|
- :ref:`float<class_float>` **edge/max_length**
|
|
|
|
+-----------+----------------------------+
|
|
| *Default* | 12.0 |
|
|
+-----------+----------------------------+
|
|
| *Setter* | set_edge_max_length(value) |
|
|
+-----------+----------------------------+
|
|
| *Getter* | get_edge_max_length() |
|
|
+-----------+----------------------------+
|
|
|
|
.. _class_NavigationMesh_property_filter/filter_walkable_low_height_spans:
|
|
|
|
- :ref:`bool<class_bool>` **filter/filter_walkable_low_height_spans**
|
|
|
|
+-----------+---------------------------------------------+
|
|
| *Default* | false |
|
|
+-----------+---------------------------------------------+
|
|
| *Setter* | set_filter_walkable_low_height_spans(value) |
|
|
+-----------+---------------------------------------------+
|
|
| *Getter* | get_filter_walkable_low_height_spans() |
|
|
+-----------+---------------------------------------------+
|
|
|
|
.. _class_NavigationMesh_property_filter/ledge_spans:
|
|
|
|
- :ref:`bool<class_bool>` **filter/ledge_spans**
|
|
|
|
+-----------+-------------------------------+
|
|
| *Default* | false |
|
|
+-----------+-------------------------------+
|
|
| *Setter* | set_filter_ledge_spans(value) |
|
|
+-----------+-------------------------------+
|
|
| *Getter* | get_filter_ledge_spans() |
|
|
+-----------+-------------------------------+
|
|
|
|
.. _class_NavigationMesh_property_filter/low_hanging_obstacles:
|
|
|
|
- :ref:`bool<class_bool>` **filter/low_hanging_obstacles**
|
|
|
|
+-----------+-----------------------------------------+
|
|
| *Default* | false |
|
|
+-----------+-----------------------------------------+
|
|
| *Setter* | set_filter_low_hanging_obstacles(value) |
|
|
+-----------+-----------------------------------------+
|
|
| *Getter* | get_filter_low_hanging_obstacles() |
|
|
+-----------+-----------------------------------------+
|
|
|
|
.. _class_NavigationMesh_property_geometry/collision_mask:
|
|
|
|
- :ref:`int<class_int>` **geometry/collision_mask**
|
|
|
|
+----------+---------------------------+
|
|
| *Setter* | set_collision_mask(value) |
|
|
+----------+---------------------------+
|
|
| *Getter* | get_collision_mask() |
|
|
+----------+---------------------------+
|
|
|
|
.. _class_NavigationMesh_property_geometry/parsed_geometry_type:
|
|
|
|
- :ref:`int<class_int>` **geometry/parsed_geometry_type**
|
|
|
|
+-----------+---------------------------------+
|
|
| *Default* | 0 |
|
|
+-----------+---------------------------------+
|
|
| *Setter* | set_parsed_geometry_type(value) |
|
|
+-----------+---------------------------------+
|
|
| *Getter* | get_parsed_geometry_type() |
|
|
+-----------+---------------------------------+
|
|
|
|
.. _class_NavigationMesh_property_polygon/verts_per_poly:
|
|
|
|
- :ref:`float<class_float>` **polygon/verts_per_poly**
|
|
|
|
+-----------+---------------------------+
|
|
| *Default* | 6.0 |
|
|
+-----------+---------------------------+
|
|
| *Setter* | set_verts_per_poly(value) |
|
|
+-----------+---------------------------+
|
|
| *Getter* | get_verts_per_poly() |
|
|
+-----------+---------------------------+
|
|
|
|
.. _class_NavigationMesh_property_region/merge_size:
|
|
|
|
- :ref:`float<class_float>` **region/merge_size**
|
|
|
|
+-----------+------------------------------+
|
|
| *Default* | 20.0 |
|
|
+-----------+------------------------------+
|
|
| *Setter* | set_region_merge_size(value) |
|
|
+-----------+------------------------------+
|
|
| *Getter* | get_region_merge_size() |
|
|
+-----------+------------------------------+
|
|
|
|
.. _class_NavigationMesh_property_region/min_size:
|
|
|
|
- :ref:`float<class_float>` **region/min_size**
|
|
|
|
+-----------+----------------------------+
|
|
| *Default* | 8.0 |
|
|
+-----------+----------------------------+
|
|
| *Setter* | set_region_min_size(value) |
|
|
+-----------+----------------------------+
|
|
| *Getter* | get_region_min_size() |
|
|
+-----------+----------------------------+
|
|
|
|
.. _class_NavigationMesh_property_sample_partition_type/sample_partition_type:
|
|
|
|
- :ref:`int<class_int>` **sample_partition_type/sample_partition_type**
|
|
|
|
+-----------+----------------------------------+
|
|
| *Default* | 0 |
|
|
+-----------+----------------------------------+
|
|
| *Setter* | set_sample_partition_type(value) |
|
|
+-----------+----------------------------------+
|
|
| *Getter* | get_sample_partition_type() |
|
|
+-----------+----------------------------------+
|
|
|
|
Method Descriptions
|
|
-------------------
|
|
|
|
.. _class_NavigationMesh_method_add_polygon:
|
|
|
|
- void **add_polygon** **(** :ref:`PoolIntArray<class_PoolIntArray>` polygon **)**
|
|
|
|
.. _class_NavigationMesh_method_clear_polygons:
|
|
|
|
- void **clear_polygons** **(** **)**
|
|
|
|
.. _class_NavigationMesh_method_create_from_mesh:
|
|
|
|
- void **create_from_mesh** **(** :ref:`Mesh<class_Mesh>` mesh **)**
|
|
|
|
.. _class_NavigationMesh_method_get_collision_mask_bit:
|
|
|
|
- :ref:`bool<class_bool>` **get_collision_mask_bit** **(** :ref:`int<class_int>` bit **)** const
|
|
|
|
.. _class_NavigationMesh_method_get_polygon:
|
|
|
|
- :ref:`PoolIntArray<class_PoolIntArray>` **get_polygon** **(** :ref:`int<class_int>` idx **)**
|
|
|
|
.. _class_NavigationMesh_method_get_polygon_count:
|
|
|
|
- :ref:`int<class_int>` **get_polygon_count** **(** **)** const
|
|
|
|
.. _class_NavigationMesh_method_get_vertices:
|
|
|
|
- :ref:`PoolVector3Array<class_PoolVector3Array>` **get_vertices** **(** **)** const
|
|
|
|
.. _class_NavigationMesh_method_set_collision_mask_bit:
|
|
|
|
- void **set_collision_mask_bit** **(** :ref:`int<class_int>` bit, :ref:`bool<class_bool>` value **)**
|
|
|
|
.. _class_NavigationMesh_method_set_vertices:
|
|
|
|
- void **set_vertices** **(** :ref:`PoolVector3Array<class_PoolVector3Array>` vertices **)**
|
|
|