CollisionPolygon2D

Hereda: Node2D < CanvasItem < Node < Object

Un nodo que proporciona una forma de polígono a un padre CollisionObject2D.

Descripción

A node that provides a polygon shape to a CollisionObject2D parent and allows to edit it. The polygon can be concave or convex. This can give a detection shape to an Area2D, turn PhysicsBody2D into a solid object, or give a hollow shape to a StaticBody2D.

Warning: A non-uniformly scaled CollisionPolygon2D will likely not behave as expected. Make sure to keep its scale the same on all axes and adjust its polygon instead.

Propiedades

BuildMode	build_mode	`0`
bool	disabled	`false`
bool	one_way_collision	`false`
float	one_way_collision_margin	`1.0`
PackedVector2Array	polygon	`PackedVector2Array()`

Enumeraciones

enum BuildMode: 🔗

BuildMode BUILD_SOLIDS = 0

Las colisiones incluirán el polígono y su área contenida. En este modo, el nodo tiene el mismo efecto que varios nodos ConvexPolygonShape2D, uno para cada forma convexa en la descomposición convexa del polígono (pero sin la sobrecarga de múltiples nodos).

BuildMode BUILD_SEGMENTS = 1

Las colisiones solo incluirán los bordes del polígono. En este modo, el nodo tiene el mismo efecto que un único ConcavePolygonShape2D hecho de segmentos, con la restricción de que cada segmento (después del primero) comienza donde termina el anterior, y el último termina donde comienza el primero (formando un polígono cerrado pero hueco).

Descripciones de Propiedades

BuildMode build_mode = 0 🔗

void set_build_mode(value: BuildMode)
BuildMode get_build_mode()

Modo de construcción de colisión.

bool disabled = false 🔗

void set_disabled(value: bool)
bool is_disabled()

Si es true, no se detectarán colisiones. 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()

Si es true, solo los bordes que miren hacia arriba, con relación a la rotación de CollisionPolygon2D, colisionarán con otros objetos.

Nota: Esta propiedad no tiene ningún efecto si este CollisionPolygon2D es hijo de un nodo Area2D.

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 el polígono a alta velocidad.

PackedVector2Array polygon = PackedVector2Array() 🔗

void set_polygon(value: PackedVector2Array)
PackedVector2Array get_polygon()

The polygon's list of vertices. Each point will be connected to the next, and the final point will be connected to the first.

Note: The returned vertices are in the local coordinate space of the given CollisionPolygon2D.

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