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

Hereda: Node3D < Node < Object

Un nodo que proporciona una forma de polígono engrosada (un prisma) a un padre CollisionObject3D.

Descripción

Un nodo que proporciona una forma de polígono engrosada (un prisma) a un padre CollisionObject3D y permite editarla. El polígono puede ser cóncavo o convexo. Esto puede dar una forma de detección a un Area3D o convertir un PhysicsBody3D en un objeto sólido.

Advertencia: Un CollisionShape3D con una escala no uniforme probablemente no se comportará como se espera. Asegúrate de mantener su escala igual en todos los ejes y ajusta su recurso de forma (shape resource) en su lugar.

Propiedades

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()

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 debug_fill = true 🔗

  • void set_enable_debug_fill(value: bool)

  • bool get_enable_debug_fill()

Si es true, cuando se muestre la forma, mostrará un color de relleno sólido además de su estructura alámbrica.

float depth = 1.0 🔗

Longitud en la que la colisión resultante se extiende en cualquier dirección perpendicular a su polígono 2D.

bool disabled = false 🔗

  • void set_disabled(value: bool)

  • bool is_disabled()

Si es true, no se producirá ninguna colisión. Esta propiedad debe cambiarse con Object.set_deferred().

float margin = 0.04 🔗

  • void set_margin(value: float)

  • float get_margin()

El margen de colisión para el Shape3D generado. Véase Shape3D.margin para obtener más detalles.

PackedVector2Array polygon = PackedVector2Array() 🔗

Array de vértices que definen el polígono 2D en el plano XY local.

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