QML类型说明-Emitter

Emitter

ImportStatement:   import QtQuick.Particles 2.0

Properties

acceleration: StochasticDirection

emitRate :real

enabled :bool

endSize :real

group :string

lifeSpan :int

lifeSpanVariation: int

maximumEmitted: int

shape :Shape

size : real

sizeVariation: real

startTime :int

system :ParticleSystem

velocity :StochasticDirection

velocityFromMovement: qreal

Signals

voidemitParticles(Array particles)

Methods

voidburst(int count, int x, int y)

voidburst(int count)

voidpulse(int duration)

Detailed Description

这个元件发射一组有开始属性的逻辑粒子给粒子系统。注意逻辑粒子不会自动渲染，我们必须定义一个或多个有可视化属性的ParticlePainter。ParticlePainter没有实际的实现，我们定义的其实是它的子元件。另外，给定开始属性的粒子，可在存活的任何时间，被同一个粒子系统中定义的Affector影响。这包含生命周期这个属性。

Property Documentation

acceleration: StochasticDirection

粒子被发射时的加速度。

 

emitRate :real

每秒发射的粒子数目。默认是10。

 

enabled :bool

如果设置为假，发射器停止发射。默认值为真。

 

endSize :real

在粒子生命结束时的像素尺寸。粒子的尺寸将会在粒子的生命周期不断改变。如果这个属性设置为-1，那么粒子的尺寸一直不变。默认值为-1。

 

group :string

被发射器发射的粒子逻辑组。默认发射空组。即没有组属性的粒子。

 

lifeSpan :int

以毫秒为单位的粒子寿命。如果我们不想粒子自动死亡，而是人工的清除。则设置这个属性为Emitter.InfiniteLife。当粒子的寿命大于等于600000（10分钟）时，粒子被认为是不死的。当寿命小于等于0时，粒子死亡。默认值是1000。

 

lifeSpanVariation: int

粒子的寿命将随着方向变化。默认值为0。

 

maximumEmitted: int

粒子的最大数目。它能在运行时用burst和pulse设置。假如这个值小于0，则发射器没有最大粒子数目限制。默认值为-1。

 

shape :Shape

粒子将随机的从shape的范围内发射。默认的shape是一个矩形。粒子从边框发射。

 

size : real

粒子被发射时的像素尺寸，默认值16。

 

sizeVariation: real

粒子发射时的变化像素尺寸，这让发射的粒子大小不同。默认值是0。

 

startTime :int

如果发射器带着这个值加载，那么发出的粒子还没有出生，所有的affectors也不会生效。直到经过startTime毫秒后，粒子正式出生，affectors才开始生效。

 

system :ParticleSystem

发射器将粒子发射到那个粒子系统。如果发射器是粒子系统的子元件，则自动绑定。

 

velocity :StochasticDirection

粒子发射的速度。

 

velocityFromMovement: qreal

假如这个值为非0，那么发射器的速度将以矢量的形式附加到粒子的速度上。矢量的大小取决于发射器运动状态和velocityFromMovement的乘积。默认为0。

Signal Documentation

voidemitParticles(Array particles)

一个队列的粒子发射时这个信号发出。让我们能在程序上修改发射的粒子属性。但由于Java脚步运行的较慢，所以这个信号不推荐用在大容量的粒子系统中。

关联程序是onEmitParticles。

Method Documentation

voidburst(int count, int x, int y)

立刻从发射器发射count数目的粒子。除了发射器被定为在x、y，所有粒子的其他属性都是相同的。

 

voidburst(int count)

立刻从发射器发射count数目的粒子。

 

voidpulse(int duration)

如果发射器没有打开则打开它，然后当毫秒时间duration流逝后，关闭它。