SpriteParticle3D QML Type
Partícula que utiliza una textura de sprite en 2D. Más...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: | |
| Inherited By: |
Propiedades
- BlendMode : enumeration
- billboard : bool
- blendMode : BlendMode
- castsReflections : bool
(since 6.4) - colorTable : Texture
- lights : list<Light>
(since 6.3) - offsetX : real
(since 6.3) - offsetY : real
(since 6.3) - particleScale : real
- sprite : Texture
- spriteSequence : SpriteSequence3D
Descripción detallada
SpriteParticle3D es un elemento lógico de partículas que crea partículas a partir de una textura de sprite en 2D.
Documentación de propiedades
BlendMode : enumeration
Define el modo de fusión de las partículas.
| Constante | Descripción |
|---|---|
SpriteParticle3D.SourceOver | Mezcla las partículas con el modo «SourceOver». |
SpriteParticle3D.Screen | Mezcla las partículas con el modo «Screen». |
SpriteParticle3D.Multiply | Superpone las partículas con el modo «Multiplicar». |
billboard : bool
Esta propiedad define si la textura de la partícula debe estar siempre alineada con la cara hacia la pantalla.
Nota: Cuando se establece en « true », la propiedad « Particle3D » alignMode no tiene ningún efecto.
El valor por defecto es « false ».
blendMode : BlendMode
Esta propiedad define el modo de fusión utilizado para renderizar las partículas.
El valor por defecto es « SpriteParticle3D.SourceOver ».
castsReflections : bool [since 6.4]
Cuando esta propiedad se establece en « true », el sprite se renderiza mediante sondas de reflexión y puede verse en los reflejos.
Esta propiedad se introdujo en Qt 6.4.
colorTable : Texture
Esta propiedad define la imagen de color ( Texture ) que se utiliza para dar color a las partículas. La imagen puede ser una textura unidimensional (1D) o bidimensional (2D). Los píxeles horizontales determinan el color de la partícula a lo largo de su vida útil ( lifeSpan). Por ejemplo, cuando la partícula se encuentra a mitad de su vida útil, tendrá el color especificado en la mitad de la imagen. Si la imagen es bidimensional (2D), se selecciona aleatoriamente una fila vertical para cada partícula. Por ejemplo, una imagen c {256 x 4} contiene 4 opciones de coloración diferentes para las partículas.
lights : list<Light> [since 6.3]
Esta propiedad contiene una lista de objetos ` lights ` utilizados para renderizar las partículas.
Nota: Para obtener un rendimiento óptimo, define luces solo si son necesarias y mantén el número de luces al mínimo.
Esta propiedad se introdujo en Qt 6.3.
offsetX : real [since 6.3]
Esta propiedad define el desplazamiento de las partículas en el eje X
Esta propiedad se introdujo en Qt 6.3.
offsetY : real [since 6.3]
Esta propiedad define el desplazamiento de las partículas en el eje Y
Esta propiedad se introdujo en Qt 6.3.
particleScale : real
Esta propiedad define el multiplicador de escala de las partículas. Para ajustar el tamaño de las partículas en el emisor, utiliza las propiedades « ParticleEmitter3D », « particleScale », « particleEndScale » y « particleScaleVariation ».
El valor por defecto es 5.0.
sprite : Texture
Esta propiedad define la textura « Texture » que se utiliza para las partículas.
Por ejemplo, para utilizar «snowFlake.png» como textura de las partículas:
SpriteParticle3D {
id: snowParticle
...
sprite: Texture {
source: "images/snowflake.png"
}
}spriteSequence : SpriteSequence3D
Esta propiedad define las propiedades de la secuencia de sprites de la partícula. Si la textura « sprite » contiene una secuencia de fotogramas, configura esta propiedad para definir el número de fotogramas, la dirección de la animación y otras características.
© 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.