ModelBlendParticle3D QML Type
Combina el efecto de partículas con un modelo 3D. Más...
| Import Statement: | import QtQuick3D.Particles3D |
| Inherits: |
Propiedades
- ModelBlendEmitMode : enumeration
- ModelBlendMode : enumeration
- activationNode : Node
- delegate : Component
- emitMode : bool
- endNode : Node
- endTime : int
- modelBlendMode : ModelBlendMode
Descripción detallada
Este tipo permite combinar un efecto de partículas con un modelo 3D. El modelo proporcionado debe estar basado en triángulos. Cada triángulo del modelo se convierte en una partícula, que luego es utilizada por el emisor. En lugar de un sombreador de partículas, el modelo se sombrea utilizando el sombreador de triángulos ( material ) especificado en el modelo. La forma en que se combina el efecto viene determinada por el modo de combinación ( modelBlendMode).
Los modos posibles son:
- Construct, en el que el modelo se construye a partir de las partículas.
- «Explode», en el que el modelo se convierte en partículas.
- Transfer, en el que se combinan «Construct» y «Explode» para crear un efecto en el que el modelo se transfiere de un lugar a otro.
Por defecto, las partículas se emiten en el orden en que se especifican en el modelo, a menos que « emitMode » esté establecido en « Random » o « emitMode » esté establecido en « Activation » y se haya activado « activationNode ».
Algunas características definidas en la clase base y en los emisores no funcionan con este tipo:
- Particle3D::alignMode no funciona, ya que las partículas pueden tener una orientación arbitraria en el modelo.
- Particle3D::sortMode no funciona, ya que las partículas siempre se representan en el orden en que se especifican las primitivas en el modelo.
- ParticleEmitter3D::depthBias no funciona, ya que se utiliza en su lugar el sesgo de profundidad del modelo.
Nota: Los valores predeterminados de « fadeInEffect » y « fadeOutEffect » son « Particle3D.FadeNone ».
Documentación de propiedades
ModelBlendEmitMode : enumeration
Define el modo de emisión de las partículas
| Constante | Descripción |
|---|---|
ModelBlendParticle3D.Sequential | Las partículas se emiten en el orden en que están definidas en el modelo. |
ModelBlendParticle3D.Random | Las partículas se emiten en orden aleatorio. |
ModelBlendParticle3D.Activation | Las partículas se emiten cuando son activadas por el « activationNode ». |
ModelBlendMode : enumeration
Define el modo de fusión del efecto de partículas.
| Constante | Descripción |
|---|---|
ModelBlendParticle3D.Explode | El modelo se desintegra, es decir, las partículas se emiten desde la posición del modelo. |
ModelBlendParticle3D.Construct | El modelo se construye, es decir, las partículas salen del emisor y forman el modelo al final. |
ModelBlendParticle3D.Transfer | Combina «Explosión» y «Transferencia» para el mismo modelo. |
activationNode : Node
Esta propiedad contiene un nodo que activa las partículas y anula la rutina de emisión habitual. El nodo de activación se puede utilizar para controlar cómo se emiten espacialmente las partículas cuando el modelo se desglosa o se construye a partir de ellas. El nodo de activación emite una partícula si el centro de dicha partícula se encuentra en la mitad positiva del eje z del nodo de activación. Si se anima el nodo de activación para que se desplace a través del modelo, las partículas se emitirán secuencialmente a lo largo de la trayectoria que recorre el nodo de activación.
delegate : Component
El delegado proporciona una plantilla que define el modelo para el ` ModelBlendParticle3D`.
Por ejemplo, utilizando el modelo de esfera predeterminado con el material predeterminado
Component {
id: modelComponent
Model {
source: "#Sphere"
scale: Qt.vector3d(0.5, 0.5, 0.5)
materials: DefaultMaterial { diffuseColor: "red" }
}
}
ModelBlendParticle3D {
id: particleRedSphere
delegate: modelComponent
}Nota: El modelo instanciado a partir del delegado conserva su propia asignación de « layers »; el valor de «layers» del « ParticleSystem3D » no se le aplica. Para renderizar la partícula en una capa de contenido específica, configura la propiedad «layers» en el delegado.
emitMode : bool
Esta propiedad determina el modo de emisión de las partículas.
endNode : Node
Esta propiedad contiene el nodo que especifica la transformación del modelo al final del efecto de partículas. Define el tamaño, la posición y la rotación con los que se construye el modelo cuando se utilizan los modos de fusión « ModelBlendParticle3D.Construct » y « ModelBlendParticle3D.Transfer ».
endTime : int
Esta propiedad contiene la hora de finalización de la partícula en milisegundos. La hora de finalización se utiliza durante la construcción y define la duración de la vida útil de la partícula a partir del momento en que el efecto se fusiona con las posiciones del modelo. Antes de la hora de finalización, las posiciones de las partículas vienen determinadas únicamente por el efecto de partículas, pero durante la hora de finalización, la posición de la partícula se fusiona linealmente con la posición final del modelo.
modelBlendMode : ModelBlendMode
Esta propiedad determina el modo de fusión del efecto de partículas.
© 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.