class_collisionshape2d.rst 3.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
  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 CollisionShape2D.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_CollisionShape2D:
  6. CollisionShape2D
  7. ================
  8. **Inherits:** :ref:`Node2D<class_Node2D>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  9. **Category:** Core
  10. Brief Description
  11. -----------------
  12. Node that represents collision shape data in 2D space.
  13. Properties
  14. ----------
  15. +-------------------------------+-------------------------------------------------------------------------------------------+
  16. | :ref:`bool<class_bool>` | :ref:`disabled<class_CollisionShape2D_property_disabled>` |
  17. +-------------------------------+-------------------------------------------------------------------------------------------+
  18. | :ref:`bool<class_bool>` | :ref:`one_way_collision<class_CollisionShape2D_property_one_way_collision>` |
  19. +-------------------------------+-------------------------------------------------------------------------------------------+
  20. | :ref:`float<class_float>` | :ref:`one_way_collision_margin<class_CollisionShape2D_property_one_way_collision_margin>` |
  21. +-------------------------------+-------------------------------------------------------------------------------------------+
  22. | :ref:`Shape2D<class_Shape2D>` | :ref:`shape<class_CollisionShape2D_property_shape>` |
  23. +-------------------------------+-------------------------------------------------------------------------------------------+
  24. Description
  25. -----------
  26. Editor facility for creating and editing collision shapes in 2D space. You can use this node to represent all sorts of collision shapes, for example, add this to an :ref:`Area2D<class_Area2D>` to give it a detection shape, or add it to a :ref:`PhysicsBody2D<class_PhysicsBody2D>` to create a solid object. **IMPORTANT**: this is an Editor-only helper to create shapes, use :ref:`CollisionObject2D.shape_owner_get_shape<class_CollisionObject2D_method_shape_owner_get_shape>` to get the actual shape.
  27. Tutorials
  28. ---------
  29. - :doc:`../tutorials/physics/physics_introduction`
  30. Property Descriptions
  31. ---------------------
  32. .. _class_CollisionShape2D_property_disabled:
  33. - :ref:`bool<class_bool>` **disabled**
  34. +----------+---------------------+
  35. | *Setter* | set_disabled(value) |
  36. +----------+---------------------+
  37. | *Getter* | is_disabled() |
  38. +----------+---------------------+
  39. A disabled collision shape has no effect in the world.
  40. ----
  41. .. _class_CollisionShape2D_property_one_way_collision:
  42. - :ref:`bool<class_bool>` **one_way_collision**
  43. +----------+--------------------------------+
  44. | *Setter* | set_one_way_collision(value) |
  45. +----------+--------------------------------+
  46. | *Getter* | is_one_way_collision_enabled() |
  47. +----------+--------------------------------+
  48. Sets whether this collision shape should only detect collision on one side (top or bottom).
  49. ----
  50. .. _class_CollisionShape2D_property_one_way_collision_margin:
  51. - :ref:`float<class_float>` **one_way_collision_margin**
  52. +----------+-------------------------------------+
  53. | *Setter* | set_one_way_collision_margin(value) |
  54. +----------+-------------------------------------+
  55. | *Getter* | get_one_way_collision_margin() |
  56. +----------+-------------------------------------+
  57. ----
  58. .. _class_CollisionShape2D_property_shape:
  59. - :ref:`Shape2D<class_Shape2D>` **shape**
  60. +----------+------------------+
  61. | *Setter* | set_shape(value) |
  62. +----------+------------------+
  63. | *Getter* | get_shape() |
  64. +----------+------------------+
  65. The actual shape owned by this collision shape.