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.

CollisionPolygon3D

Hérite de : Node3D < Node < Object

Un nœud qui fournit une forme de polygone épaissie (un prisme) à un CollisionObject3D parent.

Description

Un nœud qui fournit une forme de polygone épaissie (un prisme) à un CollisionObject3D parent et permet de l'éditer. Le polygone peut être concave ou convexe. Cela peut donner une forme de détection à une Area3D ou transformer un PhysicsBody3D en un objet solide.

Attention : Une CollisionShape3D avec une échelle non uniforme ne se comportera probablement pas comme prévu. Assurez-vous de garder la même échelle sur tous les axes et d'ajuster sa ressource de forme à la place.

Propriétés

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


Descriptions des propriétés

Color debug_color = Color(0, 0, 0, 0) 🔗

  • void set_debug_color(value: Color)

  • Color get_debug_color()

La couleur de la forme de collision qui est affichée dans l'éditeur, ou dans le projet en cours d'exécution si Débogage > Formes de collision visibles est coché en haut de l'éditeur.

Note : La valeur par défaut est ProjectSettings.debug/shapes/collision/shape_color. La valeur Color(0, 0, 0, 0) documentée ici est une valeur générique, et pas la couleur de débogage par défaut réelle.


bool debug_fill = true 🔗

  • void set_enable_debug_fill(value: bool)

  • bool get_enable_debug_fill()

Si true, lorsque la forme est affichée, elle affichera une couleur de remplissage solide en plus de son fil de fer.


float depth = 1.0 🔗

Longueur à laquelle la collision résultante s'étend dans une direction perpendiculaire à son polygone 2D.


bool disabled = false 🔗

  • void set_disabled(value: bool)

  • bool is_disabled()

Si true, aucune collision ne sera produite. Cette propriété devrait être modifiée avec Object.set_deferred().


float margin = 0.04 🔗

  • void set_margin(value: float)

  • float get_margin()

La marge de collision pour la Shape3D générée. Voir Shape3D.margin pour plus d'informations.


PackedVector2Array polygon = PackedVector2Array() 🔗

Tableau de sommets qui définissent le polygone 2D dans le plan 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.