Particle3D QML Type
Particule logique abstraite. Plus...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: | |
| Inherited By: | LineParticle3D, ModelBlendParticle3D, ModelParticle3D, and SpriteParticle3D |
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.
Documentation sur les propriétés
AlignMode : enumeration
Définit le type d'alignement.
| Constante | Description de l'alignement |
|---|---|
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 de l'effet |
|---|---|
Particle3D.FadeNone | Pas d'estompage. |
Particle3D.FadeOpacity | L'opacité des particules s'estompe de/à 0,0. |
Particle3D.FadeScale | L'échelle des particules s'estompe 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 par rapport à 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
Cette propriété définit la position sur laquelle les particules sont alignées. Cette propriété n'a d'effet que lorsque la propriété alignMode est définie sur Particle3D.AlignTowardsTarget.
Voir également alignMode.
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 également fadeOutEffect et fadeInDuration.
fadeOutEffect : FadeType
Cette propriété définit l'effet d'évanouissement 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 doit être mélangée à l'arrière-plan. En général, cette propriété doit être vraie, par exemple lorsque la couleur de la particule n'a pas une alpha complète, que la texture contient des pixels semi-transparents ou que l'opacité de la particule est atténuée ou supprimée. La valeur false peut être optimisée dans certains cas.
La valeur par défaut est true.
Voir aussi color, fadeInEffect, et fadeOutEffect.
maxAmount : int
Cette propriété définit la quantité maximale de particules qui peuvent exister en même temps. Vous pouvez utiliser particlesUsed pour vérifier l'efficacité de l'utilisation des particules allouées. Si la valeur maxAmount est trop faible, les particules sont réutilisées avant d'atteindre la fin de leur durée de vie ( lifeSpan). Si la valeur maxAmount est trop élevée, 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 à 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.
© 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.