Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

ConvexPolygonShape3D¶

继承： Shape3D < Resource < RefCounted < Object

用于物理碰撞的 3D 凸多面体形状。

描述¶

3D 凸多面体形状，旨在用于物理。常用来为 CollisionShape3D 提供形状。

ConvexPolygonShape3D 是实心的，与空心的 ConcavePolygonShape3D 不同，如果对象完全位于其内部，也能够检测到碰撞。因此更适于检测和物理。

凸分解：凹多面体可以拆分为多个凸多面体。这样就能够让动态物理体拥有复杂的凹碰撞（以消耗性能为代价），做法是使用多个 ConvexPolygonShape3D 节点。要根据网格生成凸分解，请选中 MeshInstance3D 节点，前往出现在视口上方的 Mesh 菜单，然后选择创建多个凸碰撞同级。或者也可以在脚本中调用 MeshInstance3D.create_multiple_convex_collisions，在运行时执行分解。

性能：ConvexPolygonShape3D 检查碰撞的速度比 ConcavePolygonShape3D 要快，但比 SphereShape3D、BoxShape3D 等基本碰撞形状要慢。通常应该仅限于中等大小的对象，在无法使用基本形状精确表示碰撞时使用。