Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

ConcavePolygonShape3D

繼承: Shape3D < Resource < RefCounted < Object

用於物理碰撞的 3D 三角網格形狀。

說明

一種用於物理模擬的 3D 三角網格形狀。通常用於為 CollisionShape3D 提供形狀。

作為一組相互連接的三角形, ConcavePolygonShape3D 是最自由的可設定的單一 3D 形狀。它可以用於形成任何性質的多面體,甚至是不封閉體積的形狀。然而,即使相互連接的三角形封閉了一個體積, ConvexPolygonShape3D 仍然是中空的,這常常使其不適用於物理模擬或碰撞檢測。

注意:當用於碰撞計算時, ConcavePolygonShape3D 旨在與 StaticBody3D 等靜態 CollisionShape3D 節點一起使用 。並且對於 CharacterBody3D 或 RigidBody3D,在除靜態模式之外的其他模式下可能表現不佳。

警告:較小的物理物體在快速移動時有機會穿過該形狀。發生這種情況是因為在一影格上,物理物體可能位於形狀的“外部”,而在下一影格上,它可能位於形狀的“內部”。由於ConcavePolygonShape3D 是中空的,因此它不會檢測到碰撞。

效能:由於其複雜性, ConcavePolygonShape3D 是檢測碰撞最慢的 3D 碰撞形狀。它的使用一般僅限於關卡幾何體。對於凸幾何體,應使用 ConvexPolygonShape3D 。對於需要凹碰撞的動態物體,可以使用多個 ConvexPolygonShape3D 通過凸分解來表示其碰撞;相關說明請參閱 ConvexPolygonShape3D 文件。

教學

屬性

bool

backface_collision

false

方法

PackedVector3Array

get_faces() const

void

set_faces(faces: PackedVector3Array)


屬性說明

bool backface_collision = false 🔗

  • void set_backface_collision_enabled(value: bool)

  • bool is_backface_collision_enabled()

如果設定為 true,則碰撞會發生在凹形面的兩側。否則,它們只會沿著面法線發生。


方法說明

PackedVector3Array get_faces() const 🔗

以頂點陣列的形式返回三角網格形狀中的面。該(長度能被三整除的)陣列自然三三分組;每組中的三個頂點定義一個三角形。


void set_faces(faces: PackedVector3Array) 🔗

根據頂點陣列設定三角網格形狀的面。faces 陣列應更多由若干三元組構成,每三個頂點定義一個三角形。