1/****************************************************************************
2**
3** Copyright (C) 2014 Klaralvdalens Datakonsult AB (KDAB).
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the Qt3D module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 3 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPL3 included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 3 requirements
23** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
24**
25** GNU General Public License Usage
26** Alternatively, this file may be used under the terms of the GNU
27** General Public License version 2.0 or (at your option) the GNU General
28** Public license version 3 or any later version approved by the KDE Free
29** Qt Foundation. The licenses are as published by the Free Software
30** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
31** included in the packaging of this file. Please review the following
32** information to ensure the GNU General Public License requirements will
33** be met: https://www.gnu.org/licenses/gpl-2.0.html and
34** https://www.gnu.org/licenses/gpl-3.0.html.
35**
36** $QT_END_LICENSE$
37**
38****************************************************************************/
39
40#ifndef QT3DRENDER_RENDER_SPHERE_H
41#define QT3DRENDER_RENDER_SPHERE_H
42
43//
44// W A R N I N G
45// -------------
46//
47// This file is not part of the Qt API. It exists for the convenience
48// of other Qt classes. This header file may change from version to
49// version without notice, or even be removed.
50//
51// We mean it.
52//
53
54#include <Qt3DRender/private/qt3drender_global_p.h>
55#include <Qt3DCore/qnodeid.h>
56#include <Qt3DCore/private/matrix4x4_p.h>
57#include <Qt3DRender/private/boundingsphere_p.h>
58
59QT_BEGIN_NAMESPACE
60
61namespace Qt3DRender {
62
63namespace Render {
64
65class Q_3DRENDERSHARED_PRIVATE_EXPORT Sphere : public RayCasting::BoundingSphere
66{
67public:
68 inline Sphere(Qt3DCore::QNodeId i = Qt3DCore::QNodeId())
69 : m_center()
70 , m_radius(-1.0f)
71 , m_id(i)
72 {}
73
74 inline Sphere(const Vector3D &c, float r, Qt3DCore::QNodeId i = Qt3DCore::QNodeId())
75 : m_center(c)
76 , m_radius(r)
77 , m_id(i)
78 {}
79
80 void setCenter(const Vector3D &c);
81 Vector3D center() const override;
82
83 bool isNull() const { return m_center == Vector3D() && m_radius == -1.0f; }
84
85 void setRadius(float r);
86 float radius() const override;
87
88 void clear();
89 void initializeFromPoints(const QVector<Vector3D> &points);
90 void expandToContain(const Vector3D &point);
91 inline void expandToContain(const QVector<Vector3D> &points)
92 {
93 for (const Vector3D &p : points)
94 expandToContain(point: p);
95 }
96
97 void expandToContain(const Sphere &sphere);
98
99 Sphere transformed(const Matrix4x4 &mat) const;
100 inline Sphere &transform(const Matrix4x4 &mat)
101 {
102 *this = transformed(mat);
103 return *this;
104 }
105
106 Qt3DCore::QNodeId id() const final;
107 bool intersects(const RayCasting::QRay3D &ray, Vector3D *q, Vector3D *uvw = nullptr) const final;
108 Type type() const final;
109
110 static Sphere fromPoints(const QVector<Vector3D> &points);
111
112private:
113 Vector3D m_center;
114 float m_radius;
115 Qt3DCore::QNodeId m_id;
116
117 static const float ms_epsilon;
118};
119
120inline void Sphere::setCenter(const Vector3D &c)
121{
122 m_center = c;
123}
124
125inline Vector3D Sphere::center() const
126{
127 return m_center;
128}
129
130inline void Sphere::setRadius(float r)
131{
132 Q_ASSERT(r >= 0.0f);
133 if (r >= 0.0f)
134 m_radius = r;
135}
136
137inline float Sphere::radius() const
138{
139 return m_radius;
140}
141
142inline void Sphere::clear()
143{
144 m_center = Vector3D();
145 m_radius = -1.0f;
146}
147
148inline bool intersects(const Sphere &a, const Sphere &b)
149{
150 if (a.isNull() || b.isNull())
151 return false;
152
153 // Calculate squared distance between sphere centers
154 const Vector3D d = a.center() - b.center();
155 const float distSq = Vector3D::dotProduct(a: d, b: d);
156
157 // Spheres intersect if squared distance is less than squared
158 // sum of radii
159 const float sumRadii = a.radius() + b.radius();
160 return distSq <= sumRadii * sumRadii;
161}
162
163#ifndef QT_NO_DEBUG_STREAM
164Q_3DRENDERSHARED_EXPORT QDebug operator<<(QDebug dbg, const Sphere &sphere);
165#endif
166
167} // Render
168
169} // Qt3DRender
170
171QT_END_NAMESPACE
172
173Q_DECLARE_METATYPE(Qt3DRender::Render::Sphere) // LCOV_EXCL_LINE
174
175#endif // QT3DRENDER_RENDER_SPHERE_H
176

source code of qt3d/src/render/frontend/sphere_p.h