SpriteParticle3D QML 类型

使用 2D 精灵纹理的粒子。更多...

导入语句	import QtQuick3D.Particles3D
自从	Qt 6.2
继承自	Particle3D
由以下类继承	LineParticle3D

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

属性

BlendMode : 枚举
billboard : 布尔
blendMode : BlendMode
castsReflections : 布尔 (自从 6.4)
colorTable : Texture
lights : Light 列表 (自从 6.3)
offsetX : 浮点数 (自从 6.3)
offsetY : 浮点数 (自从 6.3)
particleScale : 实数
sprite : Texture
spriteSequence : SpriteSequence3D

详细描述

SpritedParticle3D 是一个逻辑粒子元素，它从 2D 精灵纹理中创建粒子。

属性文档

BlendMode : 枚举

定义粒子的混合模式。

常量	描述
`SpritedParticle3D.SourceOver`	使用 SourceOver 模式混合粒子。
`SpritedParticle3D.Screen`	使用 Screen 模式混合粒子。
`SpritedParticle3D.Multiply`	使用 Multiply 模式混合粒子。

billboard : 布尔

该属性定义粒子纹理是否始终面向屏幕对齐。

注意：当设置为 true 时，Particle3D 的 alignMode 属性将不起作用。

默认值为 false。

blendMode : BlendMode

该属性定义用于渲染粒子的混合模式。

默认值为 SpritedParticle3D.SourceOver。

castsReflections : 布尔 [自从 6.4]

当此属性设置为 true 时，精灵将通过反射探头渲染，并可在反射中看到。

此属性在 Qt 6.4 中引入。

颜色表：Texture

此属性定义了用于粒子着色的Texture。图像可以是1D或2D纹理。水平像素确定粒子在其生命周期中的颜色。例如，当粒子处于其生命期的中点时，它的颜色将是图像中中点的颜色。如果图像是2D的，将为每个粒子随机选择垂直行。例如，一个c {256 x 4} 的图像包含了Texture中用于粒子的4种不同的着色选项。

lights : list<Light> （自6.3版起）

此属性包含用于绘制粒子的灯光列表。

注意：为了获得最佳性能，仅在需要时定义灯光，并尽量减少灯光数量。

此属性是在Qt 6.3版本中引入的。

offsetX : float （自6.3版起）

此属性定义了粒子在X轴上的偏移。

此属性是在Qt 6.3版本中引入的。

offsetY : float （自6.3版起）

此属性定义了粒子在Y轴上的偏移。

此属性是在Qt 6.3版本中引入的。

particleScale : real

此属性定义了粒子的缩放倍数。要调整发射器中粒子的大小，请使用ParticleEmitter3D的particleScale、particleEndScale和particleScaleVariation属性。

默认值为5.0。

sprite : Texture

此属性定义了用于粒子的Texture。

例如，要将"snowFlake.png"用作粒子纹理

SpriteParticle3D {
    id: snowParticle
    ...
    sprite: Texture {
        source: "images/snowflake.png"
    }
}

spriteSequence : SpriteSequence3D

此属性定义了粒子的精灵序列属性。如果sprite纹理包含帧序列，设置此属性以定义帧数量、动画方向等特性。