NavigationRegion3D.xml 1.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <class name="NavigationRegion3D" inherits="Node3D" version="4.0">
  3. <brief_description>
  4. A region of the navigation map.
  5. </brief_description>
  6. <description>
  7. A region of the navigation map. It tells the [NavigationServer3D] what can be navigated and what cannot, based on its [NavigationMesh] resource.
  8. Two regions can be connected to each other if they share a similar edge. You can set the minimum distance between two vertices required to connect two edges by using [method NavigationServer3D.map_set_edge_connection_margin].
  9. </description>
  10. <tutorials>
  11. </tutorials>
  12. <methods>
  13. <method name="bake_navigation_mesh">
  14. <return type="void" />
  15. <description>
  16. Bakes the [NavigationMesh]. The baking is done in a separate thread because navigation baking is not a cheap operation. This can be done at runtime. When it is completed, it automatically sets the new [NavigationMesh].
  17. </description>
  18. </method>
  19. </methods>
  20. <members>
  21. <member name="enabled" type="bool" setter="set_enabled" getter="is_enabled" default="true">
  22. Determines if the [NavigationRegion3D] is enabled or disabled.
  23. </member>
  24. <member name="layers" type="int" setter="set_layers" getter="get_layers" default="1">
  25. A bitfield determining all layers the region belongs to. These layers can be checked upon when requesting a path with [method NavigationServer3D.map_get_path].
  26. </member>
  27. <member name="navmesh" type="NavigationMesh" setter="set_navigation_mesh" getter="get_navigation_mesh">
  28. The [NavigationMesh] resource to use.
  29. </member>
  30. </members>
  31. <signals>
  32. <signal name="bake_finished">
  33. <description>
  34. Notifies when the navigation mesh bake operation is completed.
  35. </description>
  36. </signal>
  37. <signal name="navigation_mesh_changed">
  38. <description>
  39. Notifies when the [NavigationMesh] has changed.
  40. </description>
  41. </signal>
  42. </signals>
  43. </class>