En esta página

ModelBlendParticle3D QML Type

Mezcla el efecto de partículas con un modelo 3D. Más...

Import Statement: import QtQuick3D.Particles3D
Inherits:

Particle3D

Propiedades

Descripción detallada

El tipo proporciona una manera de mezclar el 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 es utilizada por el emisor. En lugar del sombreador de partículas, el modelo se sombrea utilizando la dirección material especificada en el modelo. El modo en que se mezcla el efecto viene determinado por modelBlendMode.

Los modos posibles son:

  • Construir, donde el modelo se construye a partir de las partículas.
  • Explotar, donde el modelo se convierte en partículas.
  • Transferir, en el que se combinan Construir y Explotar 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 se establezca en Random o emitMode se establezca en Activation y activationNode se establezca.

Algunas características definidas en la clase base y los emisores no son funcionales con este tipo:

  • Particle3D::alignMode no es funcional ya que las partículas pueden tener una orientación arbitraria en el modelo.
  • Particle3D::sortMode no es funcional ya que las partículas siempre se renderizan en el orden en que las primitivas se especifican en el modelo.
  • ParticleEmitter3D::depthBias no es funcional ya que en su lugar se utiliza el sesgo de profundidad del modelo.

Nota: Los valores por defecto fadeInEffect y fadeOutEffect son Particle3D.FadeNone.

Documentación de propiedades

ModelBlendEmitMode : enumeration

Define el modo de emisión de las partículas

ConstanteDescripción
ModelBlendParticle3D.SequentialLas partículas se emiten en el orden en que están definidas en el modelo.
ModelBlendParticle3D.RandomLas partículas se emiten en orden aleatorio.
ModelBlendParticle3D.ActivationLas partículas se emiten cuando son activadas por activationNode.

ModelBlendMode : enumeration

Define el modo de fusión para el efecto de partículas.

ConstanteDescripción
ModelBlendParticle3D.ExplodeEl modelo explota, es decir, las partículas se emiten desde la posición del modelo.
ModelBlendParticle3D.ConstructEl modelo se construye, es decir, las partículas vuelan desde el emisor y construyen el modelo al final.
ModelBlendParticle3D.TransferCombina 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 requerida. El nodo de activación se puede utilizar para controlar cómo se emiten espacialmente las partículas cuando el modelo se explota/construye a partir de las partículas. El nodo de activación emite una partícula si el centro de esa partícula está en la mitad positiva del eje z del nodo de activación. Si se anima el nodo de activación para que se mueva a través del modelo, las partículas se emitirán secuencialmente a lo largo del recorrido del nodo de activación.

delegate : Component

El delegado proporciona una plantilla que define el modelo para ModelBlendParticle3D.

Por ejemplo, utilizando el modelo de esfera por defecto con material por defecto

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

Esta propiedad contiene el modo de emisión de las partículas.

endNode : Node

Esta propiedad contiene el nodo que especifica la transformación para el modelo al final del efecto de partículas. Define el tamaño, la posición y la rotación donde se construye el modelo cuando se utilizan los modos de fusión ModelBlendParticle3D.Construct y ModelBlendParticle3D.Transfer.

endTime : int

Esta propiedad contiene el tiempo final de la partícula en milisegundos. El tiempo final se utiliza durante la construcción y define la duración de la vida de la partícula al final donde el efecto se mezcla con las posiciones del modelo. Antes del tiempo final las posiciones de las partículas están definidas sólo por el efecto de la partícula, pero durante el tiempo final la posición de la partícula se mezcla linealmente con la posición final del modelo.

modelBlendMode : ModelBlendMode

Esta propiedad contiene el modo de mezcla para el 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.