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...

ConcavePolygonShape3D

Hérite de : Shape3D < Resource < RefCounted < Object

Une forme de maillage triangulaire 3D utilisée pour les collisions physiques.

Description

Une forme de maillage triangulaire 3D, destinée à être utilisée pour la physique. Habituellement utilisée pour fournir une forme à un CollisionShape3D.

Étant seulement une collection de triangles interconnectés, ConcavePolygonShape3D est la forme 3D la plus librement configurable. Elle peut être utilisée pour former des polyèdres de toute nature, ou même des formes qui n'entourent pas de volume. Cependant, ConcavePolygonShape3D est creuse même si les triangles interconnectés entourent effectivement une zone, ce qui la rend souvent inappropriée pour la physique ou la détection.

Note : Lorsqu'elle est utilisée pour la collision, ConcavePolygonShape3D est destinée à travailler avec des nœuds CollisionShape3D statiques comme StaticBody3D et ne se comportera probablement pas bien pour des CharacterBody3D ou des RigidBody3D dans un mode autre que Statique.

Attention : Les corps physiques qui sont petits ont la chance de traverser cette forme en se déplaçant rapidement. Cela se produit parce que sur une trame, le corps physique peut être "en dehors" de la forme, et sur le prochaine trame il peut être "dans" celle-ci. ConcavePolygonShape3D est creuse, donc elle ne détectera pas de collision.

Performance : En raison de sa complexité, ConcavePolygonShape3D est la forme de collision 3D la plus lente pour vérifier les collisions. Son utilisation devrait généralement être limitée à la géométrie de niveau. Pour de la géométrie convexe, ConvexPolygonShape3D devrait être utilisée. Pour les objets physiques dynamiques qui nécessite des collisions concaves, plusieurs ConvexPolygonShape3Ds peuvent être utilisés pour représenter sa collision en utilisant une décomposition convexe. Voir la documentation de ConvexPolygonShape3D pour les instructions.

Tutoriels

Propriétés

bool

backface_collision

false

Méthodes

PackedVector3Array

get_faces() const

void

set_faces(faces: PackedVector3Array)

Descriptions des propriétés

bool backface_collision = false 🔗

  • void set_backface_collision_enabled(value: bool)

  • bool is_backface_collision_enabled()

Si défini à true, les collisions se produisent des deux côtés des faces de forme concave. Sinon elles ne se produisent que le long de la normale de la face.

Descriptions des méthodes

PackedVector3Array get_faces() const 🔗

Renvoie les faces de la forme de maillage triangulaire en tant que tableau de sommets. Le tableau (de longueur divisible par trois) est naturellement divisé en triplets. Chaque triplet de sommets définit un triangle.

void set_faces(faces: PackedVector3Array) 🔗

Définit les faces de la forme de maillage triangulaire depuis un tableau de sommets. Le tableau faces devrait être composé de triplets de sorte que chaque triplet de sommets définit un triangle.