Emitter QML Type

Émet des particules logiques. En savoir plus…

• Liste de tous les membres, y compris les membres hérités

Propriétés

• acceleration : StochasticDirection
• emitRate : real
• enabled : bool
• endSize : real
• group : string
• lifeSpan : int
• lifeSpanVariation : int
• maximumEmitted : int
• shape : Shape
• size : real
• sizeVariation : real
• startTime : int
• system : ParticleSystem
• velocity : StochasticDirection
• velocityFromMovement : real

Signaux

• emitParticles(Array particles)

Méthodes

• void burst(int count)
• void burst(int count, int x, int y)
• void pulse(int duration)

Description détaillée

Cet élément émet des particules logiques dans l'ParticleSystem, avec les attributs de départ indiqués.

Notez que les particules logiques ne sont pas automatiquement affichées ; vous devrez disposer d’un ou plusieurs éléments « ParticlePainter » pour les visualiser.

Notez que les attributs de départ fournis peuvent être modifiés à tout moment au cours de la durée de vie de la particule par n'importe quel élément « Affector » présent dans le même « ParticleSystem ». Cela inclut des attributs tels que « lifespan ».

Documentation sur les propriétés

acceleration : StochasticDirection

L'accélération initiale des particules émises.

emitRate : real

Nombre de particules émises par seconde.

La valeur par défaut est de 10 particules par seconde.

enabled : bool

Si cette valeur est définie sur « false », l'émetteur cessera d'émettre jusqu'à ce qu'elle soit définie sur « true ».

La valeur par défaut est « true ».

endSize : real

Taille en pixels des particules à la fin de leur durée de vie. La taille sera interpolée de manière linéaire tout au long de la durée de vie de la particule, à partir de cette valeur et de la taille initiale. Si endSize est égal à -1, la taille de la particule restera constante et correspondra à la taille initiale.

La valeur par défaut est -1.

group : string

Il s'agit du groupe de particules logique dans lequel il émettra.

La valeur par défaut est « » (chaîne vide).

lifeSpan : int

Durée, en millisecondes, pendant laquelle chaque particule émise doit rester active.

Si vous ne souhaitez pas que les particules disparaissent automatiquement au bout d'un certain temps, par exemple si vous souhaitez les supprimer manuellement, définissez lifeSpan sur Emitter.InfiniteLife.

Les valeurs de lifeSpan supérieures ou égales à 600 000 (10 minutes) seront considérées comme infinies. Les particules dont la valeur de lifeSpan est inférieure ou égale à 0 seront déjà éteintes au démarrage.

La valeur par défaut est 1 000 (une seconde).

lifeSpanVariation : int

La durée de vie des particules peut varier jusqu'à cette valeur, dans un sens comme dans l'autre.

La valeur par défaut est 0.

maximumEmitted : int

Nombre maximal de particules actives simultanément pour cet émetteur.

Ce paramètre peut être défini à des fins d'optimisation des performances (lors de l'utilisation des modes « burst » et « pulse ») ou pour échelonner les émissions.

Si cette valeur est inférieure à zéro, il n’y a alors aucune limite maximale au nombre de particules que cet émetteur peut avoir actives.

La valeur par défaut est -1.

shape : Shape

Cette forme est appliquée en fonction de la taille de l'émetteur. Les particules seront émises de manière aléatoire depuis n'importe quelle zone couverte par la forme.

La forme par défaut est un rectangle rempli, qui correspond au cadre de délimitation complet de l'émetteur.

size : real

La taille en pixels des particules au début de leur cycle de vie.

La valeur par défaut est 16.

sizeVariation : real

La taille d'une particule peut varier de cette valeur vers le haut ou vers le bas par rapport à la valeur de « size »/«endSize ». Le même ajout aléatoire est appliqué à la fois à « size » et à « endSize » pour une même particule.

La valeur par défaut est 0.

startTime : int

Si cette valeur est définie lors du chargement de l'émetteur, celui-ci émettra des particules provenant du passé, remontant jusqu'à startTime millisecondes auparavant. Celles-ci seront simulées comme si elles avaient été émises à ce moment-là, mais aucun effecteur ne leur sera appliqué. Les effecteurs ne prendront effet qu'à partir du moment présent.

system : ParticleSystem

Il s'agit du système de particules dans lequel l'émetteur va émettre des particules. Ce paramètre peut être omis si l'émetteur est un enfant direct du ParticleSystem

velocity : StochasticDirection

La vitesse initiale des particules émises.

velocityFromMovement : real

Si cette valeur est différente de zéro, tout mouvement de l'émetteur conférera aux particules une vitesse initiale supplémentaire en fonction de ce mouvement. Le vecteur supplémentaire aura le même angle que le mouvement de l'émetteur, et son amplitude correspondra à l'amplitude du mouvement de l'émetteur multipliée par la valeur de `velocityFromMovement`.

La valeur par défaut est 0.

Documentation sur les signaux

emitParticles(Array particles)

Ce signal est déclenché lorsque des particules sont émises. ` particles ` est un tableau JavaScript contenant des objets `Particle`. Vous pouvez modifier les attributs des particules directement au sein du gestionnaire.

Documentation des méthodes

void burst(int count)

Émet immédiatement un nombre de particules, défini par ` count`, à partir de cet émetteur.

void burst(int count, int x, int y)

Émet immédiatement un nombre de particules, spécifié par ` count`, à partir de cet émetteur. Les particules sont émises comme si l'émetteur était positionné à (x, y), mais toutes les autres propriétés restent inchangées.

void pulse(int duration)

Si l'émetteur n'est pas activé, cette commande l'active pendant une durée spécifiée ( duration, en millisecondes), puis le désactive à nouveau.