class_navigationmesh.rst 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343
  1. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  2. .. DO NOT EDIT THIS FILE, but the NavigationMesh.xml source instead.
  3. .. The source is found in doc/classes or modules/<name>/doc_classes.
  4. .. _class_NavigationMesh:
  5. NavigationMesh
  6. ==============
  7. **Inherits:** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
  8. **Category:** Core
  9. Brief Description
  10. -----------------
  11. Properties
  12. ----------
  13. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  14. | :ref:`float<class_float>` | :ref:`agent/height<class_NavigationMesh_property_agent/height>` |
  15. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  16. | :ref:`float<class_float>` | :ref:`agent/max_climb<class_NavigationMesh_property_agent/max_climb>` |
  17. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  18. | :ref:`float<class_float>` | :ref:`agent/max_slope<class_NavigationMesh_property_agent/max_slope>` |
  19. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  20. | :ref:`float<class_float>` | :ref:`agent/radius<class_NavigationMesh_property_agent/radius>` |
  21. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  22. | :ref:`float<class_float>` | :ref:`cell/height<class_NavigationMesh_property_cell/height>` |
  23. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  24. | :ref:`float<class_float>` | :ref:`cell/size<class_NavigationMesh_property_cell/size>` |
  25. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  26. | :ref:`float<class_float>` | :ref:`detail/sample_distance<class_NavigationMesh_property_detail/sample_distance>` |
  27. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  28. | :ref:`float<class_float>` | :ref:`detail/sample_max_error<class_NavigationMesh_property_detail/sample_max_error>` |
  29. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  30. | :ref:`float<class_float>` | :ref:`edge/max_error<class_NavigationMesh_property_edge/max_error>` |
  31. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  32. | :ref:`float<class_float>` | :ref:`edge/max_length<class_NavigationMesh_property_edge/max_length>` |
  33. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  34. | :ref:`bool<class_bool>` | :ref:`filter/filter_walkable_low_height_spans<class_NavigationMesh_property_filter/filter_walkable_low_height_spans>` |
  35. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  36. | :ref:`bool<class_bool>` | :ref:`filter/ledge_spans<class_NavigationMesh_property_filter/ledge_spans>` |
  37. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  38. | :ref:`bool<class_bool>` | :ref:`filter/low_hanging_obstacles<class_NavigationMesh_property_filter/low_hanging_obstacles>` |
  39. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  40. | :ref:`int<class_int>` | :ref:`geometry/collision_mask<class_NavigationMesh_property_geometry/collision_mask>` |
  41. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  42. | :ref:`int<class_int>` | :ref:`geometry/parsed_geometry_type<class_NavigationMesh_property_geometry/parsed_geometry_type>` |
  43. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  44. | :ref:`float<class_float>` | :ref:`polygon/verts_per_poly<class_NavigationMesh_property_polygon/verts_per_poly>` |
  45. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  46. | :ref:`float<class_float>` | :ref:`region/merge_size<class_NavigationMesh_property_region/merge_size>` |
  47. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  48. | :ref:`float<class_float>` | :ref:`region/min_size<class_NavigationMesh_property_region/min_size>` |
  49. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  50. | :ref:`int<class_int>` | :ref:`sample_partition_type/sample_partition_type<class_NavigationMesh_property_sample_partition_type/sample_partition_type>` |
  51. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------+
  52. Methods
  53. -------
  54. +-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
  55. | void | :ref:`add_polygon<class_NavigationMesh_method_add_polygon>` **(** :ref:`PoolIntArray<class_PoolIntArray>` polygon **)** |
  56. +-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
  57. | void | :ref:`clear_polygons<class_NavigationMesh_method_clear_polygons>` **(** **)** |
  58. +-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
  59. | void | :ref:`create_from_mesh<class_NavigationMesh_method_create_from_mesh>` **(** :ref:`Mesh<class_Mesh>` mesh **)** |
  60. +-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
  61. | :ref:`bool<class_bool>` | :ref:`get_collision_mask_bit<class_NavigationMesh_method_get_collision_mask_bit>` **(** :ref:`int<class_int>` bit **)** const |
  62. +-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
  63. | :ref:`PoolIntArray<class_PoolIntArray>` | :ref:`get_polygon<class_NavigationMesh_method_get_polygon>` **(** :ref:`int<class_int>` idx **)** |
  64. +-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
  65. | :ref:`int<class_int>` | :ref:`get_polygon_count<class_NavigationMesh_method_get_polygon_count>` **(** **)** const |
  66. +-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
  67. | :ref:`PoolVector3Array<class_PoolVector3Array>` | :ref:`get_vertices<class_NavigationMesh_method_get_vertices>` **(** **)** const |
  68. +-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
  69. | void | :ref:`set_collision_mask_bit<class_NavigationMesh_method_set_collision_mask_bit>` **(** :ref:`int<class_int>` bit, :ref:`bool<class_bool>` value **)** |
  70. +-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
  71. | void | :ref:`set_vertices<class_NavigationMesh_method_set_vertices>` **(** :ref:`PoolVector3Array<class_PoolVector3Array>` vertices **)** |
  72. +-------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
  73. Constants
  74. ---------
  75. .. _class_NavigationMesh_constant_SAMPLE_PARTITION_WATERSHED:
  76. .. _class_NavigationMesh_constant_SAMPLE_PARTITION_MONOTONE:
  77. .. _class_NavigationMesh_constant_SAMPLE_PARTITION_LAYERS:
  78. .. _class_NavigationMesh_constant_PARSED_GEOMETRY_MESH_INSTANCES:
  79. .. _class_NavigationMesh_constant_PARSED_GEOMETRY_STATIC_COLLIDERS:
  80. .. _class_NavigationMesh_constant_PARSED_GEOMETRY_BOTH:
  81. - **SAMPLE_PARTITION_WATERSHED** = **0**
  82. - **SAMPLE_PARTITION_MONOTONE** = **1**
  83. - **SAMPLE_PARTITION_LAYERS** = **2**
  84. - **PARSED_GEOMETRY_MESH_INSTANCES** = **0**
  85. - **PARSED_GEOMETRY_STATIC_COLLIDERS** = **1**
  86. - **PARSED_GEOMETRY_BOTH** = **2**
  87. Property Descriptions
  88. ---------------------
  89. .. _class_NavigationMesh_property_agent/height:
  90. - :ref:`float<class_float>` **agent/height**
  91. +----------+-------------------------+
  92. | *Setter* | set_agent_height(value) |
  93. +----------+-------------------------+
  94. | *Getter* | get_agent_height() |
  95. +----------+-------------------------+
  96. .. _class_NavigationMesh_property_agent/max_climb:
  97. - :ref:`float<class_float>` **agent/max_climb**
  98. +----------+----------------------------+
  99. | *Setter* | set_agent_max_climb(value) |
  100. +----------+----------------------------+
  101. | *Getter* | get_agent_max_climb() |
  102. +----------+----------------------------+
  103. .. _class_NavigationMesh_property_agent/max_slope:
  104. - :ref:`float<class_float>` **agent/max_slope**
  105. +----------+----------------------------+
  106. | *Setter* | set_agent_max_slope(value) |
  107. +----------+----------------------------+
  108. | *Getter* | get_agent_max_slope() |
  109. +----------+----------------------------+
  110. .. _class_NavigationMesh_property_agent/radius:
  111. - :ref:`float<class_float>` **agent/radius**
  112. +----------+-------------------------+
  113. | *Setter* | set_agent_radius(value) |
  114. +----------+-------------------------+
  115. | *Getter* | get_agent_radius() |
  116. +----------+-------------------------+
  117. .. _class_NavigationMesh_property_cell/height:
  118. - :ref:`float<class_float>` **cell/height**
  119. +----------+------------------------+
  120. | *Setter* | set_cell_height(value) |
  121. +----------+------------------------+
  122. | *Getter* | get_cell_height() |
  123. +----------+------------------------+
  124. .. _class_NavigationMesh_property_cell/size:
  125. - :ref:`float<class_float>` **cell/size**
  126. +----------+----------------------+
  127. | *Setter* | set_cell_size(value) |
  128. +----------+----------------------+
  129. | *Getter* | get_cell_size() |
  130. +----------+----------------------+
  131. .. _class_NavigationMesh_property_detail/sample_distance:
  132. - :ref:`float<class_float>` **detail/sample_distance**
  133. +----------+-----------------------------------+
  134. | *Setter* | set_detail_sample_distance(value) |
  135. +----------+-----------------------------------+
  136. | *Getter* | get_detail_sample_distance() |
  137. +----------+-----------------------------------+
  138. .. _class_NavigationMesh_property_detail/sample_max_error:
  139. - :ref:`float<class_float>` **detail/sample_max_error**
  140. +----------+------------------------------------+
  141. | *Setter* | set_detail_sample_max_error(value) |
  142. +----------+------------------------------------+
  143. | *Getter* | get_detail_sample_max_error() |
  144. +----------+------------------------------------+
  145. .. _class_NavigationMesh_property_edge/max_error:
  146. - :ref:`float<class_float>` **edge/max_error**
  147. +----------+---------------------------+
  148. | *Setter* | set_edge_max_error(value) |
  149. +----------+---------------------------+
  150. | *Getter* | get_edge_max_error() |
  151. +----------+---------------------------+
  152. .. _class_NavigationMesh_property_edge/max_length:
  153. - :ref:`float<class_float>` **edge/max_length**
  154. +----------+----------------------------+
  155. | *Setter* | set_edge_max_length(value) |
  156. +----------+----------------------------+
  157. | *Getter* | get_edge_max_length() |
  158. +----------+----------------------------+
  159. .. _class_NavigationMesh_property_filter/filter_walkable_low_height_spans:
  160. - :ref:`bool<class_bool>` **filter/filter_walkable_low_height_spans**
  161. +----------+---------------------------------------------+
  162. | *Setter* | set_filter_walkable_low_height_spans(value) |
  163. +----------+---------------------------------------------+
  164. | *Getter* | get_filter_walkable_low_height_spans() |
  165. +----------+---------------------------------------------+
  166. .. _class_NavigationMesh_property_filter/ledge_spans:
  167. - :ref:`bool<class_bool>` **filter/ledge_spans**
  168. +----------+-------------------------------+
  169. | *Setter* | set_filter_ledge_spans(value) |
  170. +----------+-------------------------------+
  171. | *Getter* | get_filter_ledge_spans() |
  172. +----------+-------------------------------+
  173. .. _class_NavigationMesh_property_filter/low_hanging_obstacles:
  174. - :ref:`bool<class_bool>` **filter/low_hanging_obstacles**
  175. +----------+-----------------------------------------+
  176. | *Setter* | set_filter_low_hanging_obstacles(value) |
  177. +----------+-----------------------------------------+
  178. | *Getter* | get_filter_low_hanging_obstacles() |
  179. +----------+-----------------------------------------+
  180. .. _class_NavigationMesh_property_geometry/collision_mask:
  181. - :ref:`int<class_int>` **geometry/collision_mask**
  182. +----------+---------------------------+
  183. | *Setter* | set_collision_mask(value) |
  184. +----------+---------------------------+
  185. | *Getter* | get_collision_mask() |
  186. +----------+---------------------------+
  187. .. _class_NavigationMesh_property_geometry/parsed_geometry_type:
  188. - :ref:`int<class_int>` **geometry/parsed_geometry_type**
  189. +----------+---------------------------------+
  190. | *Setter* | set_parsed_geometry_type(value) |
  191. +----------+---------------------------------+
  192. | *Getter* | get_parsed_geometry_type() |
  193. +----------+---------------------------------+
  194. .. _class_NavigationMesh_property_polygon/verts_per_poly:
  195. - :ref:`float<class_float>` **polygon/verts_per_poly**
  196. +----------+---------------------------+
  197. | *Setter* | set_verts_per_poly(value) |
  198. +----------+---------------------------+
  199. | *Getter* | get_verts_per_poly() |
  200. +----------+---------------------------+
  201. .. _class_NavigationMesh_property_region/merge_size:
  202. - :ref:`float<class_float>` **region/merge_size**
  203. +----------+------------------------------+
  204. | *Setter* | set_region_merge_size(value) |
  205. +----------+------------------------------+
  206. | *Getter* | get_region_merge_size() |
  207. +----------+------------------------------+
  208. .. _class_NavigationMesh_property_region/min_size:
  209. - :ref:`float<class_float>` **region/min_size**
  210. +----------+----------------------------+
  211. | *Setter* | set_region_min_size(value) |
  212. +----------+----------------------------+
  213. | *Getter* | get_region_min_size() |
  214. +----------+----------------------------+
  215. .. _class_NavigationMesh_property_sample_partition_type/sample_partition_type:
  216. - :ref:`int<class_int>` **sample_partition_type/sample_partition_type**
  217. +----------+----------------------------------+
  218. | *Setter* | set_sample_partition_type(value) |
  219. +----------+----------------------------------+
  220. | *Getter* | get_sample_partition_type() |
  221. +----------+----------------------------------+
  222. Method Descriptions
  223. -------------------
  224. .. _class_NavigationMesh_method_add_polygon:
  225. - void **add_polygon** **(** :ref:`PoolIntArray<class_PoolIntArray>` polygon **)**
  226. .. _class_NavigationMesh_method_clear_polygons:
  227. - void **clear_polygons** **(** **)**
  228. .. _class_NavigationMesh_method_create_from_mesh:
  229. - void **create_from_mesh** **(** :ref:`Mesh<class_Mesh>` mesh **)**
  230. .. _class_NavigationMesh_method_get_collision_mask_bit:
  231. - :ref:`bool<class_bool>` **get_collision_mask_bit** **(** :ref:`int<class_int>` bit **)** const
  232. .. _class_NavigationMesh_method_get_polygon:
  233. - :ref:`PoolIntArray<class_PoolIntArray>` **get_polygon** **(** :ref:`int<class_int>` idx **)**
  234. .. _class_NavigationMesh_method_get_polygon_count:
  235. - :ref:`int<class_int>` **get_polygon_count** **(** **)** const
  236. .. _class_NavigationMesh_method_get_vertices:
  237. - :ref:`PoolVector3Array<class_PoolVector3Array>` **get_vertices** **(** **)** const
  238. .. _class_NavigationMesh_method_set_collision_mask_bit:
  239. - void **set_collision_mask_bit** **(** :ref:`int<class_int>` bit, :ref:`bool<class_bool>` value **)**
  240. .. _class_NavigationMesh_method_set_vertices:
  241. - void **set_vertices** **(** :ref:`PoolVector3Array<class_PoolVector3Array>` vertices **)**