Shaders de particules

Les shaders de particules sont un type spécial de vert shader qui s'exécute avant que l'objet ne soit dessiné. Ils sont utilisés pour calculer les propriétés des matériaux telles que la couleur, la position et la rotation. Ils sont dessinés avec n'importe quel matériau de base de CanvasItem ou Spatial, selon qu'ils sont 2D ou 3D.

Les shaders de particules sont uniques car ils ne sont pas utilisés pour dessiner l'objet lui-même. Ils sont utilisés pour calculer les propriétés des particules, qui sont ensuite utilisées par le shader du CanvasItem ou du Spatial. Ils ne contiennent qu'une fonction de processeur de sommet qui a plusieurs propriétés en sortie (voir les propriétés intégrées ci-dessous).

Les shaders de particules utilisent un shader de feedback de transformation, qui est un type spécial de vertex shader qui fonctionne tout seul. Il prend les données d'entrée dans un tampon comme le fait un vertex shader ordinaire, mais il sort également les données vers un tampon au lieu de les envoyer vers le fragment shader pour le traitement des pixels. Pour cette raison, les shaders de feedback de transformation peuvent s'appuyer sur eux-mêmes à chaque exécution, contrairement aux autres shaders qui rejettent les données qu'ils ont calculées une fois qu'ils dessinent dans le tampon de trame.

Note

Les shaders de particules sont uniquement disponibles dans le backend GLES3. Si vous avez besoin de particules dans GLES2, utilisez des CPUParticles.

Mode de rendu

Mode de rendu Description
keep_data Ne pas effacer les données précédentes au redémarrage.
disable_force Désactiver la force d'attraction. (Pas actuellement implémenté dans la 3.1)
disable_velocity Ignorer la valeur de VELOCITY.

Variables intégrées

Les valeurs marquées comme "in" sont en lecture seule. Les valeurs marquées comme "out" sont pour l'écriture facultative et ne contiendront pas nécessairement de valeurs sensibles. Les valeurs marquées comme "inout" fournissent une valeur par défaut sensible et peuvent éventuellement être réécrites. Les échantillonneurs ne sont pas soumis à l'écriture et ne sont pas marqués.

Variables intégrées Globales

Les modules intégrés globaux sont disponibles partout, y compris dans les fonctions personnalisées.

Variable intégrée Description
in float TIME Temps global, en secondes.

Variables intégrées de sommet

Afin d'utiliser la variable COLOR dans un SpatialMaterial, définissez use_vertex_as_albedo sur true. Dans un ShaderMaterial, accédez-y avec la variable COLOR.

Variable intégrée Description
inout vec4 COLOR Couleur de particule, peut être écrit et accessible dans la fonction vertex du mesh.
inout vec3 VELOCITY La vélocité des particules, peut être modifiée.
out float MASS Masse de particules, utilisation pour les attracteurs (non implémentée en 3.1).
inout bool ACTIVE true quand la particule est active, peut être réglé sur false.
in bool RESTART true quand la particule doit redémarrer (cycle de vie).
inout vec4 CUSTOM Données personnalisées des particules. Accessible depuis le shader de la maille comme INSTANCE_CUSTOM.
inout mat4 TRANSFORM Transformation de particules.
in float LIFETIME Durée de vie des particules.
in float DELTA Durée du processus Delta.
in uint NUMBER Numéro unique depuis le début de l'émission.
in int INDEX Indice de particule (sur le nombre total de particules).
in mat4 EMISSION_TRANSFORM Transformation de l'émetteur (utilisée pour les systèmes non locaux).
in uint RANDOM_SEED Graine aléatoire utilisée comme base pour le hasard.