ModelBlendParticle3D QML 类型

将粒子效果与3D模型混合。更多...

导入语句	import QtQuick3D.Particles3D
继承	Particle3D

所有成员列表，包括继承的成员

属性

ModelBlendEmitMode : 枚举
ModelBlendMode : 枚举
activationNode : 节点
delegate : 组件
emitMode : 布尔
endNode : 节点
endTime : 整数
modelBlendMode : ModelBlendMode

详细描述

该类型提供了一种将粒子效果与3D模型混合的方法。提供的模型需要基于三角形。模型中的每个三角形都转换为粒子，然后由发射器使用。使用模型的材料而不是粒子着色器对模型进行着色。效果的混合方式由modelBlendMode确定。

可能的模式有

构造，其中模型从粒子中构造。
爆炸，其中模型转换为粒子。
转移，其中构造和爆炸结合以创建效果，模型从一个地方传输到另一个地方。

默认情况下，粒子按照模型中指定的顺序发射，除非将emitMode设置为Random或将emitMode设置为Activation并将activationNode设置。

此类中定义的一些基类和发射器的功能无法使用此类型

Particle3D::alignMode不适用，因为粒子可以在模型中具有任意方向。
Particle3D::sortMode不适用，因为粒子始终按照模型中指定的原语顺序渲染。
ParticleEmitter3D::depthBias不适用，因为使用模型深度偏移。

注意：默认的fadeInEffect和fadeOutEffect是Particle3D.FadeNone。

属性文档

ModelBlendEmitMode : 枚举

定义了粒子的发射模式。

常量	描述
`ModelBlendParticle3D.Sequential`	粒子按模型定义的顺序发射。
`ModelBlendParticle3D.Random`	粒子以随机顺序发射。
`ModelBlendParticle3D.Activation`	粒子在被激活节点激活时发射。

ModelBlendMode : 枚举

定义了粒子效果的分 blend 模式。

常量	描述
`ModelBlendParticle3D.Explode`	模型爆炸，即粒子从模型的位置发射。
`ModelBlendParticle3D.Construct`	模型构建，即粒子从发射器飞出，在末尾构建模型。
`ModelBlendParticle3D.Transfer`	将 Explode 和 Transfer 用于同一模型。

activationNode : 节点

此属性持有激活粒子的节点，并覆盖常规发射过程。激活节点可以用于控制当模型从粒子爆炸/构建时，粒子在空间中如何发射。如果粒子的中心位于激活节点的 z 轴正半部分，则激活节点会发射粒子。将激活节点沿模型移动动画会导致粒子沿激活节点移动路径依次发射。

delegate : 组件

代理提供了一个模板，用于定义 ModelBlendParticle3D 的模型。

例如，使用默认的球体模型和默认材质

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 : 布尔值

此属性持有粒子的发射模式。

endNode : 节点

此属性持有指定粒子效果末尾模型变换的节点。它定义了使用 ModelBlendParticle3D.Construct 和 ModelBlendParticle3D.Transfer 混合模式时构建模型的大小、位置和旋转。

endTime : 整型

此属性持有粒子末尾时间（毫秒）。末尾时间在构建期间使用，用于定义粒子的生命周期末尾的持续时间，其中效果与模型位置混合。在末尾时间之前，粒子位置仅由粒子效果定义，但在末尾时间，粒子位置将以线性方式与模型末尾位置混合。

modelBlendMode : ModelBlendMode

此属性持有粒子效果的混合模式。