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.

GPUParticlesAttractor3D

Eredita: VisualInstance3D < Node3D < Node < Object

Ereditato da: GPUParticlesAttractorBox3D, GPUParticlesAttractorSphere3D, GPUParticlesAttractorVectorField3D

Classe base astratta per gli attrattori di particelle 3D.

Descrizione

Gli attrattori di particelle possono essere usati per attrarre particelle verso l'origine dell'attrattore o per allontanarle dall'origine dell'attrattore.

Gli attrattori di particelle funzionano in tempo reale e possono essere spostati, ruotati e ridimensionati durante il gioco. A differenza delle forme di collisione, è supportato anche il ridimensionamento non uniforme degli attrattori.

Gli attrattori possono essere temporaneamente disattivati nascondendoli o impostando la loro strength su 0.0.

Nota: Gli attrattori di particelle influenzano solo i GPUParticles3D, non i CPUParticles3D.

Proprietà

float

attenuation

1.0

int

cull_mask

4294967295

float

directionality

0.0

float

strength

1.0


Descrizioni delle proprietà

float attenuation = 1.0 🔗

  • void set_attenuation(value: float)

  • float get_attenuation()

L'attenuazione dell'attrattore di particelle. Valori più alti risultano in una spinta più graduale delle particelle man mano che si avvicinano all'origine dell'attrattore. Valori pari a zero o negativi faranno sì che le particelle siano spinte molto velocemente non appena toccano i bordi dell'attrattore.


int cull_mask = 4294967295 🔗

  • void set_cull_mask(value: int)

  • int get_cull_mask()

Gli strati di rendering delle particelle (VisualInstance3D.layers) che saranno influenzati dall'attrattore. Come predefinito, tutte le particelle sono influenzate da un attrattore.

Dopo aver configurato i nodi delle particelle adeguatamente, è possibile deselezionare strati specifici per impedire che determinate particelle siano influenzate dagli attrattori. Ad esempio, potrebbe essere utile per un attrattore che fa parte di un effetto magico ma è preferibile che non influenzi altre particelle del meteo nella sua stessa posizione.

È possibile disabilitare l'attrazione delle particelle per ogni materiale di processo impostando ParticleProcessMaterial.attractor_interaction_enabled sul nodo GPUParticles3D.


float directionality = 0.0 🔗

  • void set_directionality(value: float)

  • float get_directionality()

Regola la direzionalità dell'attrattore. A 0.0, l'attrattore non è affatto direzionale: attrarrà le particelle verso il suo centro. A 1.0, l'attrattore è totalmente direzionale: le particelle saranno sempre spinte verso -Z locale (o +Z se strength è negativo).

Nota: Se directionality è maggiore di 0.0, la direzione in cui sono spinte le particelle può essere modificata ruotando il nodo GPUParticlesAttractor3D.


float strength = 1.0 🔗

  • void set_strength(value: float)

  • float get_strength()

Regola la forza dell'attrattore. Se strength è negativo, le particelle saranno spinte nella direzione opposta. Le particelle saranno spinte via dall'origine dell'attrattore se directionality è 0.0, o verso +Z locale se directionality è maggiore di 0.0.