ImageParticle QML Type
Para visualizar partículas lógicas utilizando 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
- rotar
- deformarse
- una animación basada en sprites
Las ImageParticles comparten implícitamente datos sobre las partículas si varias ImageParticles están pintando el mismo grupo lógico de partículas. Esto se desglosa a lo largo de las cuatro capacidades enumeradas anteriormente. Así, si una ImageParticle define los datos para renderizar las partículas en una de esas capacidades, y la otra no, entonces ambas dibujarán las partículas igual en ese aspecto automáticamente. Esto es útil principalmente cuando hay alguna variación aleatoria en la partícula que se supone que debe permanecer con ella al cambiar de pintor. Si ambas ImageParticles definen cómo deben aparecer para ese aspecto, divergen y cada una aparece como está definida.
Este intercambio de datos se produce entre bastidores en función de si las propiedades se establecieron implícita o explícitamente. Un inconveniente de la implementación actual es que sólo es posible restablecer las capacidades en su conjunto. Por lo tanto, si establece explícitamente un atributo que afecta al color, como redVariation, y luego lo restablece (estableciendo redVariation a indefinido), todos los datos de color se restablecerán y comenzará a tener un valor implícito de cualquier color compartido de otras ImageParticles.
Nota: El número máximo de partículas de imagen está limitado a 16383.
Documentación de propiedades
alpha : real
Un alfa a aplicar a la imagen. Este valor se multiplica por el valor de la imagen y el valor de la propiedad de color.
Las partículas tienen mezcla aditiva, por lo que un alfa más bajo en partículas individuales conduce a efectos más fuertes cuando se superponen múltiples partículas.
Alfa se mide de 0.0 a 1.0.
Por defecto es 1.0
alphaVariation : real
La variación del canal alfa entre partículas.
Alfa se mide de 0.0 a 1.0.
Por defecto es 0.0
autoRotation : bool
Si se establece en true, entonces se aplicará una rotación sobre la rotación de las partículas, de modo que se enfrenta a la dirección de desplazamiento. Por lo tanto, para mirar en dirección contraria a la de desplazamiento, establece autoRotation a true y rotation a 180.
Por defecto es false
blueVariation : real
La variación en el canal de color azul entre partículas.
El color se mide, por canal, de 0.0 a 1.0.
Por defecto es 0.0
color : color
Si se especifica un color, la imagen proporcionada se coloreará con él.
Por defecto es blanco (sin cambios).
colorTable : url
Una imagen cuyo color se utilizará como textura 1D para determinar el color a lo largo de la vida. Por ejemplo, cuando la partícula se encuentre a mitad de su vida útil, tendrá el color especificado a mitad de la imagen.
Este color se mezcla con la propiedad de color y el color de la imagen de origen.
colorVariation : real
Este número representa la variación de color aplicada a partículas individuales. Establecer colorVariation es lo mismo que establecer redVariation, greenVariation, y blueVariation al mismo número.
Cada canal puede variar entre partículas hasta colorVariation de su color habitual.
El color se mide, por canal, de 0,0 a 1,0.
Por defecto es 0.0
entryEffect : EntryEffect
Esta propiedad proporciona efectos de entrada y salida básicos y baratos para las partículas. Para un control más preciso, consulte sizeTable y opacityTable.
Los valores aceptables son
| Constante | Descripción |
|---|---|
ImageParticle.None | Las partículas sólo aparecen y desaparecen. |
ImageParticle.Fade | Las partículas se desvanecen a partir de 0 de opacidad al principio de su vida, y se desvanecen a 0 al final. |
ImageParticle.Scale | Las partículas aumentan de tamaño desde 0 al principio 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 partículas.
El color se mide, por canal, de 0.0 a 1.0.
Por defecto es 0.0
opacityTable : url
Una imagen cuya opacidad se utilizará como textura 1D para determinar el tamaño sobre la vida.
Se espera que esta propiedad se elimine en breve, en favor de curvas de flexión personalizadas para determinar la opacidad a lo largo de la vida.
redVariation : real
La variación en el canal de color rojo entre partículas.
El color se mide, por canal, de 0.0 a 1.0.
Por defecto es 0.0
rotation : real
Si se establece, la imagen girará esta cantidad de grados antes de ser dibujada.
Las coordenadas de las partículas no se transforman.
rotationVariation : real
Si se establece, la rotación de las partículas individuales variará hasta esta cantidad entre partículas.
rotationVelocity : real
Si se establece, las partículas rotarán a esta velocidad en grados/segundo.
rotationVelocityVariation : real
Si se ajusta, la dirección rotationVelocity de las partículas individuales variará hasta esta cantidad entre partículas.
sizeTable : url
Una imagen cuya opacidad se utilizará como textura 1D para determinar el tamaño sobre la vida.
Se espera que esta propiedad se elimine en breve, en favor de curvas de flexión personalizadas para determinar el tamaño a lo largo de la vida.
source : url
La imagen fuente a utilizar.
Si la imagen es una animación sprite, utilice la propiedad sprite en su lugar.
Desde Qt 5.2, algunas imágenes predeterminadas se proporcionan como recursos para ayudar a la creación de prototipos:
| qrc:///particleresources/star.png |  |
| qrc:///particleresources/glowdot.png |  |
| qrc:///particleresources/punto borroso.png |  |
Ten en cuenta que las imágenes son blancas y semitransparentes, para permitir que la coloración y los niveles alfa tengan el máximo efecto.
sprites : list<Sprite> [read-only]
El sprite o sprites utilizados para dibujar esta partícula.
Ten en cuenta que la imagen del sprite se escalará a un cuadrado basado en el tamaño de la partícula que se está renderizando.
Para más detalles, consulta la descripción general de las animaciones de sprites.
spritesInterpolate : bool
Si se establece a true, las partículas de sprites interpolarán entre los fotogramas de sprites cada fotograma renderizado, haciendo que los sprites se vean más suaves.
Por defecto es true.
status : Status [read-only]
Estado de la carga de la imagen.
xVector : StochasticDirection
Permite deformar la imagen de la partícula cuando se dibuja. La imagen rectangular se deformará para que los lados horizontales tengan la forma de este vector en lugar de (1,0).
yVector : StochasticDirection
Permite deformar la imagen de la partícula cuando se dibuja. La imagen rectangular se deformará para que los lados verticales tengan 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.
