ImageParticle QML 类型

用于使用图像可视化逻辑粒子。更多...

导入语句	import QtQuick.Particles
继承	ParticlePainter

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

属性

alpha : real
alphaVariation : real
autoRotation : bool
blueVariation : real
color : color
colorTable : url
colorVariation : real
entryEffect : EntryEffect
greenVariation : real
opacityTable : url
redVariation : real
rotation : real
rotationVariation : real
rotationVelocity : real
rotationVelocityVariation : real
sizeTable : url
source : url
sprites : list
spritesInterpolate : bool
status : Status
xVector : StochasticDirection
yVector : StochasticDirection

详细描述

此元素将逻辑粒子以图像形式呈现。图像可以进行

着色
旋转
变形
基于精灵的动画

当多个ImageParticles渲染相同的逻辑粒子组时，ImageParticles会隐式共享粒子数据。这被分解为上述列出的四个能力中。因此，如果一个ImageParticle定义了在某个能力中粒子的渲染数据，而另一个没有，那么它们将自动在这一点上以相同的方式绘制粒子。这在粒子有一些随机变化，且在更换画家时这些变化应与之相伴时尤其有用。如果两个ImageParticles都定义了该方面的外观，它们将分道扬镳，各自呈现出定义的样子。

这种数据共享是在幕后基于属性是隐式还是显式设置的。当前实现的一个缺点是，只能整体重置能力。因此，如果你显式地设置了一个影响颜色，例如 redVariation，然后重置它（通过将 redVariation 设置为未定义），所有颜色数据将重置，它将开始具有任何其他ImageParticles共享颜色的隐式值。

注意：图像粒子的最大数量限制为16383。

属性文档

alpha : real

应用到图像上的alpha值。这个值将乘以图像中的值以及颜色属性中的值。

由于粒子具有逐加式混合，所以单个粒子的alpha值较低会导致在多个粒子重叠时产生更强的效果。

Alpha值从0.0到1.0。

默认值为1.0

alphaVariation : real

粒子之间的alpha通道变化。

Alpha值从0.0到1.0。

默认值为0.0

autoRotation : bool

如果设置为true，则粒子将应用旋转，使其面对移动方向。所以要面对移动方向的反方向，将autoRotation设置为true并将旋转设置为180。

默认为false

blueVariation : real

粒子之间蓝色通道的变化。

颜色按通道测量，范围从0.0到1.0。

默认值为0.0

color : color

如果指定了颜色，则提供的图像将以该颜色着色。

默认为白色（无变化）。

colorTable : url

一个图像，其颜色将用作1D纹理，以确定生命期间的色彩。例如，当粒子寿命过半时，它将具有图像中间的指定颜色。

此颜色将与颜色属性以及源图像的颜色相混合。

colorVariation : real

此数字表示应用于单个粒子的色彩变化。设置colorVariation相当于设置 redVariation、greenVariation 和 blueVariation 为相同的数字。

每个通道的颜色可以同其自身的颜色变化最多为colorVariation。

颜色按通道测量，范围从0.0到1.0。

默认值为0.0

entryEffect : EntryEffect

此属性为粒子提供基本的、廉价的入法和出法效果。对于细粒度控制，请参阅 sizeTable 和 opacityTable。

可接受的值有

常量	描述
`ImageParticle.None`	粒子只是出现和消失。
`ImageParticle.Fade`	粒子从生命周期的开始以0不透明度淡入，并在结束时淡出到0。
`ImageParticle.Scale`	粒子在生命周期的开始以0大小缩放，并在结束时缩放回0。

默认值是 ImageParticle.Fade。

greenVariation : real

粒子之间绿色颜色通道的变化。

颜色按通道测量，范围从0.0到1.0。

默认值为0.0

opacityTable : url

一个透明度将被用作1D纹理来确定生命周期内的大小。

这个属性将很快被移除，取而代之的是自定义缓动曲线来确定透明度。

redVariation : real

粒子之间红色颜色通道的变化。

颜色按通道测量，范围从0.0到1.0。

默认值为0.0

rotation : real

如果设置，图像在被绘制之前将旋转这么多度。

粒子的坐标不进行转换。

rotationVariation : real

如果设置，单个粒子的旋转可以在粒子之间变化这么多。

rotationVelocity : real

如果设置，粒子将以每秒多少度（degrees/second）的速度旋转。

rotationVelocityVariation : real

如果设置，单个粒子的rotationVelocity在粒子之间可变化这么多。

sizeTable : url

一个透明度将被用作1D纹理来确定生命周期内的大小。

这个属性将很快被移除，取而代之的是自定义缓动曲线来确定大小。

source : url

要使用的源图像。

如果图像是精灵动画，请使用精灵属性。

从Qt 5.2开始，一些默认图像作为资源提供，以帮助原型设计

qrc:///particleresources/star.png
qrc:///particleresources/glowdot.png
qrc:///particleresources/fuzzydot.png

请注意，图像是白色和半透明的，以便颜色化和alpha级别可以发挥最大效果。

sprites : list<Sprite>

用来绘制这个粒子的精灵或精灵。

请注意，精灵图像将根据渲染的粒子大小缩放为正方形。

有关详细信息，请参阅精灵动画概述。

spritesInterpolate : bool

如果设置为true，精灵粒子将在每个渲染帧之间在精灵帧之间进行插值，使精灵看起来更平滑。

默认为true。

status : Status

加载图像的状态。

xVector : StochasticDirection

允许您在绘制时扭曲粒子图像。矩形图像将被扭曲，使其水平边是此向量的形状而不是(1,0)。

yVector : StochasticDirection

允许您在绘制时扭曲粒子图像。矩形图像将被扭曲，使其垂直边是此向量的形状而不是(0,1)。