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...

CollisionPolygon3D

继承： Node3D < Node < Object

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

描述

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

警告：非均匀缩放的 CollisionShape3D 可能不会按预期运行。请确保在所有轴上保持其缩放相同并改为调整其形状资源。

属性

Color

debug_color

Color(0, 0, 0, 0)

bool

debug_fill

true

float

depth

1.0

bool

disabled

false

float

margin

0.04

PackedVector2Array

polygon

PackedVector2Array()

属性说明

Color debug_color = Color(0, 0, 0, 0) 🔗

  • void set_debug_color(value: Color)

  • Color get_debug_color()

碰撞形状的颜色，在编辑器中显示，勾选编辑器顶部的 调试 > 显示碰撞形状 时也会在运行项目时显示。

注意：默认值为 ProjectSettings.debug/shapes/collision/shape_color。这里记录的 Color(0, 0, 0, 0) 值是占位符，不是实际的默认调试颜色。

bool debug_fill = true 🔗

  • void set_enable_debug_fill(value: bool)

  • bool get_enable_debug_fill()

如果为 true，则显示形状时除了显示线框外还会显示填充颜色。

float depth = 1.0 🔗

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

bool disabled = false 🔗

  • void set_disabled(value: bool)

  • bool is_disabled()

如果为 true，则不会产生碰撞。该属性应使用 Object.set_deferred() 进行更改。

float margin = 0.04 🔗

  • void set_margin(value: float)

  • float get_margin()

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

PackedVector2Array polygon = PackedVector2Array() 🔗

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

Note: The returned array is copied and any changes to it will not update the original property value. See PackedVector2Array for more details.