En esta página

Emitter QML Type

Emite partículas lógicas. Más...

Import Statement: import QtQuick.Particles
Inherited By:

TrailEmitter

Propiedades

Señales

Métodos

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

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.