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.

CollisionShape2D

Hereda: Node2D < CanvasItem < Node < Object

Un nodo que proporciona una Shape2D a un padre CollisionObject2D.

Descripción

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.

Tutoriales

Propiedades

Color

debug_color

Color(0, 0, 0, 0)

bool

disabled

false

bool

one_way_collision

false

Vector2

one_way_collision_direction

Vector2(0, 1)

float

one_way_collision_margin

1.0

Shape2D

shape


Descripciones de Propiedades

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

  • void set_debug_color(value: Color)

  • Color get_debug_color()

El color de la forma de colisión (collision shape) que se muestra en el editor, o en el proyecto en ejecución si la opción Depuración > Formas de colisión visibles está marcada en la parte superior del editor.

Nota: El valor por defecto es ProjectSettings.debug/shapes/collision/shape_color. El valor Color(0, 0, 0, 0) documentado aquí es un marcador de posición (placeholder) y no el color de depuración real por defecto.


bool disabled = false 🔗

  • void set_disabled(value: bool)

  • bool is_disabled()

Una forma de colisión desactivada no tiene ningún efecto en el mundo. Esta propiedad debe cambiarse con Object.set_deferred().


bool one_way_collision = false 🔗

  • void set_one_way_collision(value: bool)

  • bool is_one_way_collision_enabled()

Sets whether this collision shape should only detect collision on one side (top or bottom).

Note: This property has no effect if this CollisionShape2D is a child of an Area2D node.

Note: The one way collision direction can be configured by setting one_way_collision_direction.


Vector2 one_way_collision_direction = Vector2(0, 1) 🔗

  • void set_one_way_collision_direction(value: Vector2)

  • Vector2 get_one_way_collision_direction()

The direction used for one-way collision.


float one_way_collision_margin = 1.0 🔗

  • void set_one_way_collision_margin(value: float)

  • float get_one_way_collision_margin()

El margen utilizado para la colisión en un sentido (en píxeles). Valores más altos harán la forma más gruesa, y funcionará mejor para los colisionadores que entran en la forma a alta velocidad.


Shape2D shape 🔗

La forma actual que posee esta forma de colisión.