Up to date

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

CollisionPolygon3D

继承： Node3D < Node < Object

向 CollisionObject3D 父级提供加厚多边形形状（角柱体）的节点。

描述

向 CollisionObject3D 父级提供加厚多边形形状（角柱体）的节点，能够为这个形状提供编辑的方法。该多边形可以是凹多边形，也可以是凸多边形。能够为 Area3D 提供检测形状，也能够将 PhysicsBody3D 变为实体。

警告：非均匀缩放的 CollisionShape3D 应该无法按预期工作。请确保它在所有轴上的缩放是一致的，可以用对形状资源的调整来代替非均匀缩放。

属性

float	depth	1.0
bool	disabled	false
float	margin	0.04
PackedVector2Array	polygon	PackedVector2Array()

---

属性说明

float depth = 1.0

• void set_depth ( float value )

• float get_depth ( )

产生的碰撞沿着与 2D 多边形垂直的任意方向深入的长度。

---

bool disabled = false

• void set_disabled ( bool value )

• bool is_disabled ( )

如果为 true，将不会产生碰撞。

---

float margin = 0.04

• void set_margin ( float value )

• float get_margin ( )

生成的 Shape3D 的碰撞边距。详情见 Shape3D.margin。

---

PackedVector2Array polygon = PackedVector2Array()

• void set_polygon ( PackedVector2Array value )

• PackedVector2Array get_polygon ( )

顶点数组，定义局部 XY 平面上的 2D 多边形。

注意：返回值为原始值的副本。修改返回值大小或属性的方法不会影响原始的多边形。要修改该多边形的属性，请先将其赋值给临时变量，修改完成后再重新赋值给该类属性。