Emitter QML Type
Emet des particules logiques. Plus d'informations...
| Import Statement: | import QtQuick.Particles |
| Inherited By: |
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
Description détaillée
Cet élément émet des particules logiques dans le site ParticleSystem, avec les attributs de départ donnés.
Notez que les particules logiques ne sont pas rendues automatiquement, vous aurez besoin d'un ou plusieurs éléments ParticlePainter pour les visualiser.
Les attributs de départ donnés peuvent être modifiés à tout moment de la vie de la particule par tout élément Affector dans le même ParticleSystem. Cela inclut des attributs tels que la durée de vie.
Documentation sur les propriétés
acceleration : StochasticDirection
L'accélération de départ 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 fixée à false, l'émetteur cessera d'émettre jusqu'à ce qu'elle soit fixée à true.
La valeur par défaut est true.
endSize : real
La taille en pixels des particules à la fin de leur vie. La taille sera interpolée linéairement pendant la durée de vie de la particule à partir de cette valeur et de la taille. Si endSize vaut -1, la taille de la particule restera constante à la taille de départ.
La valeur par défaut est -1.
group : string
Il s'agit du groupe logique de particules dans lequel la particule sera émise.
La valeur par défaut est "" (chaîne vide).
lifeSpan : int
Durée en millisecondes de chaque particule émise.
Si vous ne souhaitez pas que les particules meurent automatiquement au bout d'un certain temps, par exemple si vous souhaitez vous en débarrasser manuellement, définissez lifeSpan à Emitter.InfiniteLife.
Les durées de vie supérieures ou égales à 600000 (10 minutes) seront considérées comme infinies. Les particules dont la durée de vie est inférieure ou égale à 0 commenceront par mourir.
La valeur par défaut est 1000 (une seconde).
lifeSpanVariation : int
La durée de vie des particules peut varier de cette valeur dans les deux sens.
La valeur par défaut est 0.
maximumEmitted : int
Le nombre maximum de particules en vie à un moment donné pour cet émetteur.
Cette valeur peut être définie pour optimiser les performances (lors de l'utilisation de l'éclatement et de l'impulsion) ou pour échelonner les émissions.
Si cette valeur est inférieure à zéro, il n'y a pas de limite maximale au nombre de particules que l'émetteur peut avoir en vie.
La valeur par défaut est -1.
shape : Shape
Cette forme est appliquée avec la taille de l'émetteur. Les particules seront émises de manière aléatoire à partir de toute zone couverte par la forme.
La forme par défaut est un rectangle rempli, qui correspond à la boîte de délimitation complète de l'émetteur.
size : real
La taille en pixels des particules au début de leur vie.
La valeur par défaut est 16.
sizeVariation : real
La taille d'une particule peut varier d'autant en plus ou en moins par rapport à la taille/endSize. La même addition aléatoire est faite à la fois à la taille et à endSize pour une seule 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 du passé, jusqu'à l'heure de début (startTime), il y a quelques millisecondes. Ces particules seront simulées comme si elles avaient été émises à ce moment-là, mais aucun affect ne leur sera appliqué. Les affectations prendront effet à partir du moment présent.
system : ParticleSystem
Il s'agit du système de particules dans lequel l'émetteur émettra. Ce paramètre peut être omis si l'émetteur est un enfant direct de l'élément ParticleSystem
velocity : StochasticDirection
La vitesse de départ des particules émises.
velocityFromMovement : real
Si cette valeur est différente de zéro, tout mouvement de l'émetteur fournira une vitesse de départ supplémentaire aux particules en fonction du mouvement. Le vecteur supplémentaire aura le même angle que le mouvement de l'émetteur, avec une magnitude qui est la magnitude du mouvement de l'émetteur multipliée par velocityFromMovement.
La valeur par défaut est 0.
Documentation sur les signaux
emitParticles(Array particles)
Ce signal est émis lorsque des particules sont émises. particles est un tableau JavaScript d'objets particules. Vous pouvez modifier les attributs des particules directement dans le gestionnaire.
Remarque : l'exécution de JavaScript étant plus lente, il n'est pas recommandé d'utiliser ce signal dans les systèmes de particules à haut volume.
Remarque : le gestionnaire correspondant est onEmitParticles.
Documentation de la méthode
void burst(int count)
Emet immédiatement un certain nombre de particules, spécifié par count, à partir de cet émetteur.
void burst(int count, int x, int y)
Emet immédiatement un certain 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 sont identiques.
void pulse(int duration)
Si l'émetteur n'est pas activé, il l'active pendant une durée spécifiée duration (en millisecondes), puis le désactive.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
