ModelBlendParticle3D QML Type
Mélange l'effet de particules avec un modèle 3D. Plus d'informations...
| Import Statement: | import QtQuick3D.Particles3D |
| Inherits: |
Propriétés
- ModelBlendEmitMode : enumeration
- ModelBlendMode : enumeration
- activationNode : Node
- delegate : Component
- emitMode : bool
- endNode : Node
- endTime : int
- modelBlendMode : ModelBlendMode
Description détaillée
Ce type permet de mélanger des effets de particules avec un modèle 3D. Le modèle fourni doit être basé sur des triangles. Chaque triangle du modèle est converti en particule, qui est ensuite utilisée par l'émetteur. Au lieu d'un shader de particules, le modèle est ombré à l'aide du site material spécifié dans le modèle. La manière dont l'effet est mélangé est déterminée par la page modelBlendMode.
Les modes possibles sont les suivants :
- Construire, où le modèle est construit à partir des particules.
- Explosion, où le modèle est converti en particules.
- Transfert, où les modes Construction et Explosion sont combinés pour créer un effet où le modèle est transféré d'un endroit à un autre.
Par défaut, les particules sont émises dans l'ordre où elles sont spécifiées dans le modèle, à moins que emitMode ne soit remplacé par Random ou que emitMode ne soit remplacé par Activation et activationNode.
Certaines caractéristiques définies dans la classe de base et les émetteurs ne sont pas fonctionnelles avec ce type :
- Particle3D::alignMode n'est pas fonctionnel car les particules peuvent avoir une orientation arbitraire dans le modèle.
- Particle3D::sortMode n'est pas fonctionnel car les particules sont toujours rendues dans l'ordre dans lequel les primitives sont spécifiées dans le modèle.
- ParticleEmitter3D::depthBias n'est pas fonctionnel car le biais de profondeur du modèle est utilisé à la place.
Remarque : les valeurs par défaut fadeInEffect et fadeOutEffect sont Particle3D.FadeNone.
Documentation sur les propriétés
ModelBlendEmitMode : enumeration
Définit le mode d'émission des particules
| Constante | Description du mode d'émission |
|---|---|
ModelBlendParticle3D.Sequential | Les particules sont émises dans l'ordre défini dans le modèle. |
ModelBlendParticle3D.Random | Les particules sont émises dans un ordre aléatoire. |
ModelBlendParticle3D.Activation | Les particules sont émises lorsqu'elles sont activées par le site activationNode. |
ModelBlendMode : enumeration
Définit le mode de mélange pour l'effet de particule.
| Constante | Description |
|---|---|
ModelBlendParticle3D.Explode | Le modèle explose, c'est-à-dire que les particules sont émises à partir de la position du modèle. |
ModelBlendParticle3D.Construct | Le modèle est construit, c'est-à-dire que les particules volent depuis l'émetteur et construisent le modèle à la fin. |
ModelBlendParticle3D.Transfer | Combine Explosion et Transfert pour le même modèle. |
activationNode : Node
Cette propriété contient un nœud qui active les particules et remplace la routine d'émission requise. Le nœud d'activation peut être utilisé pour contrôler la manière dont les particules sont émises dans l'espace lorsque le modèle est éclaté/construit à partir des particules. Le nœud d'activation émet une particule si le centre de cette particule se trouve sur la moitié positive de l'axe z du nœud d'activation. L'animation du nœud d'activation pour qu'il se déplace dans le modèle entraînera l'émission séquentielle des particules le long de la trajectoire du nœud d'activation.
delegate : Component
Le délégué fournit un modèle définissant le modèle de ModelBlendParticle3D.
Par exemple, en utilisant le modèle de sphère par défaut avec le matériau par défaut
Component {
id: modelComponent
Model {
source: "#Sphere"
scale: Qt.vector3d(0.5, 0.5, 0.5)
materials: DefaultMaterial { diffuseColor: "red" }
}
}
ModelBlendParticle3D {
id: particleRedSphere
delegate: modelComponent
}emitMode : bool
Cette propriété contient le mode d'émission des particules.
endNode : Node
Cette propriété contient le nœud qui spécifie la transformation du modèle à la fin de l'effet de particule. Elle définit la taille, la position et la rotation du modèle lorsqu'on utilise les modes de fusion ModelBlendParticle3D.Construct et ModelBlendParticle3D.Transfer.
endTime : int
Cette propriété indique l'heure de fin de vie de la particule en millisecondes. L'heure de fin est utilisée lors de la construction et définit la durée entre la durée de vie de la particule et la fin où l'effet est fusionné avec les positions du modèle. Avant l'heure de fin, les positions des particules sont définies uniquement par l'effet de la particule, mais pendant l'heure de fin, la position de la particule est mélangée de manière linéaire avec la position de fin du modèle.
modelBlendMode : ModelBlendMode
Cette propriété définit le mode de mélange de l'effet de particule.
© 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.