class_collisionpolygon.rst 3.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the CollisionPolygon.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_CollisionPolygon:
  6. CollisionPolygon
  7. ================
  8. **Inherits:** :ref:`Spatial<class_Spatial>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  9. Editor-only class for defining a collision polygon in 3D space.
  10. Description
  11. -----------
  12. Allows editing a collision polygon's vertices on a selected plane. Can also set a depth perpendicular to that plane. This class is only available in the editor. It will not appear in the scene tree at run-time. Creates a :ref:`Shape<class_Shape>` for gameplay. Properties modified during gameplay will have no effect.
  13. Properties
  14. ----------
  15. +-------------------------------------------------+-----------------------------------------------------------+--------------------------+
  16. | :ref:`float<class_float>` | :ref:`depth<class_CollisionPolygon_property_depth>` | ``1.0`` |
  17. +-------------------------------------------------+-----------------------------------------------------------+--------------------------+
  18. | :ref:`bool<class_bool>` | :ref:`disabled<class_CollisionPolygon_property_disabled>` | ``false`` |
  19. +-------------------------------------------------+-----------------------------------------------------------+--------------------------+
  20. | :ref:`PoolVector2Array<class_PoolVector2Array>` | :ref:`polygon<class_CollisionPolygon_property_polygon>` | ``PoolVector2Array( )`` |
  21. +-------------------------------------------------+-----------------------------------------------------------+--------------------------+
  22. Property Descriptions
  23. ---------------------
  24. .. _class_CollisionPolygon_property_depth:
  25. - :ref:`float<class_float>` **depth**
  26. +-----------+------------------+
  27. | *Default* | ``1.0`` |
  28. +-----------+------------------+
  29. | *Setter* | set_depth(value) |
  30. +-----------+------------------+
  31. | *Getter* | get_depth() |
  32. +-----------+------------------+
  33. Length that the resulting collision extends in either direction perpendicular to its polygon.
  34. ----
  35. .. _class_CollisionPolygon_property_disabled:
  36. - :ref:`bool<class_bool>` **disabled**
  37. +-----------+---------------------+
  38. | *Default* | ``false`` |
  39. +-----------+---------------------+
  40. | *Setter* | set_disabled(value) |
  41. +-----------+---------------------+
  42. | *Getter* | is_disabled() |
  43. +-----------+---------------------+
  44. If ``true``, no collision will be produced.
  45. ----
  46. .. _class_CollisionPolygon_property_polygon:
  47. - :ref:`PoolVector2Array<class_PoolVector2Array>` **polygon**
  48. +-----------+--------------------------+
  49. | *Default* | ``PoolVector2Array( )`` |
  50. +-----------+--------------------------+
  51. | *Setter* | set_polygon(value) |
  52. +-----------+--------------------------+
  53. | *Getter* | get_polygon() |
  54. +-----------+--------------------------+
  55. Array of vertices which define the polygon.
  56. **Note:** The returned value is a copy of the original. Methods which mutate the size or properties of the return value will not impact the original polygon. To change properties of the polygon, assign it to a temporary variable and make changes before reassigning the ``polygon`` member.
  57. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  58. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  59. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`