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
|
// Copyright (C) 2021 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
#include "qquick3dparticlevectordirection_p.h"
#include "qquick3dparticlerandomizer_p.h"
#include "qquick3dparticlesystem_p.h"
QT_BEGIN_NAMESPACE
/*!
\qmltype VectorDirection3D
\inherits Direction3D
\inqmlmodule QtQuick3D.Particles3D
\brief For specifying a direction towards the target direction.
\since 6.2
This element sets emitted particle velocity towards the target direction vector.
The length of the direction vector is used as the velocity magnitude.
For example, to emit particles towards some random direction within
x: 50..150, y: -20..20, z: 0:
\qml
ParticleEmitter3D {
...
velocity: VectorDirection3D {
direction: Qt.vector3d(100, 0, 0)
directionVariation: Qt.vector3d(50, 20, 0)
}
}
\endqml
*/
QQuick3DParticleVectorDirection::QQuick3DParticleVectorDirection(QObject *parent)
: QQuick3DParticleDirection(parent)
{
}
/*!
\qmlproperty vector3d VectorDirection3D::direction
This property defines the direction for particles target.
The default value is \c (0, 100, 0) (upwards on the y-axis).
\sa directionVariation
*/
QVector3D QQuick3DParticleVectorDirection::direction() const
{
return m_direction;
}
/*!
\qmlproperty vector3d VectorDirection3D::directionVariation
This property defines the direction variation for particles target.
The default value is \c (0, 0, 0) (no variation).
\sa direction
*/
QVector3D QQuick3DParticleVectorDirection::directionVariation() const
{
return m_directionVariation;
}
/*!
\qmlproperty bool VectorDirection3D::normalized
This property defines if the direction should be normalized after applying the variation.
When this is false, variation affects the magnitude of the particles velocity.
When set to true, variation affects the direction, but the magnitude is determined
by the original direction length.
The default value is \c false.
*/
bool QQuick3DParticleVectorDirection::normalized() const
{
return m_normalized;
}
void QQuick3DParticleVectorDirection::setDirection(const QVector3D &direction)
{
if (m_direction == direction)
return;
m_direction = direction;
Q_EMIT directionChanged();
}
void QQuick3DParticleVectorDirection::setDirectionVariation(const QVector3D &directionVariation)
{
if (m_directionVariation == directionVariation)
return;
m_directionVariation = directionVariation;
Q_EMIT directionVariationChanged();
}
void QQuick3DParticleVectorDirection::setNormalized(bool normalized)
{
if (m_normalized == normalized)
return;
m_normalized = normalized;
Q_EMIT normalizedChanged();
}
QVector3D QQuick3DParticleVectorDirection::sample(const QQuick3DParticleData &d)
{
QVector3D ret;
if (!m_system)
return ret;
auto rand = m_system->rand();
ret.setX(m_direction.x() - m_directionVariation.x() + rand->get(d.index, QPRand::VDirXV) * m_directionVariation.x() * 2.0f);
ret.setY(m_direction.y() - m_directionVariation.y() + rand->get(d.index, QPRand::VDirYV) * m_directionVariation.y() * 2.0f);
ret.setZ(m_direction.z() - m_directionVariation.z() + rand->get(d.index, QPRand::VDirZV) * m_directionVariation.z() * 2.0f);
if (m_normalized)
ret = m_direction.length() * ret.normalized();
return ret;
}
QT_END_NAMESPACE
|
