Emitter QML Type

Emet des particules logiques. Plus d'informations...

Import Statement: import QtQuick.Particles
Inherited By:

TrailEmitter

Propriétés

Signaux

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

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 propriété est définie sur false, l'émetteur cessera d'émettre des particules jusqu'à ce qu'elle soit définie sur true.

La valeur par défaut est true.


endSize : real

Taille en pixels des particules en fin de 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 émettra.

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, attribuez la valeur Emitter.InfiniteLife à lifeSpan.

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 d'autant dans les deux sens.

La valeur par défaut est 0.


maximumEmitted : int

Nombre maximum de particules vivantes à un moment donné pour cet émetteur.

Cette valeur peut être définie pour optimiser les performances (lors de l'utilisation des modes rafale et 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 sont é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

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 vers le haut ou vers le bas à partir de size/endSize. Le même ajout aléatoire est fait à 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 du système de particules. 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 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 du signal

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 à grand volume.

Remarque : le gestionnaire correspondant est onEmitParticles.


Documentation de la méthode

burst(int count)

Emet immédiatement un certain nombre de particules, spécifié par count, à partir de cet émetteur.


burst(int count, int x, int y)

Emet 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 sont identiques.


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.


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