CollisionShape2D

继承： Node2D < CanvasItem < Node < Object

向 CollisionObject2D 父级提供 Shape2D 的节点。

描述

A node that provides a Shape2D to a CollisionObject2D parent and allows it to be edited. This can give a detection shape to an Area2D or turn a PhysicsBody2D into a solid object.

教程

• 物理介绍

• 2D Dodge The Creeps 演示

• 2D Pong 演示

• 2D 运动学角色演示

属性

Color	debug_color	Color(0, 0, 0, 0)
bool	disabled	false
bool	one_way_collision	false
float	one_way_collision_margin	1.0
Shape2D	shape

---

属性说明

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 disabled = false 🔗

• void set_disabled(value: bool)

• bool is_disabled()

禁用的碰撞形状在世界中没有影响。这个属性应该用 Object.set_deferred() 改变。

---

bool one_way_collision = false 🔗

• void set_one_way_collision(value: bool)

• bool is_one_way_collision_enabled()

设置此碰撞形状是否仅应检测到一侧（顶部或底部）的碰撞。

注意：如果这个 CollisionShape2D 是 Area2D 节点的子节点，则这个属性无效。

---

float one_way_collision_margin = 1.0 🔗

• void set_one_way_collision_margin(value: float)

• float get_one_way_collision_margin()

用于单向碰撞的边距（以像素为单位）。较高的值将使形状更厚，并且对于高速进入形状的对撞机来说效果更好。

---

Shape2D shape 🔗

• void set_shape(value: Shape2D)

• Shape2D get_shape()

该碰撞形状拥有的实际形状。