En esta página

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:

Particle3D

Inherited By:

LineParticle3D

Propiedades

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.

ConstanteDescripción
SpriteParticle3D.SourceOverMezcla las partículas con el modo «SourceOver».
SpriteParticle3D.ScreenMezcla las partículas con el modo «Screen».
SpriteParticle3D.MultiplySuperpone 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.