Particle3D QML 类型

抽象逻辑粒子。更多信息...

导入语句	import QtQuick3D.Particles3D
自从	Qt 6.2
继承	Object3D
继承者	ModelBlendParticle3D，ModelParticle3D 和 SpriteParticle3D

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

属性

AlignMode : 枚举
FadeType : 枚举
SortMode : 枚举
alignMode : AlignMode
alignTargetPosition : 矢量3D
color : 颜色
colorVariation : 矢量4D
fadeInDuration : 整数
fadeInEffect : FadeType
fadeOutDuration : 整数
fadeOutEffect : FadeType
hasTransparency : 布尔
maxAmount : 整数
sortMode : SortMode
unifiedColorVariation : 布尔

详细信息

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

注意：与模型一起使用的材质不同，粒子默认以半透明渲染，因此启用混合。由于粒子纹理、颜色（ alpha）变化、渐变等，这通常是期望的行为。如果你不需要混合，将 hasTransparency 设置为 false 可望获得可能的性能提升。

属性文档

AlignMode : 枚举

定义了对齐的类型。

常量	描述
`Particle3D.AlignNone`	无对齐。可以使用 particleRotation 定义粒子的旋转。
`Particle3D.AlignTowardsTarget`	使粒子朝向alignTargetPosition方向对齐。
`Particle3D.AlignTowardsStartVelocity`	使粒子朝向它们的起始速度方向对齐。

FadeType : 枚举

定义渐变效果的类型。

常量	描述
`Particle3D.FadeNone`	没有渐变。
`Particle3D.FadeOpacity`	从/to 0.0渐变粒子不透明度。
`Particle3D.FadeScale`	从/to 0.0渐变粒子缩放。

SortMode : 枚举

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

常量	描述
`Particle3D.SortNone`	没有排序。
`Particle3D.SortNewest`	根据粒子寿命排序，最新的优先。
`Particle3D.SortOldest`	根据粒子寿命排序，最旧的优先。
`Particle3D.SortDistance`	根据到摄像机的距离排序，最远的优先。

alignMode : AlignMode

此属性定义用于粒子的对齐模式。粒子对齐意味着粒子面向的方向。

注意：当设置SpriteParticle3D的billboard属性为true时，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

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

注意：渐变持续时间是粒子lifeSpan的一部分。例如，如果lifeSpan为3000，fadeInDuration为500，fadeOutDuration为500，则粒子完全可见时间为2000毫秒。

默认值是250。

另请参阅：fadeInEffect和fadeOutDuration。

fadeInEffect : FadeType

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

默认值是Particle3D.FadeOpacity。

另请参阅：fadeInDuration和fadeOutEffect。

fadeOutDuration : int

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

默认值是250。

另请参阅 fadeOutEffect 和 fadeInDuration.

fadeOutEffect : FadeType

此属性定义了粒子达到其生命周期并消失时使用的淡出效果。

默认值是Particle3D.FadeOpacity。

另请参阅 fadeOutDuration 和 fadeInEffect.

hasTransparency : bool

此属性定义粒子是否具有透明度，并且是否应该与背景混合。通常应该为 true，例如当粒子的颜色没有完整的 alpha 值，纹理包含半透明像素，或者粒子的不透明度淡入或淡出时。在某些特定情况下将此设置为 false 可以为优化。

默认值是 true。

另请参阅 color、fadeInEffect 和 fadeOutEffect。

maxAmount : int

此属性定义同时存在的最大粒子数量。您可以使用 particlesUsed 进行调试，以查看分配的粒子使用效率。如果 maxAmount 太小，粒子在达到其生命周期结束之前就会被重用。如果 maxAmount 太大，则会为粒子分配不必要的内存。

注意： 更改 maxAmount 将重置粒子系统中的所有粒子。

默认值是 100。

sortMode : SortMode

此属性定义用于粒子的排序模式。

默认值是 Particle3D.SortNone。

unifiedColorVariation : bool

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

例如，要创建在 #ffff00 和 #7f7f00 之间具有黄色的粒子，使 R 和 G 颜色通道的值始终相同

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

默认值是 false。

另请参阅 colorVariation。