- Qt 6.8
- Qt Quick 3D
- QML Types
- QtQuick3D.Particles3D
- DynamicBurst3D
- Qt Quick 3D | Commercial or GPLv3

# DynamicBurst3D QML Type

Dynamic emitter bursts. More...

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

- List of all members, including inherited members

## Properties

- TriggerMode : enumeration
- amountVariation : int
- enabled : bool
- triggerMode : ShapeType

## 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.

Constant | Description
--- | ---
`DynamicBurst3D.TriggerTime` | The particles are emitted when the burst time is due.
`DynamicBurst3D.TriggerStart` | The 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.

Constant | Description
--- | ---
`DynamicBurst3D.TriggerEnd` | The 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`.