ModelBlendParticle3D QML Type

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

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

属性

• ModelBlendEmitMode : enumeration
• ModelBlendMode : enumeration
• activationNode : Node
• delegate : Component
• emitMode : bool
• endNode : Node
• endTime : int
• modelBlendMode : ModelBlendMode

详细说明

该类型提供了一种将粒子效果与3D模型混合的方法。所提供的模型必须基于三角形。模型中的每个三角形都会被转换为一个粒子，这些粒子随后会被发射器使用。与使用粒子着色器不同，该模型的着色是通过模型中指定的material 实现的。效果的混合方式由modelBlendMode 决定。

可选模式包括：

• “构建”（Construct）：模型由粒子构建而成。
• “爆炸”（Explode）：模型被转换为粒子。
• “转移”（Transfer）：将“构建”和“爆炸”模式结合，生成模型从一处转移到另一处的效果。

默认情况下，粒子将按其在模型中指定的顺序发射，除非将emitMode 设置为Random ，或者将emitMode 设置为Activation 且activationNode 已启用。

基类和发射器中定义的某些功能在此类型下无法正常工作：

• Particle3D::alignMode 无法正常工作，因为粒子在模型中可能处于任意方向。
• Particle3D::sortMode 无法正常工作，因为粒子始终按照模型中基元指定的顺序进行渲染。
• ParticleEmitter3D::depthBias 无法正常工作，因为此时使用的是模型的深度偏移量。

属性文档

ModelBlendEmitMode : enumeration

定义粒子的发射模式

ModelBlendMode : enumeration

定义粒子特效的混合模式。

activationNode : Node

该属性包含一个用于激活粒子并覆盖常规发射例程的节点。当模型从粒子中爆炸/构建时，激活节点可用于控制粒子在空间中的发射方式。如果粒子的中心位于激活节点z轴的正半轴上，则激活节点会发射该粒子。 若对激活节点进行动画处理使其穿过模型，粒子将沿激活节点移动的路径依次发射。

delegate : Component

该委托提供了一个模板，用于定义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 : bool

该属性用于指定粒子的发射模式。

endNode : Node

该属性保存了一个节点，用于指定粒子特效结束时模型的变换。它定义了在使用“ModelBlendParticle3D.Construct ”和“ModelBlendParticle3D.Transfer ”混合模式时，模型构建时的大小、位置和旋转。

endTime : int

该属性存储粒子的结束时间（单位为毫秒）。结束时间在构建过程中使用，用于定义粒子生命周期结束时的持续时间，此时特效将与模型位置进行混合。在结束时间之前，粒子的位置仅由粒子特效决定；但在结束时间期间，粒子的位置将与模型的结束位置进行线性混合。

modelBlendMode : ModelBlendMode

该属性用于设置粒子效果的混合模式。