Emitter QML Type
Emite partículas lógicas. Más...
| Import Statement: | import QtQuick.Particles |
| Inherited By: |
Propiedades
- 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
Señales
- emitParticles(Array particles)
Métodos
Descripción detallada
Este elemento emite partículas lógicas al ParticleSystem, con los atributos iniciales especificados.
Ten en cuenta que las partículas lógicas no se visualizan automáticamente; necesitarás uno o más elementos « ParticlePainter » para visualizarlas.
Ten en cuenta que los atributos iniciales especificados pueden modificarse en cualquier momento durante la vida útil de la partícula mediante cualquier elemento «Affector» del mismo « ParticleSystem ». Esto incluye atributos como «lifespan».
Documentación de propiedades
acceleration : StochasticDirection
La aceleración inicial de las partículas emitidas.
emitRate : real
Número de partículas emitidas por segundo.
El valor por defecto es de 10 partículas por segundo.
enabled : bool
Si se establece en «false», el emisor dejará de emitir hasta que se establezca en «true».
El valor por defecto es «true».
endSize : real
El tamaño en píxeles de las partículas al final de su vida útil. El tamaño se interpolará linealmente durante la vida útil de la partícula a partir de este valor y del tamaño inicial. Si endSize es -1, el tamaño de la partícula se mantendrá constante en el tamaño inicial.
El valor por defecto es -1.
group : string
Este es el grupo de partículas lógico al que se emitirá.
El valor por defecto es «» (cadena vacía).
lifeSpan : int
El tiempo, en milisegundos, que debe durar cada partícula emitida.
Si no quieres que las partículas desaparezcan automáticamente tras un tiempo determinado, por ejemplo, si deseas eliminarlas manualmente, establece lifeSpan en Emitter.InfiniteLife.
Los valores de lifeSpan mayores o iguales a 600 000 (10 minutos) se considerarán infinitos. Las partículas con un lifeSpan menor o igual a 0 aparecerán muertas desde el principio.
El valor por defecto es 1000 (un segundo).
lifeSpanVariation : int
La vida media de las partículas puede variar hasta este valor en cualquier dirección.
El valor por defecto es 0.
maximumEmitted : int
El número máximo de partículas que este emisor tendrá activas al mismo tiempo.
Esto se puede configurar para optimizar el rendimiento (cuando se utilizan los modos «burst» y «pulse») o para escalonar las emisiones.
Si se establece un valor inferior a cero, no habrá límite máximo en el número de partículas que este emisor puede tener activas.
El valor por defecto es -1.
shape : Shape
Esta forma se aplica con el tamaño del emisor. Las partículas se emitirán aleatoriamente desde cualquier zona cubierta por la forma.
La forma predeterminada es un rectángulo relleno, que se corresponde con el rectángulo delimitador completo del emisor.
size : real
El tamaño en píxeles de las partículas al inicio de su vida.
El valor por defecto es 16.
sizeVariation : real
El tamaño de una partícula puede variar en esta cantidad, hacia arriba o hacia abajo, con respecto a size/endSize. Se aplica la misma adición aleatoria tanto a size como a endSize para una sola partícula.
El valor por defecto es 0.
startTime : int
Si se establece este valor al cargar el emisor, este emitirá partículas del pasado, hasta un máximo de startTime milisegundos atrás. Estas se simularán como si se hubieran emitido en ese momento, pero no se les aplicarán efectos. Los efectos surtirán efecto a partir del momento actual.
system : ParticleSystem
Este es el sistema de partículas al que el emisor emitirá. Se puede omitir si el emisor es un elemento secundario directo del ParticleSystem
velocity : StochasticDirection
La velocidad inicial de las partículas emitidas.
velocityFromMovement : real
Si este valor es distinto de cero, cualquier movimiento del emisor proporcionará una velocidad inicial adicional a las partículas en función de dicho movimiento. El vector adicional tendrá el mismo ángulo que el movimiento del emisor, y su magnitud será igual a la magnitud del movimiento del emisor multiplicada por «velocityFromMovement».
El valor por defecto es 0.
Documentación de Signal
emitParticles(Array particles)
Esta señal se emite cuando se lanzan partículas. ` particles ` es una matriz de JavaScript compuesta por objetos `Particle`. Puedes modificar los atributos de las partículas directamente desde el controlador.
Nota: La ejecución deJavaScript es más lenta, por lo que no se recomienda utilizar esta opción en sistemas de partículas de gran volumen.
Nota: El controlador correspondiente es onEmitParticles.
Documentación del método
void burst(int count)
Emite inmediatamente una serie de partículas, cuyo número viene especificado por ` count`, desde este emisor.
void burst(int count, int x, int y)
Emite inmediatamente una serie de partículas, especificadas por count, desde este emisor. Las partículas se emiten como si el emisor estuviera situado en (x, y), pero el resto de propiedades son las mismas.
void pulse(int duration)
Si el emisor no está activado, lo activa durante un tiempo de activación ( duration ) especificado (en milisegundos) y, a continuación, lo vuelve a desactivar.
© 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.