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

CSGPolygon3D

Hérite de : CSGPrimitive3D < CSGShape3D < GeometryInstance3D < VisualInstance3D < Node3D < Node < Object

Extrude une forme de polygone 2D pour créer un maillage 3D.

Description

Un tableau de points 2D est extrudé pour créer rapidement et facilement une variété de maillages 3D. Voir aussi CSGMesh3D pour l'utilisation des maillages 3D comme nœuds CSG.

**Note : ** Les nœuds CSG sont destinés à être utilisés pour le prototypage de niveau. Créer des nœuds CSG a un coût CPU important comparé à la création d'un MeshInstance3D avec un PrimitiveMesh. Déplacer un nœud CSG dans un autre nœud CSG a également un coût CPU important, ceci devrait donc être évité pendant le gameplay.

Tutoriels

Propriétés

float

depth

1.0

Material

material

Mode

mode

0

bool

path_continuous_u

float

path_interval

PathIntervalType

path_interval_type

bool

path_joined

bool

path_local

NodePath

path_node

PathRotation

path_rotation

bool

path_rotation_accurate

float

path_simplify_angle

float

path_u_distance

PackedVector2Array

polygon

PackedVector2Array(0, 0, 0, 1, 1, 1, 1, 0)

bool

smooth_faces

false

float

spin_degrees

int

spin_sides

Énumérations

enum Mode: 🔗

Mode MODE_DEPTH = 0

La forme polygon est extrudée le long de l'axe Z négatif.

Mode MODE_SPIN = 1

La forme polygon est extrudée en la faisant pivoter autour de l'axe Y.

Mode MODE_PATH = 2

La forme polygon est extrudée le long du Path3D spécifié par path_node.

enum PathRotation: 🔗

PathRotation PATH_ROTATION_POLYGON = 0

La forme polygon n'est pas tournée.

Note : Nécessite que les coordonnées Z du chemin diminuent en continu pour assurer des formes viables.

PathRotation PATH_ROTATION_PATH = 1

La forme polygon est tournée le long du chemin, mais elle n'est pas tournée autour de l'axe du chemin.

Note : Nécessite que les coordonnées Z du chemin diminuent en continu pour assurer des formes viables.

PathRotation PATH_ROTATION_PATH_FOLLOW = 2

La forme polygon suit le chemin et pivote autour de l'axe du chemin.

enum PathIntervalType: 🔗

PathIntervalType PATH_INTERVAL_DISTANCE = 0

Lorsque mode est défini à MODE_PATH, path_interval déterminera la distance, en mètres, entre chaque intervalle où le chemin s'extrudera.

PathIntervalType PATH_INTERVAL_SUBDIVIDE = 1

Lorsque mode est défini MODE_PATH, path_interval divisera les polygones le long du chemin.

Descriptions des propriétés

float depth = 1.0 🔗

Quand mode est MODE_DEPTH, la profondeur de l'extrusion.

Material material 🔗

Matériau à utiliser pour le maillage résultant. Les UV associent la partie supérieure du matériau à la forme extrudée (U le long de la longueur des extrusions et V autour du contour du polygon), le quart inférieur gauche à la face de fin avant, et le quart inférieur droit à la face de fin arrière.

Mode mode = 0 🔗

  • void set_mode(value: Mode)

  • Mode get_mode()

Le mode utilisé pour extruder le polygon.

bool path_continuous_u 🔗

  • void set_path_continuous_u(value: bool)

  • bool is_path_continuous_u()

Lorsque mode est MODE_PATH, par défaut, la moitié supérieure du material est étirée sur toute la longueur de la forme extrudée. Si false la partie supérieure du matériau est répétée à chaque étape de l'extrusion.

float path_interval 🔗

  • void set_path_interval(value: float)

  • float get_path_interval()

Lorsque mode est MODE_PATH, l'intervalle de chemin ou le rapport de chemin pointe vers les extrusions.

PathIntervalType path_interval_type 🔗

Lorsque mode est MODE_PATH, cela déterminera si l'intervalle doit être suivant la distance (PATH_INTERVAL_DISTANCE) ou suivant une fraction des sous-divisions (PATH_INTERVAL_SUBDIVIDE).

bool path_joined 🔗

  • void set_path_joined(value: bool)

  • bool is_path_joined()

Lorsque mode est MODE_PATH, si true les extrémités du chemin sont jointes, en ajoutant une extrusion entre le dernier et le premier points du chemin.

bool path_local 🔗

  • void set_path_local(value: bool)

  • bool is_path_local()

Lorsque mode vaut MODE_PATH, si true la Transform3D du CSGPolygon3D est utilisée comme point de départ pour les extrusions, et non pas la Transform3D du path_node.

NodePath path_node 🔗

Lorsque mode vaut MODE_PATH, l'emplacement de l'objet Path3D est utilisé pour extruder le polygon.

PathRotation path_rotation 🔗

Lorsque mode vaut MODE_PATH, la méthode de rotation du chemin est utilisée pour faire pivoter le polygon durant son extrusion.

bool path_rotation_accurate 🔗

  • void set_path_rotation_accurate(value: bool)

  • bool get_path_rotation_accurate()

Lorsque mode vaut MODE_PATH, si true, le polygone sera tourné selon la tangente au chemin exacte aux points échantillonnés. Si false une approximation est utilisée, ce qui diminue en précision lorsque le nombre de sous-divisions diminue.

float path_simplify_angle 🔗

  • void set_path_simplify_angle(value: float)

  • float get_path_simplify_angle()

Lorsque mode est MODE_PATH, les extrusions qui sont inférieures à cet angle seront fusionnés pour réduire le nombre de polygones.

float path_u_distance 🔗

  • void set_path_u_distance(value: float)

  • float get_path_u_distance()

Lorsque mode est MODE_PATH, c'est la distance le long du chemin, en mètres, que les coordonnées de texture seront répétées. Quand à 0, les coordonnées de texture correspondront exactement à la géométrie sans répétition.

PackedVector2Array polygon = PackedVector2Array(0, 0, 0, 1, 1, 1, 1, 0) 🔗

Le tableau de points qui définit le polygone 2D extrudé. Cela peut être un polygone convexe ou concave avec 3 points ou plus. Le polygone ne doit pas avoir de bords qui sont des intersections. Sinon, la triangulation échouera et aucun maillage ne sera généré.

Note : Si seulement 1 ou 2 points sont définis dans polygon, aucun maillage ne sera généré.

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

bool smooth_faces = false 🔗

  • void set_smooth_faces(value: bool)

  • bool get_smooth_faces()

Si true, applique un ombrage lisse aux extrusions.

float spin_degrees 🔗

  • void set_spin_degrees(value: float)

  • float get_spin_degrees()

Quand mode vaut MODE_SPIN, le nombre total de degrés dont le polygone polygon est tourné lors de l'extrusion.

int spin_sides 🔗

  • void set_spin_sides(value: int)

  • int get_spin_sides()

Quand mode est MODE_SPIN, le nombre d'extrusions faites.