Sur cette page

Particle3D QML Type

Particule logique abstraite. Plus...

Import Statement: import QtQuick3D.Particles3D
Since: Qt 6.2
Inherits:

Object3D

Inherited By:

LineParticle3D, ModelBlendParticle3D, ModelParticle3D, and SpriteParticle3D

Propriétés

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.

ConstanteDescription de l'alignement
Particle3D.AlignNonePas d'alignement. La rotation des particules peut être définie à l'aide de particleRotation.
Particle3D.AlignTowardsTargetAligne les particules vers la direction alignTargetPosition.
Particle3D.AlignTowardsStartVelocityAligne les particules vers leur direction de départ velocity.

FadeType : enumeration

Définit le type d'effet d'évanouissement.

ConstanteDescription de l'effet
Particle3D.FadeNonePas d'estompage.
Particle3D.FadeOpacityL'opacité des particules s'estompe de/à 0,0.
Particle3D.FadeScaleL'é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.

ConstanteDescription
Particle3D.SortNonePas de tri.
Particle3D.SortNewestTri basé sur la durée de vie de la particule, la plus récente en premier.
Particle3D.SortOldestTri basé sur la durée de vie des particules, les plus anciennes en premier.
Particle3D.SortDistanceTri 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.