Startseite Erkunden Hilfe
Anmelden
godotengine
/
godot-docs
Mirror von https://github.com/godotengine/godot-docs
Beobachten 1
Favorit hinzufügen 1
Fork 0
Dateien
Branch: 4.2
Branches Tags
godot-docs
/
classes
/
class_convexpolygonshape3d.rst

class_convexpolygonshape3d.rst 4.2 KB
Permalink Verlauf Originalformat

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778 
  1. :github_url: hide
    2. 

  2. 

  3. .. DO NOT EDIT THIS FILE!!!
    4. 

  4. .. Generated automatically from Godot engine sources.
    5. 

  5. .. Generator: https://github.com/godotengine/godot/tree/4.2/doc/tools/make_rst.py.
    6. 

  6. .. XML source: https://github.com/godotengine/godot/tree/4.2/doc/classes/ConvexPolygonShape3D.xml.
    7. 

  7. 

  8. .. _class_ConvexPolygonShape3D:
    9. 

  9. 

  10. ConvexPolygonShape3D
    11. 

  11. ====================
    12. 

  12. 

  13. **Inherits:** :ref:`Shape3D<class_Shape3D>` **<** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
    14. 

  14. 

  15. A 3D convex polyhedron shape used for physics collision.
    16. 

  16. 

  17. .. rst-class:: classref-introduction-group
    18. 

  18. 

  19. Description
    20. 

  20. -----------
    21. 

  21. 

  22. A 3D convex polyhedron shape, intended for use in physics. Usually used to provide a shape for a :ref:`CollisionShape3D<class_CollisionShape3D>`.
    23. 

  23. 

  24. \ **ConvexPolygonShape3D** is *solid*, which means it detects collisions from objects that are fully inside it, unlike :ref:`ConcavePolygonShape3D<class_ConcavePolygonShape3D>` which is hollow. This makes it more suitable for both detection and physics.
    25. 

  25. 

  26. \ **Convex decomposition:** A concave polyhedron can be split up into several convex polyhedra. This allows dynamic physics bodies to have complex concave collisions (at a performance cost) and can be achieved by using several **ConvexPolygonShape3D** nodes. To generate a convex decomposition from a mesh, select the :ref:`MeshInstance3D<class_MeshInstance3D>` node, go to the **Mesh** menu that appears above the viewport, and choose **Create Multiple Convex Collision Siblings**. Alternatively, :ref:`MeshInstance3D.create_multiple_convex_collisions<class_MeshInstance3D_method_create_multiple_convex_collisions>` can be called in a script to perform this decomposition at run-time.
    27. 

  27. 

  28. \ **Performance:** **ConvexPolygonShape3D** is faster to check collisions against compared to :ref:`ConcavePolygonShape3D<class_ConcavePolygonShape3D>`, but it is slower than primitive collision shapes such as :ref:`SphereShape3D<class_SphereShape3D>` and :ref:`BoxShape3D<class_BoxShape3D>`. Its use should generally be limited to medium-sized objects that cannot have their collision accurately represented by primitive shapes.
    29. 

  29. 

  30. .. rst-class:: classref-introduction-group
    31. 

  31. 

  32. Tutorials
    33. 

  33. ---------
    34. 

  34. 

  35. - `3D Physics Tests Demo <https://godotengine.org/asset-library/asset/675>`__
    36. 

  36. 

  37. .. rst-class:: classref-reftable-group
    38. 

  38. 

  39. Properties
    40. 

  40. ----------
    41. 

  41. 

  42. .. table::
    43. 

  43.    :widths: auto
    44. 

  44. 

  45.    +-----------------------------------------------------+-----------------------------------------------------------+--------------------------+
    46. 

  46.    | :ref:`PackedVector3Array<class_PackedVector3Array>` | :ref:`points<class_ConvexPolygonShape3D_property_points>` | ``PackedVector3Array()`` |
    47. 

  47.    +-----------------------------------------------------+-----------------------------------------------------------+--------------------------+
    48. 

  48. 

  49. .. rst-class:: classref-section-separator
    50. 

  50. 

  51. ----
    52. 

  52. 

  53. .. rst-class:: classref-descriptions-group
    54. 

  54. 

  55. Property Descriptions
    56. 

  56. ---------------------
    57. 

  57. 

  58. .. _class_ConvexPolygonShape3D_property_points:
    59. 

  59. 

  60. .. rst-class:: classref-property
    61. 

  61. 

  62. :ref:`PackedVector3Array<class_PackedVector3Array>` **points** = ``PackedVector3Array()``
    63. 

  63. 

  64. .. rst-class:: classref-property-setget
    65. 

  65. 

  66. - void **set_points** **(** :ref:`PackedVector3Array<class_PackedVector3Array>` value **)**
    67. 

  67. - :ref:`PackedVector3Array<class_PackedVector3Array>` **get_points** **(** **)**
    68. 

  68. 

  69. The list of 3D points forming the convex polygon shape.
    70. 

  70. 

  71. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
    72. 

  72. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
    73. 

  73. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
    74. 

  74. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
    75. 

  75. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
    76. 

  76. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
    77. 

  77. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`
    78. 

  78.