DynamicBurst3D QML Type | Qt Quick 3D (original) (raw)

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.

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.

This property defines the random variation in particle emit amount.

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

The default value is 0.

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

The default value is true.

This property defines the emitting mode.

The default value is TriggerMode.TriggerTime.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.