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 en ParticleSystem, con los atributos iniciales dados.
Ten en cuenta que las partículas lógicas no se renderizan automáticamente, necesitarás tener uno o más elementos ParticlePainter visualizándolas.
Ten en cuenta que los atributos iniciales dados pueden ser modificados en cualquier punto de la vida de la partícula por cualquier elemento Afector en el mismo ParticleSystem. Esto incluye atributos como lifespan.
Documentación de propiedades
acceleration : StochasticDirection
El acelerón inicial de las partículas emitidas.
emitRate : real
Número de partículas emitidas por segundo.
El valor por defecto es 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. El tamaño se interpolará linealmente durante la vida de la partícula a partir de este valor y el tamaño. Si endSize es -1, entonces el tamaño de la partícula permanecerá constante en el tamaño inicial.
El valor por defecto es -1.
group : string
Es el grupo lógico de partículas en el 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 desea que las partículas mueran automáticamente después de un tiempo, por ejemplo si desea deshacerse de ellas manualmente, establezca lifeSpan a Emitter.InfiniteLife.
Los lifeSpans mayores o iguales a 600000 (10 minutos) serán tratados como infinitos. Las partículas con lifeSpans menores o iguales a 0 comenzarán muertas.
El valor por defecto es 1000 (un segundo).
lifeSpanVariation : int
El tiempo de vida de las partículas variará hasta este valor en cualquier dirección.
El valor por defecto es 0.
maximumEmitted : int
El número máximo de partículas a la vez que este emisor tendrá vivas.
Esto se puede establecer como una optimización del rendimiento (cuando se utiliza ráfaga y pulso) o para escalonar las emisiones.
Si se establece en un número por debajo de cero, entonces no hay límite máximo en el número de partículas que este emisor puede tener vivas.
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 área cubierta por la forma.
La forma por defecto es un rectángulo relleno, que corresponde a la caja delimitadora completa 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 tanto hacia arriba como hacia abajo con respecto al tamaño/endSize. La misma adición aleatoria se hace tanto al tamaño como a endSize para una sola partícula.
El valor por defecto es 0.
startTime : int
Si se establece este valor cuando se carga el emisor, entonces emitirá partículas del pasado, hasta startTime milisegundos atrás. Éstas se simularán como si hubieran sido emitidas en ese momento, pero no se les aplicará ningún efecto. Los afectores tendrán efecto a partir del tiempo presente.
system : ParticleSystem
Es el sistema de partículas en el que emitirá el Emisor. Puede omitirse si el Emisor es hijo directo del sistema de partículas 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 basada en el movimiento. El vector adicional tendrá el mismo ángulo que el movimiento del emisor, con una magnitud que es la magnitud del movimiento del emisor multiplicada por velocityFromMovement.
El valor por defecto es 0.
Documentación de señales
emitParticles(Array particles)
Esta señal se emite cuando se emiten partículas. particles es una matriz JavaScript de objetos Partícula. Puedes modificar los atributos de las partículas directamente dentro del manejador.
Nota: JavaScript es más lento de ejecutar, por lo que no se recomienda su uso en sistemas de partículas de gran volumen.
Nota: El manejador correspondiente es onEmitParticles.
Documentación del método
void burst(int count)
Emite un número de partículas, especificado por count, desde este emisor inmediatamente.
void burst(int count, int x, int y)
Emite un número de partículas, especificado por count, desde este emisor inmediatamente. Las partículas se emiten como si el Emisor estuviera posicionado 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 especificado en duration (en milisegundos) y luego lo desactiva.
© 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.
