Particle3D QML Type

抽象逻辑粒子。更多内容...

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

属性

• AlignMode : enumeration
• FadeType : enumeration
• SortMode : enumeration
• alignMode : AlignMode
• alignTargetPosition : vector3d
• color : color
• colorVariation : vector4d
• fadeInDuration : int
• fadeInEffect : FadeType
• fadeOutDuration : int
• fadeOutEffect : FadeType
• hasTransparency : bool
• maxAmount : int
• sortMode : SortMode
• unifiedColorVariation : bool

详细描述

该元素定义了逻辑粒子的通用属性。Particle3D 是粒子的抽象基类，请改用ModelParticle3D 或SpriteParticle3D 。

属性文档

AlignMode : enumeration

定义对齐类型。

FadeType : enumeration

定义淡入淡出效果的类型。

SortMode : enumeration

定义粒子的排序模式。排序模式决定了粒子的绘制顺序。

alignMode : AlignMode

此属性定义了粒子所使用的对齐模式。粒子对齐指的是粒子所朝向的方向。

默认值为Particle3D.AlignNone 。

另请参阅 alignTargetPosition 。

alignTargetPosition : vector3d

该属性定义了粒子对齐的位置。只有当“alignMode ”设置为“Particle3D.AlignTowardsTarget ”时，该属性才生效。

另请参阅 alignMode 。

color : color

此属性定义了用于给粒子上色的基色。

默认值为"#FFFFFF" （白色）。

colorVariation : vector4d

此属性定义了用于给粒子着色的颜色变化。数值按 RGBA 顺序排列，每个数值应在 0.0（无变化）到 1.0（完全变化）之间。

例如，要创建颜色在#ff0000 到#e50000 之间、不透明度在 40% 到 60% 之间的半透明红色粒子，请设置如下：

ModelParticle3D {
    ...
    color: "#7fff0000"
    colorVariation: Qt.vector4d(0.1, 0.0, 0.0, 0.2)
}

默认值为(0, 0, 0, 0) （无变化）。

另请参阅 unifiedColorVariation 。

fadeInDuration : int

该属性定义了淡入效果的持续时间（以毫秒为单位）。

默认值为250 。

另请参阅 fadeInEffect 和fadeOutDuration 。

fadeInEffect : FadeType

此属性定义粒子出现时使用的淡入效果。

默认值为Particle3D.FadeOpacity 。

另请参阅 fadeInDuration 和fadeOutEffect 。

fadeOutDuration : int

此属性定义淡出效果的持续时间（以毫秒为单位）。

默认值为250 。

另请参阅 fadeOutEffect 和fadeInDuration 。

fadeOutEffect : FadeType

此属性定义了粒子到达其lifeSpan 并消失时所使用的淡出效果。

默认值为Particle3D.FadeOpacity 。

另请参阅 fadeOutDuration 和fadeInEffect 。

hasTransparency : bool

该属性用于定义粒子是否具有透明度，以及是否应与背景进行混合。通常应设置为 true，例如当粒子颜色不具备完全透明度、纹理包含半透明像素，或者粒子不透明度正在淡入或淡出时。在特定情况下，将其设置为 false 可能是一种优化手段。

默认值为true 。

另请参阅 color 、fadeInEffect 以及fadeOutEffect 。

maxAmount : int

该属性定义了同时存在的粒子最大数量。您可以使用particlesUsed 来调试已分配粒子的使用效率。如果maxAmount过小，粒子会在达到其lifeSpan 结束之前就被重复利用。如果maxAmount过大，则会为粒子分配不必要的内存。

默认值为100 。

sortMode : SortMode

此属性定义了粒子所使用的排序模式。

默认值为Particle3D.SortNone 。

unifiedColorVariation : bool

此属性用于定义是否应将colorVariation 均匀应用于所有颜色通道。这意味着所有变化都将应用相同的随机量。

例如，若要生成颜色值介于#ffff00 和#7f7f00 之间的黄色粒子，并确保R 和G 颜色通道的值始终保持一致：

ModelParticle3D {
    ...
    color: "#ffff00"
    colorVariation: Qt.vector4d(0.5, 0.5, 0.0, 0.0)
    unifiedColorVariation: true
}

默认值为false 。

另请参阅 colorVariation 。