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.

ConvexPolygonShape3D

Eredita: Shape3D < Resource < RefCounted < Object

Una forma di poliedro convesso 3D utilizzata per le collisioni fisiche.

Descrizione

Una forma di poliedro convesso 3D, progettata per l'uso in fisica. Solitamente utilizzata per fornire una forma per un CollisionShape3D.

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

Decomposizione convessa: Un poliedro concavo può essere suddiviso in diversi poliedri convessi. Ciò consente ai corpi di fisica dinamici di avere collisioni concave complesse (a un costo in termini di prestazioni) e può essere ottenuto tramite più nodi ConvexPolygonShape3D. Per generare una decomposizione convessa da una mesh, seleziona il nodo MeshInstance3D, vai al menu Mesh che appare sopra la viewport e scegli Crea più fratelli di collisione convessa. In alternativa, MeshInstance3D.create_multiple_convex_collisions() può essere chiamato in uno script per eseguire questa decomposizione in fase di esecuzione.

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

Tutorial

Proprietà

PackedVector3Array

points

PackedVector3Array()


Descrizioni delle proprietà

PackedVector3Array points = PackedVector3Array() 🔗

La lista dei punti 3D che formano la forma del poligono convesso.

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