blob: 2dde100179a2fe6236897697b0f19a71972cf88f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
// Copyright (C) 2021 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
#include "qquick3dparticleemitburst_p.h"
#include "qquick3dparticleemitter_p.h"
#include <qdebug.h>
QT_BEGIN_NAMESPACE
/*!
\qmltype EmitBurst3D
\inherits QtObject
\inqmlmodule QtQuick3D.Particles3D
\brief Declarative emitter bursts.
\since 6.2
This element defines particle bursts in the \l ParticleEmitter3D. These bursts are
static, meaning that they are evaluated when the particlesystem starts. This allows
better performance than \l DynamicBurst3D and bursting outside of the particlesystem
time (so e.g. burst at 1000ms while system time starts from 2000ms).
\note EmitBurst3D uses emitter properties (position, rotation etc.) at the
particlesystem start. For dynamic emitters, use \l DynamicBurst3D instead.
For example, to emit 100 particles at the beginning, and 50 particles at 2 seconds,
so that both bursts take 200 milliseconds:
\qml
ParticleEmitter3D {
...
emitBursts: [
EmitBurst3D {
time: 0
amount: 100
duration: 200
},
EmitBurst3D {
time: 2000
amount: 50
duration: 200
}
]
}
\endqml
*/
QQuick3DParticleEmitBurst::QQuick3DParticleEmitBurst(QObject *parent)
: QObject(parent)
{
m_parentEmitter = qobject_cast<QQuick3DParticleEmitter *>(parent);
}
QQuick3DParticleEmitBurst::~QQuick3DParticleEmitBurst()
{
if (m_parentEmitter)
m_parentEmitter->unRegisterEmitBurst(this);
}
/*!
\qmlproperty int EmitBurst3D::time
This property defines the time in milliseconds when emitting the burst starts.
The default value is \c 0.
*/
int QQuick3DParticleEmitBurst::time() const
{
return m_time;
}
/*!
\qmlproperty int EmitBurst3D::amount
This property defines the amount of particles emitted during the burst.
The default value is \c 0.
*/
int QQuick3DParticleEmitBurst::amount() const
{
return m_amount;
}
/*!
\qmlproperty int EmitBurst3D::duration
This property defines the duration of the burst. The default value is 0,
meaning all particles will burst at the beginning of \l time.
If the duration is set, particles emitting is distributed between \c time
and \c time + \c duration.
For example, to have emit rate of 400 between 1000 and 1200 milliseconds:
\qml
EmitBurst3D {
time: 1000
amount: 80
duration: 1200
}
\endqml
The default value is \c 0.
*/
int QQuick3DParticleEmitBurst::duration() const
{
return m_duration;
}
void QQuick3DParticleEmitBurst::setTime(int time)
{
if (m_time == time)
return;
m_time = time;
Q_EMIT timeChanged();
}
void QQuick3DParticleEmitBurst::setAmount(int amount)
{
if (m_amount == amount)
return;
if (amount < 0) {
qWarning () << "EmitBurst3D: Amount must be positive.";
return;
}
m_amount = amount;
Q_EMIT amountChanged();
}
void QQuick3DParticleEmitBurst::setDuration(int duration)
{
if (m_duration == duration)
return;
if (duration < 0) {
qWarning () << "EmitBurst3D: Duration must be positive.";
return;
}
m_duration = duration;
Q_EMIT durationChanged();
}
void QQuick3DParticleEmitBurst::componentComplete()
{
m_parentEmitter = qobject_cast<QQuick3DParticleEmitter *>(parent());
if (m_parentEmitter)
m_parentEmitter->registerEmitBurst(this);
else
qWarning() << "EmitBurst requires parent Emitter to function correctly!";
}
QT_END_NAMESPACE
|
