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.

ConvexPolygonShape2D

Eredita: Shape2D < Resource < RefCounted < Object

Una forma poligonale convessa 2D utilizzata per le collisioni fisiche.

Descrizione

Una forma poligonale convessa 2D, progettata per l'uso in fisica. Utilizzata internamente in CollisionPolygon2D quando è in modalità CollisionPolygon2D.BUILD_SOLIDS.

ConvexPolygonShape2D è solido, il che significa che rileva le collisioni da oggetti che sono completamente al suo interno, a differenza di ConcavePolygonShape2D che è cavo. Ciò la rende più adatta sia per il rilevamento sia per la fisica.

Decomposizione convessa: Un poligono concavo può essere suddiviso in diversi poligoni convessi. Ciò consente ai corpi di fisica dinamici di avere collisioni complesse concave (a scapito delle prestazioni) e può essere ottenuto tramite più nodi ConvexPolygonShape2D o tramite il nodo CollisionPolygon2D in modalità CollisionPolygon2D.BUILD_SOLIDS. Per generare un poligono di collisione da uno sprite, seleziona il nodo Sprite2D, vai al menu Sprite2D che appare sopra la viewport e scegli Crea Polygon2D fratello.

Prestazioni: ConvexPolygonShape2D è più veloce per verificare le collisioni rispetto a ConcavePolygonShape2D, ma è più lento delle forme di collisione primitive come CircleShape2D e RectangleShape2D. Il suo utilizzo dovrebbe essere generalmente limitato agli oggetti di medie dimensioni la cui collisione non può essere rappresentata accuratamente dalle forme primitive.

Proprietà

PackedVector2Array

points

PackedVector2Array()

Metodi

void

set_point_cloud(point_cloud: PackedVector2Array)


Descrizioni delle proprietà

PackedVector2Array points = PackedVector2Array() 🔗

La lista dei vertici del poligono che formano un hull convesso. Può essere ordinata in senso orario o antiorario.

Attenzione: Imposta questa proprietà solo su una lista di punti che formano effettivamente un hull convesso. Utilizza set_point_cloud() per generare l'hull convesso da un insieme arbitrario di punti.

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


Descrizioni dei metodi

void set_point_cloud(point_cloud: PackedVector2Array) 🔗

In base alla serie di punti fornita, questo assegna la proprietà points attraverso l'algoritmo hull convesso, rimuovendo tutti i punti non necessari. Vedi Geometry2D.convex_hull() per i dettagli.