ImageParticle QML Type
Pour visualiser des particules logiques à l'aide d'une image. En savoir plus...
| Import Statement: | import QtQuick.Particles |
| Inherits: |
Propriétés
- 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
Description détaillée
Cet élément affiche une particule logique sous forme d'image. L'image peut être
- colorée
- , pivotée
- déformée
- une animation basée sur des sprites
Les ImageParticles partagent implicitement les données relatives aux particules lorsque plusieurs d’entre elles dessinent le même groupe de particules logiques. Ce partage s’effectue selon les quatre capacités énumérées ci-dessus. Ainsi, si une ImageParticle définit des données pour le rendu des particules selon l’une de ces capacités, et que l’autre ne le fait pas, les deux dessineront automatiquement les particules de la même manière sur cet aspect. Cela s’avère particulièrement utile lorsqu’il existe une variation aléatoire sur la particule qui est censée lui rester associée lors du changement de « peintre ». Si les deux ImageParticles définissent comment elles doivent apparaître pour cet aspect, elles divergent et chacune s’affiche telle qu’elle a été définie.
Ce partage de données s'effectue en arrière-plan, selon que les propriétés ont été définies de manière implicite ou explicite. L’un des inconvénients de l’implémentation actuelle est qu’il n’est possible de réinitialiser les capacités que dans leur ensemble. Ainsi, si vous définissez explicitement un attribut affectant la couleur, tel que ` redVariation`, puis que vous le réinitialisez (en définissant ` redVariation ` sur « indéfini »), toutes les données de couleur seront réinitialisées et la particule prendra implicitement la valeur de n’importe quelle couleur partagée par d’autres ImageParticles.
Remarque : le nombre maximal de particules d’image est limité à 16 383.
Documentation des propriétés
alpha : real
Une valeur alpha à appliquer à l'image. Cette valeur est multipliée par la valeur de l'image et par celle de la propriété « couleur ».
Les particules sont soumises à un mélange additif ; ainsi, un alpha plus faible sur une particule isolée entraîne des effets plus marqués lorsque plusieurs particules se superposent.
La valeur alpha est comprise entre 0,0 et 1,0.
La valeur par défaut est 1,0.
alphaVariation : real
La variation de la valeur du canal alpha entre les particules.
La valeur alpha est comprise entre 0,0 et 1,0.
La valeur par défaut est 0,0.
autoRotation : bool
Si cette option est définie sur « true », une rotation sera appliquée en plus de la rotation des particules, afin qu'elles soient orientées dans le sens de la progression. Ainsi, pour qu'elles soient tournées dans la direction opposée à celle de la progression, définissez « autoRotation » sur « true » et « rotation » sur 180.
La valeur par défaut est « false ».
blueVariation : real
La variation du canal de couleur bleu entre les particules.
La couleur est mesurée, par canal, sur une échelle allant de 0,0 à 1,0.
La valeur par défaut est 0,0.
color : color
Si une couleur est spécifiée, l'image fournie sera colorisée avec celle-ci.
La valeur par défaut est le blanc (aucune modification).
colorTable : url
Une image dont la couleur sera utilisée comme texture unidimensionnelle pour déterminer la couleur au cours de la durée de vie de la particule. Par exemple, lorsque la particule aura parcouru la moitié de sa durée de vie, elle aura la couleur spécifiée à mi-chemin sur l'image.
Cette couleur est mélangée à la propriété de couleur et à la couleur de l'image source.
colorVariation : real
Ce nombre correspond à la variation de couleur appliquée à chaque particule. Définir « colorVariation » revient à attribuer la même valeur aux paramètres « redVariation », « greenVariation » et « blueVariation ».
Chaque canal peut varier d'une particule à l'autre jusqu'à colorVariation par rapport à sa couleur habituelle.
La couleur est mesurée, par canal, sur une échelle allant de 0,0 à 1,0.
La valeur par défaut est 0,0.
entryEffect : EntryEffect
Cette propriété permet d’appliquer des effets d’entrée et de sortie simples et peu coûteux aux particules. Pour un contrôle plus précis, consultez sizeTable et opacityTable.
Les valeurs acceptables sont les suivantes :
| Constante | Description |
|---|---|
ImageParticle.None | Les particules apparaissent et disparaissent simplement. |
ImageParticle.Fade | Les particules apparaissent progressivement à partir d’une opacité de 0 au début de leur durée de vie, puis s’estompent jusqu’à 0 à la fin. |
ImageParticle.Scale | Les particules s’agrandissent progressivement à partir d’une taille de 0 au début de leur durée de vie, puis rétrécissent jusqu’à 0 à la fin. |
La valeur par défaut est ImageParticle.Fade.
greenVariation : real
La variation du canal de couleur vert entre les particules.
La couleur est mesurée, par canal, sur une échelle allant de 0,0 à 1,0.
La valeur par défaut est 0,0.
opacityTable : url
Une image dont l'opacité sera utilisée comme texture unidimensionnelle pour déterminer la taille au fil du temps.
Cette propriété devrait être supprimée prochainement, au profit de courbes d'accélération personnalisées permettant de déterminer l'opacité au fil du temps.
redVariation : real
La variation du canal de couleur rouge entre les particules.
La couleur est mesurée, par canal, sur une échelle allant de 0,0 à 1,0.
La valeur par défaut est 0,0.
rotation : real
Si cette option est activée, l'image sera pivotée de ce nombre de degrés avant d'être affichée.
Les coordonnées des particules ne sont pas transformées.
rotationVariation : real
Si cette option est activée, la rotation de chaque particule pourra varier d'une valeur maximale équivalente à celle-ci d'une particule à l'autre.
rotationVelocity : real
Si cette valeur est définie, les particules tourneront à cette vitesse, exprimée en degrés par seconde.
rotationVelocityVariation : real
Si cette option est activée, l'rotationVelocity s de chaque particule variera d'au plus cette valeur d'une particule à l'autre.
sizeTable : url
Une image dont l'opacité sera utilisée comme texture unidimensionnelle pour déterminer la taille au fil du temps.
Cette propriété devrait être supprimée prochainement, au profit de courbes d'accélération personnalisées permettant de déterminer la taille au fil du temps.
source : url
L'image source à utiliser.
Si l'image est une animation de sprite, utilisez plutôt la propriété sprite.
Depuis Qt 5.2, certaines images par défaut sont fournies en tant que ressources pour faciliter le prototypage :
| qrc:///particleresources/star.png |  |
| qrc:///particleresources/glowdot.png |  |
| qrc:///particleresources/fuzzydot.png |  |
Notez que ces images sont blanches et semi-transparentes, afin de permettre une colorisation et des niveaux d'opacité optimaux.
sprites : list<Sprite> [read-only]
Le ou les sprites utilisés pour dessiner cette particule.
Notez que l'image du sprite sera redimensionnée en carré en fonction de la taille de la particule en cours de rendu.
Pour plus de détails, consultez la présentation des animations de sprites.
spritesInterpolate : bool
Si cette option est définie sur « true », les particules de sprite s'interpoleront entre les images du sprite à chaque image rendue, ce qui rendra les sprites plus fluides.
La valeur par défaut est « true ».
status : Status [read-only]
État du chargement de l'image.
xVector : StochasticDirection
Permet de déformer l'image de la particule lors de son affichage. L'image rectangulaire sera déformée de manière à ce que ses côtés horizontaux épousent la forme de ce vecteur au lieu de celle de (1,0).
yVector : StochasticDirection
Permet de déformer l'image de la particule lors de son affichage. L'image rectangulaire sera déformée de manière à ce que ses côtés verticaux épousent la forme de ce vecteur au lieu de celle 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.
