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
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
|
/****************************************************************************
**
** Copyright (C) 2018 Klaralvdalens Datakonsult AB (KDAB).
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt3D module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 3 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL3 included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 3 requirements
** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 2.0 or (at your option) the GNU General
** Public license version 3 or any later version approved by the KDE Free
** Qt Foundation. The licenses are as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-2.0.html and
** https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include "qraycaster.h"
#include "qabstractraycaster_p.h"
#include <Qt3DCore/qentity.h>
#include <Qt3DCore/private/qcomponent_p.h>
#include <Qt3DCore/private/qscene_p.h>
QT_BEGIN_NAMESPACE
namespace Qt3DRender {
/*!
\class Qt3DRender::QRayCaster
\inmodule Qt3DRender
\brief Qt3DRender::QRayCaster is used to perform ray casting tests in 3d world coordinates.
\inmodule Qt3DRender
\since 5.11
\inherits QAbstractRayCaster
The 3d ray is defined by its origin, direction and length. It will be affected by the
transformations applied to the entity it belongs to.
Ray casting tests will be performed every frame as long as the component is enabled.
The hits property will be updated with the list of intersections.
\sa QAbstractRayCaster, QScreenRayCaster, QNoPicking
*/
/*!
\qmltype RayCaster
\brief used to perform ray casting tests in 3d world coordinates.
\inqmlmodule Qt3D.Render
\since 5.11
\instantiates Qt3DRender::QRayCaster
The 3d ray is defined by its origin, direction and length. It will be affected by the
transformations applied to the entity it belongs to.
Ray casting tests will be performed every frame as long as the component is enabled.
The hits property will be updated with the list of intersections.
\sa AbstractRayCaster, ScreenRayCaster, NoPicking
*/
/*!
\property Qt3DRender::QRayCaster::origin
Holds the origin of the 3D ray in local coordinates.
*/
/*!
\qmlproperty vector3d Qt3D.Render::RayCaster::origin
Holds the origin of the 3D ray in local coordinates.
*/
/*!
\property Qt3DRender::QRayCaster::direction
Holds the direction of the 3D ray. This should be a unit vector.
*/
/*!
\qmlproperty vector3D Qt3D.Render::RayCaster::direction
Holds the direction of the 3D ray. This should be a unit vector.
*/
/*!
\property Qt3DRender::QRayCaster::length
Holds the length of the 3D ray.
*/
/*!
\qmlproperty real Qt3D.Render::RayCaster::length
Holds the length of the 3d ray.
*/
QRayCaster::QRayCaster(Qt3DCore::QNode *parent)
: QAbstractRayCaster(parent)
{
QAbstractRayCasterPrivate::get(this)->m_rayCasterType = QAbstractRayCasterPrivate::WorldSpaceRayCaster;
}
QRayCaster::QRayCaster(QAbstractRayCasterPrivate &dd, Qt3DCore::QNode *parent)
: QAbstractRayCaster(dd, parent)
{
QAbstractRayCasterPrivate::get(this)->m_rayCasterType = QAbstractRayCasterPrivate::WorldSpaceRayCaster;
}
/*! \internal */
QRayCaster::~QRayCaster()
{
}
QVector3D QRayCaster::origin() const
{
auto d = QAbstractRayCasterPrivate::get(this);
return d->m_origin;
}
void QRayCaster::setOrigin(const QVector3D &origin)
{
auto d = QAbstractRayCasterPrivate::get(this);
if (d->m_origin != origin) {
d->m_origin = origin;
emit originChanged(d->m_origin);
}
}
QVector3D QRayCaster::direction() const
{
auto d = QAbstractRayCasterPrivate::get(this);
return d->m_direction;
}
void QRayCaster::setDirection(const QVector3D &direction)
{
auto d = QAbstractRayCasterPrivate::get(this);
if (d->m_direction != direction) {
d->m_direction = direction;
emit directionChanged(d->m_direction);
}
}
float QRayCaster::length() const
{
auto d = QAbstractRayCasterPrivate::get(this);
return d->m_length;
}
/*!
* \brief Sets the length of the ray to \a length.
*
* If the value is less than or equal to zero, the ray is concidered to be infinite.
*/
void QRayCaster::setLength(float length)
{
auto d = QAbstractRayCasterPrivate::get(this);
if (!qFuzzyCompare(d->m_length, length)) {
d->m_length = length;
emit lengthChanged(d->m_length);
}
}
/*!
* Convenience method to enable the component and trigger tests using the current ray.
*/
void QRayCaster::trigger()
{
setEnabled(true);
}
/*!
* Convenience method to set the ray details \a origin, \a direction, and \a length,
* and enable the component to trigger tests.
*/
void QRayCaster::trigger(const QVector3D &origin, const QVector3D &direction, float length)
{
setOrigin(origin);
setDirection(direction);
setLength(length);
setEnabled(true);
}
} // Qt3DRender
QT_END_NAMESPACE
|
