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

GPUParticlesAttractor3D

Hérite de : VisualInstance3D < Node3D < Node < Object

Hérité par : GPUParticlesAttractorBox3D, GPUParticlesAttractorSphere3D, GPUParticlesAttractorVectorField3D

Classe de base abstraite pour les attracteurs de particules 3D.

Description

Les attracteurs de particules peuvent être utilisés pour attirer des particules vers l'origine de l'attracteur, ou pour les repousser de l'origine de l'attracteur.

Les attracteurs de particules fonctionnent en temps réel et peuvent être déplacés, tournés et redimensionnés pendant le gameplay. Contrairement aux formes de collision, une échelle non uniforme d'attracteur est également supportée.

Les attracteurs peuvent être temporairement désactivés en les cachant, ou en définissant leur force strength à 0.0.

Note : Les attracteurs de particules n'affectent que les GPUParticles3D, pas les CPUParticles3D.

Propriétés

float

attenuation

1.0

int

cull_mask

4294967295

float

directionality

0.0

float

strength

1.0

Descriptions des propriétés

float attenuation = 1.0 🔗

  • void set_attenuation(value: float)

  • float get_attenuation()

L'atténuation de l'attracteur à particules. Des valeurs plus élevées résultent en une poussée plus progressive des particules lorsqu'elles se rapprochent de l'origine de l'attracteur. Des valeurs nulles ou négatives causera une poussée très rapide des particules dès qu'elles touchent les bords de l'attracteur.

int cull_mask = 4294967295 🔗

  • void set_cull_mask(value: int)

  • int get_cull_mask()

Les couches de rendu des particules (VisualInstance3D.layers) qui seront affectées par l'attracteur. Par défaut, toutes les particules sont affectées par un attracteur.

Après avoir configuré les nœuds de particules en conséquence, des couches spécifiques peuvent être décochées pour empêcher que certaines particules ne soient affectées par des attracteurs. Par exemple, cela peut être utilisé si vous utilisez un attracteur dans le cadre d'un effet de sort, mais ne voulez pas que l'attracteur affecte les particules météorologiques sans rapport à la même position.

L'attraction des particules peut également être désactivée selon le matériau de traitement en définissant ParticleProcessMaterial.attractor_interaction_enabled sur le nœud GPUParticles3D.

float directionality = 0.0 🔗

  • void set_directionality(value: float)

  • float get_directionality()

Ajuste à quel point l'attracteur est directionnel. À 0.0, l'attracteur n'est pas directionnel du tout : il attirera les particules vers son centre. À 1.0, l'attracteur est entièrement directionnel : les particules seront toujours poussées vers le -Z local (ou +Z si strength est négative).

Note : Si directionality est supérieure à 0.0, la direction dans laquelle les particules sont poussées peut être modifiée en tournant le nœud GPUParticlesAttractor3D.

float strength = 1.0 🔗

  • void set_strength(value: float)

  • float get_strength()

Ajuste la force de l'attracteur. Si strength est négative, les particules seront poussées dans la direction opposée. Les particules seront poussées hors de l'origine de l'attracteur si directionality vaut 0.0, ou vers le +Z local si directionality est supérieure à 0.0.