ImageParticle QML Type
Para visualizar partículas lógicas mediante una imagen. Más...
| Import Statement: | import QtQuick.Particles |
| Inherits: |
Propiedades
- alpha : real
- alphaVariation : real
- autoRotation : bool
- blueVariation : real
- color : color
- colorTable : url
- colorVariation : real
- entryEffect : EntryEffect
- greenVariation : real
- opacityTable : url
- redVariation : real
- rotation : real
- rotationVariation : real
- rotationVelocity : real
- rotationVelocityVariation : real
- sizeTable : url
- source : url
- sprites : list<Sprite>
- spritesInterpolate : bool
- status : Status
- xVector : StochasticDirection
- yVector : StochasticDirection
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
| Constante | Descripción |
|---|---|
ImageParticle.None | Las partículas simplemente aparecen y desaparecen. |
ImageParticle.Fade | Las partículas aparecen gradualmente desde una opacidad de 0 al inicio de su vida útil y se desvanecen hasta 0 al final. |
ImageParticle.Scale | Las 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.png | ![]() |
| qrc:///particleresources/glowdot.png | ![]() |
| qrc:///particleresources/fuzzydot.png | ![]() |
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.


