ImageParticle QML Type

Permet de visualiser les particules logiques à l'aide d'une image. Plus d'informations...

Import Statement: import QtQuick.Particles
Inherits:

ParticlePainter

Propriétés

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.

Propriété Documentation

alpha : real

Valeur 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

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 la valeur est "true", une rotation sera appliquée en plus de la rotation de la particule, de manière à ce qu'elle soit orientée dans le sens de la marche. Ainsi, pour faire face à la direction du déplacement, réglez autoRotation sur true et rotation sur 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 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 colorVariation revient à définir redVariation, greenVariation, et blueVariation avec le même nombre.

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

ConstanteDescription
ImageParticle.NoneLes particules apparaissent et disparaissent simplement.
ImageParticle.FadeLes particules ont une opacité de 0 au début de leur vie et reviennent à 0 à la fin.
ImageParticle.ScaleLes 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

La 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 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 l'opacité en fonction de la durée de vie.


redVariation : real

La 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 l'option est activée, la rotation des particules individuelles variera d'autant entre les particules.


rotationVelocity : real

Si l'option est activée, les particules tourneront à cette vitesse en degrés/seconde.


rotationVelocityVariation : real

Si l'option est activée, l'adresse rotationVelocity des particules individuelles variera d'autant entre les particules.


sizeTable : 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 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 présentation des animations de sprites.


spritesInterpolate : bool

Si la valeur est "true", les particules de sprites interpolent entre les images de sprites à chaque image rendue, ce qui rend les sprites plus fluides.

La valeur par défaut est true.


status : Status [read-only]

L'état de 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 sorte que les côtés verticaux prennent la forme de ce vecteur au lieu de (0,1).


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