DynamicBurst3D QML Type

Dynamic emitter bursts. More...

Import Statement: import QtQuick3D.Particles3D
Since: Qt 6.3
Inherits:

EmitBurst3D

Properties

Detailed Description

This element defines particle bursts in the ParticleEmitter3D. These bursts are dynamic, meaning that they are evaluated while the particlesystem runs. Use these instead of EmitBurst3D for example when the emitter moves, so that emitting happens at the correct position.

For example, to emit 100 particles at 1 second time and 200 particles at 2 second:

 ParticleEmitter3D {
     ...
     emitBursts: [
         DynamicBurst3D {
             time: 1000
             amount: 100
         },
         DynamicBurst3D {
             time: 2000
             amount: 200
         }
     ]
 }

Property Documentation

TriggerMode : enumeration

Defines the mode of the bursting.

ConstantDescription
DynamicBurst3D.TriggerTimeThe particles are emitted when the burst time is due.
DynamicBurst3D.TriggerStartThe particles are emitted when the followed particle is emitted.

Note: This property is restricted to only work with trail emitters.

Note: In this mode, time and duration properties don't have an effect.

ConstantDescription
DynamicBurst3D.TriggerEndThe particles are emitted when the followed particle lifeSpan ends.

Note: This property is restricted to only work with trail emitters.

Note: In this mode, time and duration properties don't have an effect.


amountVariation : int

This property defines the random variation in particle emit amount.

For example, to have a random range between 0 and 10

 DynamicBurst3D {
     time: 1000
     amount: 5
     amountVariation: 5
 }

The default value is 0.


enabled : bool

If enabled is set to false, this burst will not emit any particles.

The default value is true.


triggerMode : ShapeType

This property defines the emitting mode.

The default value is TriggerMode.TriggerTime.