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.


© 2023 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.