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.
Propriété Documentation
ModelBlendEmitMode : enumeration |
Définit le mode d'émission des particules
| Constante | Description |
|---|---|
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 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 l'explosion et le 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 pour le site 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 des particules. Elle définit la taille, la position et la rotation où le modèle est construit lors de l'utilisation des modes de fusion ModelBlendParticle3D.Construct et ModelBlendParticle3D.Transfer.
endTime : int |
Cette propriété contient l'heure de fin de la particule en millisecondes. L'heure de fin est utilisée pendant la construction et définit la durée de vie de la particule jusqu'à 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 fusion de l'effet de particule.
© 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.