En esta página

ImageParticle QML Type

Para visualizar partículas lógicas mediante una imagen. Más...

Import Statement: import QtQuick.Particles
Inherits:

ParticlePainter

Propiedades

Descripción detallada

Este elemento representa una partícula lógica como una imagen. La imagen puede

  • coloreada
  • girarse
  • deformarse
  • una animación basada en sprites

Los ImageParticles comparten implícitamente datos sobre las partículas si varios ImageParticles están dibujando el mismo grupo de partículas lógicas. Esto se desglosa según las cuatro capacidades enumeradas anteriormente. Así pues, si un ImageParticle define datos para renderizar las partículas en una de esas capacidades y el otro no, ambos dibujarán las partículas de la misma forma en ese aspecto automáticamente. Esto resulta especialmente útil cuando existe alguna variación aleatoria en la partícula que se supone que debe mantenerse al cambiar de «pintor». Si ambas ImageParticles definen cómo deben aparecer en ese aspecto, sus representaciones divergen y cada una aparece tal y como está definida.

Este intercambio de datos se produce en segundo plano en función de si las propiedades se han establecido de forma implícita o explícita. Un inconveniente de la implementación actual es que solo es posible restablecer las capacidades en su conjunto. Así pues, si se establece explícitamente un atributo que afecta al color, como ` redVariation`, y luego se restablece (estableciendo ` redVariation ` en «indefinido»), todos los datos de color se restablecerán y comenzará a tener un valor implícito de cualquier color compartido con otras ImageParticles.

Nota: El número máximo de partículas de imagen está limitado a 16 383.

Documentación de propiedades

alpha : real

Un valor alfa que se aplicará a la imagen. Este valor se multiplica por el valor de la imagen y por el valor de la propiedad de color.

Las partículas tienen una mezcla aditiva, por lo que un valor de alfa más bajo en partículas individuales da lugar a efectos más intensos cuando se superponen varias partículas.

El alfa se mide en una escala de 0,0 a 1,0.

El valor por defecto es 1,0.

alphaVariation : real

La variación en el canal alfa entre partículas.

El alfa se mide en un rango de 0,0 a 1,0.

El valor por defecto es 0,0.

autoRotation : bool

Si se establece en «true», se aplicará una rotación adicional a la rotación de las partículas, de modo que queden orientadas en la dirección de desplazamiento. Por lo tanto, para que queden orientadas en dirección opuesta a la dirección de desplazamiento, establece «autoRotation» en «true» y «rotation» en 180.

El valor por defecto es «false».

blueVariation : real

La variación en el canal de color azul entre las partículas.

El color se mide, por canal, en una escala de 0,0 a 1,0.

El valor por defecto es 0,0.

color : color

Si se especifica un color, la imagen proporcionada se coloreará con ese color.

El valor por defecto es el blanco (sin cambios).

colorTable : url

Una imagen cuyo color se utilizará como textura unidimensional para determinar el color a lo largo de la vida útil. Por ejemplo, cuando la partícula se encuentre a la mitad de su vida útil, tendrá el color especificado en la mitad de la imagen.

Este color se combina con la propiedad de color y con el color de la imagen de origen.

colorVariation : real

Este número representa la variación de color aplicada a cada partícula. Establecer «colorVariation» equivale a establecer « redVariation », « greenVariation » y « blueVariation » en el mismo número.

Cada canal puede variar entre partículas hasta un valor igual a colorVariation respecto a su color habitual.

El color se mide, por canal, entre 0,0 y 1,0.

El valor por defecto es 0,0.

entryEffect : EntryEffect

Esta propiedad proporciona efectos básicos y sencillos de entrada y salida para las partículas. Para un control más detallado, consulta sizeTable y opacityTable.

Los valores aceptables son

ConstanteDescripción
ImageParticle.NoneLas partículas simplemente aparecen y desaparecen.
ImageParticle.FadeLas partículas aparecen gradualmente desde una opacidad de 0 al inicio de su vida útil y se desvanecen hasta 0 al final.
ImageParticle.ScaleLas partículas aumentan de tamaño partiendo de 0 al inicio de su vida y vuelven a 0 al final.

El valor por defecto es ImageParticle.Fade.

greenVariation : real

La variación en el canal de color verde entre las partículas.

El color se mide, por canal, en una escala de 0,0 a 1,0.

El valor por defecto es 0,0.

opacityTable : url

Una imagen cuya opacidad se utilizará como textura unidimensional para determinar el tamaño a lo largo de su ciclo de vida.

Se prevé que esta propiedad se elimine en breve, en favor de curvas de aceleración personalizadas para determinar la opacidad a lo largo de su ciclo de vida.

redVariation : real

La variación en el canal de color rojo entre las partículas.

El color se mide, por canal, entre 0,0 y 1,0.

El valor por defecto es 0,0.

rotation : real

Si se activa esta opción, la imagen se girará este número de grados antes de dibujarse.

Las coordenadas de las partículas no se transforman.

rotationVariation : real

Si se activa esta opción, la rotación de cada partícula variará hasta este valor entre una partícula y otra.

rotationVelocity : real

Si se establece, las partículas girarán a esta velocidad, expresada en grados por segundo.

rotationVelocityVariation : real

Si se activa esta opción, la « rotationVelocity » de cada partícula variará hasta este valor entre una partícula y otra.

sizeTable : url

Una imagen cuya opacidad se utilizará como textura unidimensional para determinar el tamaño a lo largo de su vida útil.

Se prevé que esta propiedad se elimine en breve, en favor de curvas de aceleración personalizadas para determinar el tamaño a lo largo de su vida útil.

source : url

La imagen de origen que se va a utilizar.

Si la imagen es una animación de sprites, utiliza en su lugar la propiedad «sprite».

Desde Qt 5.2, se proporcionan algunas imágenes predeterminadas como recursos para facilitar la creación de prototipos:

qrc:///particleresources/star.pngPartícula de estrella blanca
qrc:///particleresources/glowdot.pngPartícula en forma de punto blanco brillante
qrc:///particleresources/fuzzydot.pngPartícula blanca con un punto difuso

Ten en cuenta que las imágenes son blancas y semitransparentes, para permitir que la coloración y los niveles de alfa tengan el máximo efecto.

sprites : list<Sprite> [read-only]

El sprite o los sprites que se utilizan para dibujar esta partícula.

Ten en cuenta que la imagen del sprite se escalará a un cuadrado en función del tamaño de la partícula que se esté representando.

Para obtener más información, consulta la descripción general de las animaciones de sprites.

spritesInterpolate : bool

Si se establece en «true», las partículas de los sprites se interpolarán entre los fotogramas de los sprites en cada fotograma renderizado, lo que hará que los sprites se vean más fluidos.

El valor por defecto es «true».

status : Status [read-only]

El estado de la carga de la imagen.

xVector : StochasticDirection

Permite deformar la imagen de la partícula al dibujarla. La imagen rectangular se deformará de modo que los lados horizontales adopten la forma de este vector en lugar de (1,0).

yVector : StochasticDirection

Permite deformar la imagen de la partícula al dibujarla. La imagen rectangular se deformará de modo que los lados verticales adopten la forma de este vector en lugar de (0,1).

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