ParticleEmitter3D QML Type
Emisor de partículas lógicas. Más...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: | |
| Inherited By: |
Propiedades
- EmitMode : enumeration
(since 6.10) - depthBias : real
- emitBursts : List<EmitBurst3D>
- emitMode : EmitMode
(since 6.10) - emitRate : real
- enabled : bool
- lifeSpan : int
- lifeSpanVariation : int
- particle : Particle3D
- particleEndScale : real
- particleEndScaleVariation : real
- particleRotation : vector3d
- particleRotationVariation : vector3d
- particleRotationVelocity : vector3d
- particleRotationVelocityVariation : vector3d
- particleScale : real
- particleScaleVariation : real
- reversed : bool
(since 6.10) - shape : ParticleAbstractShape3D
- system : ParticleSystem3D
- velocity : Direction3D
Métodos
- vector3d burst(int count)
- vector3d burst(int count, int duration)
- vector3d burst(int count, int duration, vector3d position)
Descripción detallada
Este elemento emite partículas lógicas al ParticleSystem3D, con los atributos iniciales especificados.
Se requiere al menos un emisor para que haya partículas en el ParticleSystem3D. Existen varias formas de controlar la cantidad emitida:
- Establecer el valor de « emitRate », que controla cuántas partículas por segundo se emiten de forma continua.
- Añade elementos « EmitBurst3D » a la propiedad « emitBursts » para emitir ráfagas de forma declarativa.
- Llama a cualquiera de los métodos de « burst()» para emitir ráfagas de forma inmediata.
Documentación de la propiedad
EmitMode : enumeration [since 6.10]
Define el modo de emisión del emisor con forma.
| Constante | Descripción |
|---|---|
ParticleEmitter3D.Default | Comportamiento de emisión predeterminado. |
ParticleEmitter3D.SurfaceNormal | Las partículas se emiten a lo largo de la normal de la superficie. Requiere una forma de partícula. Si el emisor es un emisor de estela, la normal de la superficie se hereda de la partícula seguida. |
ParticleEmitter3D.SurfaceReflected | Las partículas se emiten a lo largo de la reflexión del vector de velocidad y la normal a la superficie. Si el emisor es un emisor de estela, la normal a la superficie y la velocidad se heredan de la partícula seguida. Requiere una forma de partícula. |
Esta propiedad se introdujo en Qt 6.10.
depthBias : real
Almacena el sesgo de profundidad del emisor. El sesgo de profundidad se suma a la distancia del objeto respecto a la cámara a la hora de ordenar los objetos. Esto puede utilizarse para forzar el orden de renderizado entre objetos cercanos entre sí, que, de otro modo, podrían renderizarse en un orden diferente en distintos fotogramas. Los valores negativos hacen que el objeto se acerque más a la cámara, mientras que los valores positivos lo alejan de ella.
emitBursts : List<EmitBurst3D>
Esta propiedad toma una lista de elementos de tipo « EmitBurst3D » para definir ráfagas de forma declarativa. Si se conocen de antemano la hora de inicio, la cantidad y la duración de la ráfaga, es mejor utilizar esta propiedad que, por ejemplo, llamar a ` burst()` con un ` Timer`.
Por ejemplo, para emitir 100 partículas al principio y 50 partículas a los 2 segundos:
ParticleEmitter3D {
emitBursts: [
EmitBurst3D {
time: 0
amount: 100
},
EmitBurst3D {
time: 2000
amount: 50
}
]
}Véase también burst().
emitMode : EmitMode [default: ParticleEmitter3D.Default, since 6.10]
Esta propiedad define el modo de emisión del emisor con forma.
Esta propiedad se introdujo en Qt 6.10.
emitRate : real
Esta propiedad define la tasa constante de emisión en partículas por segundo. Por ejemplo, si la tasa de emisión (emitRate) es 120 y el sistema se anima a 60 fotogramas por segundo, se emiten 2 partículas nuevas en cada fotograma.
El valor por defecto es 0.
enabled : bool
Si la opción «Enabled» se establece en « false », este emisor no emitirá ninguna partícula. Normalmente, esto se utiliza para activar o desactivar un emisor de forma condicional. Si deseas que siga emitiendo ráfagas, mantén « emitRate » en 0 en lugar de cambiarlo a « false ».
El valor por defecto es « true ».
lifeSpan : int
Esta propiedad define la vida útil de una partícula individual en milisegundos.
El valor por defecto es 1000.
Véase también lifeSpanVariation.
lifeSpanVariation : int
Esta propiedad define la variación de la vida media de una sola partícula en milisegundos.
Por ejemplo, para emitir partículas que perduren entre 3 y 4 segundos:
ParticleEmitter3D {
...
lifeSpan: 3500
lifeSpanVariation: 500
}El valor por defecto es 0.
Véase también « lifeSpan ».
particle : Particle3D
Esta propiedad define la partícula lógica que emite este emisor. El emisor debe tener una partícula definida; de lo contrario, no emitirá nada. La partícula puede ser de tipo « SpriteParticle3D » o « ModelParticle3D ».
particleEndScale : real
Esta propiedad define el multiplicador de escala de las partículas al final de la partícula lifeSpan. Para que haya variación en los tamaños finales de las partículas, utiliza particleEndScaleVariation. Cuando el valor es negativo, la escala final es la misma que la particleScale, por lo que la escala no cambia durante la partícula lifeSpan.
El valor por defecto es -1.0.
Véase también particleScale y particleScaleVariation.
particleEndScaleVariation : real
Esta propiedad define la variación de escala de las partículas al final. Cuando el valor es negativo, se utiliza « particleScaleVariation » también para la escala final. Por ejemplo, para emitir partículas que empiecen con una escala de 0,5 - 1,5 y terminen con una escala de 1,0 - 5,0:
ParticleEmitter3D {
...
particleScale: 1.0
particleScaleVariation: 0.5
particleEndScale: 3.0
particleEndScaleVariation: 2.0
}El valor por defecto es « -1.0 ».
Véase también « particleEndScale ».
particleRotation : vector3d
Esta propiedad define la rotación inicial de las partículas. La rotación se expresa en grados en ángulos de Euler.
Véase también particleRotationVariation.
particleRotationVariation : vector3d
Esta propiedad define la variación de la rotación de las partículas al inicio. La variación de la rotación se define en grados, expresada en ángulos de Euler.
Por ejemplo, para emitir partículas con rotaciones totalmente aleatorias:
ParticleEmitter3D {
...
particleRotationVariation: Qt.vector3d(180, 180, 180)
}Véase también particleRotation.
particleRotationVelocity : vector3d
Esta propiedad define la velocidad de rotación de las partículas al inicio. La velocidad de rotación se expresa en grados por segundo en ángulos de Euler.
Véase también particleRotationVelocityVariation.
particleRotationVelocityVariation : vector3d
Esta propiedad define la variación de la velocidad de rotación de las partículas. La variación de la velocidad de rotación se expresa en grados por segundo en ángulos de Euler.
Por ejemplo, para emitir partículas con rotaciones aleatorias y una velocidad de rotación aleatoria comprendida entre -100 y 100 grados por segundo en cualquier dirección:
ParticleEmitter3D {
...
particleRotationVariation: Qt.vector3d(180, 180, 180)
particleRotationVelocityVariation: Qt.vector3d(100, 100, 100)
}Véase también particleRotationVelocity.
particleScale : real
Esta propiedad define el multiplicador de escala de las partículas al inicio. Para que haya variación en el tamaño de las partículas, utiliza particleScaleVariation.
El valor por defecto es 1.0.
Véase también « particleEndScale » y « particleScaleVariation ».
particleScaleVariation : real
Esta propiedad define la variación de escala de las partículas. Por ejemplo, para emitir partículas con una escala de entre 0,5 y 1,5:
ParticleEmitter3D {
...
particleScale: 1.0
particleScaleVariation: 0.5
}El valor por defecto es 0.0.
Véase también particleScale y particleEndScaleVariation.
reversed : bool [default: false, since 6.10]
Esta propiedad invierte el tiempo de las partículas; es decir, las partículas emitidas se ejecutan desde la hora final hasta la hora inicial.
Esta propiedad se introdujo en Qt 6.10.
shape : ParticleAbstractShape3D
Esta propiedad define la forma opcional del área de emisión. Puede ser « ParticleShape3D » o « ParticleModelShape3D ». La forma se escala, se coloca y se gira en función de las propiedades del nodo emisor. Cuando la propiedad «Shape fill » se establece en «false», la emisión se produce únicamente desde la superficie de la forma.
Cuando no se define la forma, la emisión se realiza desde el punto central del nodo emisor.
system : ParticleSystem3D
Esta propiedad define el « ParticleSystem3D » del emisor. Si «system» es el padre directo del emisor, no es necesario definir esta propiedad.
velocity : Direction3D
Esta propiedad se puede utilizar para establecer una velocidad inicial para las partículas emitidas. Si no se establece ninguna velocidad, las partículas comienzan inmóviles y la velocidad se obtiene de affectors si se utilizan.
Documentación del método
vector3d burst(int count)
Este método emite de forma inmediata una cantid count e de partículas desde este emisor.
vector3d burst(int count, int duration)
Este método emite una cantid count e de partículas desde este emisor durante los próximos duration milisegundos.
vector3d burst(int count, int duration, vector3d position)
Este método emite una cantidad de partículas count desde este emisor durante los próximos duration milisegundos. Las partículas se emiten como si el emisor se encontrara en position, pero el resto de propiedades son las mismas.
© 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.