ImageParticle QML Type
Permet de visualiser les particules logiques à l'aide d'une image. Plus d'informations...
| 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 rend une particule logique sous forme d'image. L'image peut être
- colorisée
- tournée
- déformée
- une animation basée sur un sprite
Les ImageParticles partagent implicitement des données sur les particules si plusieurs ImageParticles peignent le même groupe logique de particules. Ces données sont réparties en fonction des quatre capacités énumérées ci-dessus. Ainsi, si une ImageParticle définit des données pour le rendu des particules dans 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 dans cet aspect. Ceci est principalement utile lorsqu'il y a une variation aléatoire sur la particule qui est supposée rester avec elle lorsque l'on change de peintre. Si les deux ImageParticles définissent la manière dont elles doivent apparaître pour cet aspect, elles divergent et chacune apparaît telle qu'elle a été définie.
Ce partage des données s'effectue en coulisses, selon que les propriétés ont été définies implicitement ou explicitement. L'un des inconvénients de l'implémentation actuelle est qu'il n'est possible de réinitialiser que les capacités dans leur ensemble. Ainsi, si vous définissez explicitement un attribut affectant la couleur, tel que redVariation, et que vous le réinitialisez ensuite (en définissant redVariation sur undefined), toutes les données relatives à la couleur seront réinitialisées et la particule commencera à avoir une valeur implicite de toute couleur partagée avec d'autres ImageParticles.
Remarque : le nombre maximal de particules d'image est limité à 16383.
Documentation sur les propriétés
alpha : real
Un alpha à appliquer à l'image. Cette valeur est multipliée par la valeur de l'image et la valeur de la propriété de couleur.
Les particules ont un mélange additif, de sorte qu'un alpha plus faible sur une seule particule entraîne des effets plus importants lorsque plusieurs particules se chevauchent.
L'alpha est mesuré de 0,0 à 1,0.
La valeur par défaut est 1,0.
alphaVariation : real
La variation du canal alpha entre les particules.
L'alpha est mesuré de 0,0 à 1,0.
La valeur par défaut est 0.0
autoRotation : bool
Si elle est définie sur true, une rotation sera appliquée en plus de la rotation des particules, de manière à ce qu'elles soient orientées dans le sens de la marche. Ainsi, pour que la particule soit orientée dans la direction opposée au sens de la marche, il faut définir autoRotation à true et rotation à 180.
La valeur par défaut est false
blueVariation : real
Variation du canal de couleur bleue entre les particules.
La couleur est mesurée, par canal, 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 cette couleur.
La valeur par défaut est le blanc (pas de changement).
colorTable : url
Une image dont la couleur sera utilisée comme texture 1D pour déterminer la couleur au cours de la vie. Par exemple, lorsque la particule est à la moitié de sa durée de vie, elle aura la couleur spécifiée à la moitié de l'image.
Cette couleur est mélangée à la propriété de couleur et à la couleur de l'image source.
colorVariation : real
Ce nombre représente la variation de couleur appliquée aux particules individuelles. Définir la variation de couleur revient à donner le même nombre à redVariation, greenVariation et blueVariation.
Chaque canal peut faire varier la couleur d'une particule jusqu'à colorVariation par rapport à sa couleur habituelle.
La couleur est mesurée, par canal, de 0,0 à 1,0.
La valeur par défaut est 0.0
entryEffect : EntryEffect
Cette propriété fournit des effets d'entrée et de sortie basiques et bon marché pour les particules. Pour un contrôle plus fin, voir sizeTable et opacityTable.
Les valeurs acceptables sont
| Constante | Description |
|---|---|
ImageParticle.None | Les particules apparaissent et disparaissent simplement. |
ImageParticle.Fade | Les particules ont une opacité de 0 au début de leur vie et reviennent à 0 à la fin. |
ImageParticle.Scale | Les particules passent d'une taille de 0 au début de leur vie à une taille de 0 à la fin. |
La valeur par défaut est ImageParticle.Fade.
greenVariation : real
Variation du canal de couleur verte entre les particules.
La couleur est mesurée, par canal, 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 1D pour déterminer la taille en fonction de la durée de vie.
Cette propriété devrait être supprimée prochainement, au profit de courbes d'assouplissement personnalisées pour déterminer l'opacité en fonction de la durée de vie.
redVariation : real
Variation du canal de couleur rouge entre les particules.
La couleur est mesurée, par canal, de 0,0 à 1,0.
La valeur par défaut est 0,0
rotation : real
Si cette option est activée, l'image sera tournée de ce nombre de degrés avant d'être dessinée.
Les coordonnées des particules ne sont pas transformées.
rotationVariation : real
Si cette option est activée, la rotation des particules individuelles variera jusqu'à cette valeur entre les particules.
rotationVelocity : real
Si cette option est activée, les particules tourneront à cette vitesse en degrés/seconde.
rotationVelocityVariation : real
Si elle est réglée, l'adresse rotationVelocity des particules individuelles variera jusqu'à cette valeur entre les particules.
sizeTable : url
Une image dont l'opacité sera utilisée comme texture 1D pour déterminer la taille sur la durée de vie.
Cette propriété devrait être supprimée prochainement, au profit de courbes d'assouplissement personnalisées pour déterminer la taille en fonction de la durée de vie.
source : url
L'image source à utiliser.
Si l'image est une animation sprite, utilisez la propriété sprite à la place.
Depuis Qt 5.2, certaines images par défaut sont fournies comme ressources pour faciliter le prototypage :
| qrc:///particleresources/star.png |  |
| qrc:///particleresources/glowdot.png |  |
| qrc:///particleresources/fuzzydot.png |  |
Notez que les images sont blanches et semi-transparentes, afin de permettre à la colorisation et aux niveaux alpha d'avoir un effet maximal.
sprites : list<Sprite> [read-only]
Le ou les sprites utilisés pour dessiner cette particule.
Notez que l'image du sprite sera mise à l'échelle d'un carré en fonction de la taille de la particule en cours de rendu.
Pour plus de détails, voir la vue d'ensemble des animations de sprites.
spritesInterpolate : bool
Si cette valeur est fixée à true, les particules de sprites interpolent entre les images de sprites à chaque image rendue, ce qui donne un aspect plus lisse aux sprites.
La valeur par défaut est true.
status : Status [read-only]
L'état du chargement de l'image.
xVector : StochasticDirection
Permet de déformer l'image de la particule lorsqu'elle est dessinée. L'image rectangulaire sera déformée de manière à ce que les côtés horizontaux aient la forme de ce vecteur au lieu de (1,0).
yVector : StochasticDirection
Permet de déformer l'image de la particule lorsqu'elle est dessinée. L'image rectangulaire sera déformée de manière à ce que les côtés verticaux aient la forme de ce vecteur au lieu 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.
