En esta página

SpriteParticle3D QML Type

Partícula utilizando una textura sprite 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 sprite 2D.

Documentación de propiedades

BlendMode : enumeration

Define el modo de mezcla de las partículas.

ConstanteDescripción
SpriteParticle3D.SourceOverMezcla partículas con el modo SourceOver.
SpriteParticle3D.ScreenMezcla partículas con el modo Pantalla.
SpriteParticle3D.MultiplyMezcla partículas con el modo Multiplicar.

billboard : bool

Esta propiedad define si la textura de la partícula debe estar siempre alineada cara a la pantalla.

Nota: Cuando se establece a true, Particle3D alignMode propiedad no tiene efecto.

El valor por defecto es false.

blendMode : BlendMode

Esta propiedad define el modo de mezcla 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 Texture utilizada para colorear las partículas. La imagen puede ser una textura 1D o 2D. Los píxeles horizontales determinan el color de la partícula a lo largo de su lifeSpan. Por ejemplo, cuando la partícula está a la mitad de su vida, tendrá el color especificado a la mitad de la imagen. Si la imagen es 2D, la fila vertical se selecciona aleatoriamente para cada partícula. Por ejemplo, una imagen c {256 x 4} contiene 4 diferentes opciones de coloración para las partículas.

lights : list<Light> [since 6.3]

Esta propiedad contiene una lista de lights utilizada para renderizar las partículas.

Nota: Para un rendimiento óptimo, defina las luces sólo si son necesarias y mantenga la cantidad 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, utilice las propiedades ParticleEmitter3D particleScale , particleEndScale, y particleScaleVariation.

El valor por defecto es 5.0.

sprite : Texture

Esta propiedad define el Texture utilizado para las partículas.

Por ejemplo, para usar "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 para la partícula. Si la textura sprite contiene una secuencia de fotogramas, establezca esta propiedad para definir las características de recuento de fotogramas, dirección de la animación, etc.

© 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.