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.
Checking the stable version of the documentation...
ConcavePolygonShape3D
繼承: Shape3D < Resource < RefCounted < Object
用於物理碰撞的 3D 三角網格形狀。
說明
一種用於物理模擬的 3D 三角網格形狀。通常用於為 CollisionShape3D 提供形狀。
作為一組相互連接的三角形, ConcavePolygonShape3D 是最自由的可設定的單一 3D 形狀。它可以用於形成任何性質的多面體,甚至是不封閉體積的形狀。然而,即使相互連接的三角形封閉了一個體積, ConvexPolygonShape3D 仍然是中空的,這常常使其不適用於物理模擬或碰撞檢測。
注意:當用於碰撞計算時, ConcavePolygonShape3D 旨在與 StaticBody3D 等靜態 CollisionShape3D 節點一起使用 。並且對於 CharacterBody3D 或 RigidBody3D,在除靜態模式之外的其他模式下可能表現不佳。
警告:較小的物理物體在快速移動時有機會穿過該形狀。發生這種情況是因為在一影格上,物理物體可能位於形狀的“外部”,而在下一影格上,它可能位於形狀的“內部”。由於ConcavePolygonShape3D 是中空的,因此它不會檢測到碰撞。
效能:由於其複雜性, ConcavePolygonShape3D 是檢測碰撞最慢的 3D 碰撞形狀。它的使用一般僅限於關卡幾何體。對於凸幾何體,應使用 ConvexPolygonShape3D 。對於需要凹碰撞的動態物體,可以使用多個 ConvexPolygonShape3D 通過凸分解來表示其碰撞;相關說明請參閱 ConvexPolygonShape3D 文件。
教學
屬性
|
方法
get_faces() const |
|
void |
set_faces(faces: PackedVector3Array) |
屬性說明
bool backface_collision = false 🔗
如果設定為 true,則碰撞會發生在凹形面的兩側。否則,它們只會沿著面法線發生。
方法說明
PackedVector3Array get_faces() const 🔗
以頂點陣列的形式返回三角網格形狀中的面。該(長度能被三整除的)陣列自然三三分組;每組中的三個頂點定義一個三角形。
void set_faces(faces: PackedVector3Array) 🔗
根據頂點陣列設定三角網格形狀的面。faces 陣列應更多由若干三元組構成,每三個頂點定義一個三角形。