Particle3D QML Type
Particule logique abstraite. Plus...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: | |
| Inherited By: |
Propriétés
- AlignMode : enumeration
- FadeType : enumeration
- SortMode : enumeration
- alignMode : AlignMode
- alignTargetPosition : vector3d
- color : color
- colorVariation : vector4d
- fadeInDuration : int
- fadeInEffect : FadeType
- fadeOutDuration : int
- fadeOutEffect : FadeType
- hasTransparency : bool
- maxAmount : int
- sortMode : SortMode
- unifiedColorVariation : bool
Description détaillée
Cet élément définit les propriétés communes des particules logiques. Particle3D est une classe de base abstraite de particules, utilisez plutôt ModelParticle3D ou SpriteParticle3D.
Remarque : contrairement aux matériaux utilisés avec les modèles, les particules sont rendues par défaut en supposant une semi-transparence, et donc en activant l'estompage. C'est le comportement souhaité la plupart du temps en raison des textures des particules, des variations de couleur (alpha), des fondus, etc. Si vous n'avez pas besoin de l'estompage, réglez hasTransparency sur false pour améliorer les performances.
Propriété Documentation
AlignMode : enumeration |
Définit le type d'alignement.
| Constante | Description |
|---|---|
Particle3D.AlignNone | Pas d'alignement. La rotation des particules peut être définie à l'aide de particleRotation. |
Particle3D.AlignTowardsTarget | Aligne les particules vers la direction alignTargetPosition. |
Particle3D.AlignTowardsStartVelocity | Aligne les particules vers leur direction de départ velocity. |
FadeType : enumeration |
Définit le type d'effet d'évanouissement.
| Constante | Description |
|---|---|
Particle3D.FadeNone | Pas d'estompage. |
Particle3D.FadeOpacity | L'opacité des particules s'estompe de/à 0,0. |
Particle3D.FadeScale | Fondu de l'échelle de la particule de/à 0,0. |
SortMode : enumeration |
Définit le mode de tri des particules. Le mode de tri détermine l'ordre dans lequel les particules sont dessinées.
| Constante | Description |
|---|---|
Particle3D.SortNone | Pas de tri. |
Particle3D.SortNewest | Tri basé sur la durée de vie de la particule, la plus récente en premier. |
Particle3D.SortOldest | Tri basé sur la durée de vie des particules, les plus anciennes en premier. |
Particle3D.SortDistance | Tri basé sur la distance à la caméra, la plus éloignée en premier. |
alignMode : AlignMode |
Cette propriété définit le mode d'alignement utilisé pour les particules. L'alignement des particules correspond à la direction dans laquelle les particules sont orientées.
Remarque : lorsque la propriété SpriteParticle3D billboard est définie sur true, alignMode n'a pas d'effet.
La valeur par défaut est Particle3D.AlignNone.
Voir également alignTargetPosition.
alignTargetPosition : vector3d |
color : color |
Cette propriété définit la couleur de base utilisée pour coloriser les particules.
La valeur par défaut est "#FFFFFF" (blanc).
colorVariation : vector4d |
Cette propriété définit la variation de couleur utilisée pour colorer les particules. Les valeurs sont classées par ordre RGBA et chaque valeur doit être comprise entre 0,0 (aucune variation) et 1,0 (variation totale).
Par exemple, pour créer des particules qui auront des couleurs rouges translucides entre #ff0000 et #e50000, avec une opacité de 40 % à 60 % :
ModelParticle3D {
...
color: "#7fff0000"
colorVariation: Qt.vector4d(0.1, 0.0, 0.0, 0.2)
}La valeur par défaut est (0, 0, 0, 0) (aucune variation).
Voir aussi unifiedColorVariation.
fadeInDuration : int |
Cette propriété définit la durée en millisecondes de l'effet de fondu.
Remarque : les durées de fondu font partie des particules lifeSpan. Ainsi, si lifeSpan vaut 3000, fadeInDuration vaut 500 et fadeOutDuration vaut 500, la durée de visibilité totale de la particule est de 2000 ms.
La valeur par défaut est 250.
Voir également fadeInEffect et fadeOutDuration.
fadeInEffect : FadeType |
Cette propriété définit l'effet d'évanouissement utilisé lors de l'apparition des particules.
La valeur par défaut est Particle3D.FadeOpacity.
Voir aussi fadeInDuration et fadeOutEffect.
fadeOutDuration : int |
Cette propriété définit la durée en millisecondes de l'effet de fondu.
La valeur par défaut est 250.
Voir aussi fadeOutEffect et fadeInDuration.
fadeOutEffect : FadeType |
Cette propriété définit l'effet de fondu utilisé lorsque les particules atteignent leur lifeSpan et disparaissent.
La valeur par défaut est Particle3D.FadeOpacity.
Voir aussi fadeOutDuration et fadeInEffect.
hasTransparency : bool |
Cette propriété définit si la particule est transparente et si elle doit se fondre dans l'arrière-plan. En règle générale, cette propriété doit être définie comme vraie, par exemple lorsque la couleur de la particule n'est pas totalement alpha, que la texture contient des pixels semi-transparents ou que l'opacité de la particule est réduite ou supprimée. La valeur false peut être optimisée dans certains cas.
La valeur par défaut est true.
Voir également color, fadeInEffect, et fadeOutEffect.
maxAmount : int |
Cette propriété définit la quantité maximale de particules pouvant exister simultanément. Vous pouvez utiliser particlesUsed pour vérifier l'efficacité de l'utilisation des particules allouées. Si maxAmount est trop petit, les particules sont réutilisées avant d'atteindre la fin de leur durée de vie lifeSpan. Si maxAmount est trop grand, de la mémoire inutile est allouée aux particules.
Remarque : la modification de maxAmount réinitialise toutes les particules du système de particules.
La valeur par défaut est 100.
sortMode : SortMode |
Cette propriété définit le mode de tri utilisé pour les particules.
La valeur par défaut est Particle3D.SortNone.
unifiedColorVariation : bool |
Cette propriété définit si le site colorVariation doit être appliqué uniformément pour tous les canaux de couleur. Cela signifie que toutes les variations sont appliquées avec la même quantité aléatoire.
Par exemple, pour créer des particules qui auront des couleurs jaunes entre #ffff00 et #7f7f00, de sorte que les valeurs des canaux de couleur R et G soient toujours les mêmes :
ModelParticle3D {
...
color: "#ffff00"
colorVariation: Qt.vector4d(0.5, 0.5, 0.0, 0.0)
unifiedColorVariation: true
}La valeur par défaut est false.
Voir aussi colorVariation.
© 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.