1// Copyright (C) 2023 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
3
4//
5// W A R N I N G
6// -------------
7//
8// This file is not part of the QtGraphs API. It exists purely as an
9// implementation detail. This header file may change from version to
10// version without notice, or even be removed.
11//
12// We mean it.
13
14#ifndef QQUICKGRAPHSSURFACE_P_H
15#define QQUICKGRAPHSSURFACE_P_H
16
17#include "qquickgraphsitem_p.h"
18#include "qsurface3dseries.h"
19
20#include <private/qgraphsglobal_p.h>
21
22QT_BEGIN_NAMESPACE
23
24class QValue3DAxis;
25class QSurface3DSeries;
26class QQuickGraphsSurface;
27
28struct Surface3DChangeBitField
29{
30 bool selectedPointChanged : 1;
31 bool rowsChanged : 1;
32 bool itemChanged : 1;
33 bool flipHorizontalGridChanged : 1;
34 bool surfaceTextureChanged : 1;
35
36 Surface3DChangeBitField()
37 : selectedPointChanged(true)
38 , rowsChanged(false)
39 , itemChanged(false)
40 , flipHorizontalGridChanged(true)
41 , surfaceTextureChanged(true)
42 {}
43};
44
45class Q_GRAPHS_EXPORT QQuickGraphsSurface : public QQuickGraphsItem
46{
47 Q_OBJECT
48 Q_PROPERTY(QValue3DAxis *axisX READ axisX WRITE setAxisX NOTIFY axisXChanged)
49 Q_PROPERTY(QValue3DAxis *axisY READ axisY WRITE setAxisY NOTIFY axisYChanged)
50 Q_PROPERTY(QValue3DAxis *axisZ READ axisZ WRITE setAxisZ NOTIFY axisZChanged)
51 Q_PROPERTY(QSurface3DSeries *selectedSeries READ selectedSeries NOTIFY selectedSeriesChanged)
52 Q_PROPERTY(QQmlListProperty<QSurface3DSeries> seriesList READ seriesList CONSTANT)
53 Q_PROPERTY(bool flipHorizontalGrid READ flipHorizontalGrid WRITE setFlipHorizontalGrid NOTIFY
54 flipHorizontalGridChanged)
55 Q_CLASSINFO("DefaultProperty", "seriesList")
56
57 QML_NAMED_ELEMENT(Surface3D)
58
59public:
60 explicit QQuickGraphsSurface(QQuickItem *parent = 0);
61 ~QQuickGraphsSurface() override;
62
63 struct ChangeItem
64 {
65 QSurface3DSeries *series;
66 QPoint point;
67 };
68 struct ChangeRow
69 {
70 QSurface3DSeries *series;
71 qsizetype row;
72 };
73 enum DataDimension {
74 BothAscending = 0,
75 XDescending = 1,
76 ZDescending = 2,
77 BothDescending = XDescending | ZDescending,
78 };
79 Q_DECLARE_FLAGS(DataDimensions, DataDimension)
80
81 void setAxisX(QValue3DAxis *axis);
82 QValue3DAxis *axisX() const;
83 void setAxisY(QValue3DAxis *axis);
84 QValue3DAxis *axisY() const;
85 void setAxisZ(QValue3DAxis *axis);
86 QValue3DAxis *axisZ() const;
87
88 QQmlListProperty<QSurface3DSeries> seriesList();
89 static void appendSeriesFunc(QQmlListProperty<QSurface3DSeries> *list, QSurface3DSeries *series);
90 static qsizetype countSeriesFunc(QQmlListProperty<QSurface3DSeries> *list);
91 static QSurface3DSeries *atSeriesFunc(QQmlListProperty<QSurface3DSeries> *list, qsizetype index);
92 static void clearSeriesFunc(QQmlListProperty<QSurface3DSeries> *list);
93 Q_INVOKABLE void addSeries(QSurface3DSeries *series);
94 Q_INVOKABLE void removeSeries(QSurface3DSeries *series);
95 Q_INVOKABLE void clearSelection() override;
96
97 void setFlipHorizontalGrid(bool flip);
98 bool flipHorizontalGrid() const;
99 bool isFlatShadingSupported();
100 QList<QSurface3DSeries *> surfaceSeriesList();
101 void updateSurfaceTexture(QSurface3DSeries *series);
102
103 static QPoint invalidSelectionPosition();
104 void setSelectedPoint(QPoint position, QSurface3DSeries *series, bool enterSlice);
105
106 QSurface3DSeries *selectedSeries() const { return m_selectedSeries; }
107 void setSelectionMode(QtGraphs3D::SelectionFlags mode) override;
108
109 void setDataDimensions(DataDimensions dimension) { m_dataDimensions = dimension; }
110 DataDimensions dataDimensions() { return m_dataDimensions; }
111
112 bool hasChangedSeriesList() const { return !m_changedSeriesList.isEmpty(); }
113 bool isSeriesVisibilityDirty() const { return m_isSeriesVisibilityDirty; }
114 void setSeriesVisibilityDirty(bool dirty) { m_isSeriesVisibilityDirty = dirty; }
115 bool isDataDirty() const { return m_isDataDirty; }
116 void setDataDirty(bool dirty) { m_isDataDirty = dirty; }
117 bool isSeriesVisualsDirty() const { return m_isSeriesVisualsDirty; }
118 void setSeriesVisualsDirty(bool dirty) { m_isSeriesVisualsDirty = dirty; }
119 bool isIndexDirty() const { return m_isIndexDirty; }
120 void setIndexDirty(bool dirty) { m_isIndexDirty = dirty; }
121
122 QList<QAbstract3DSeries *> changedSeriesList() { return m_changedSeriesList; }
123
124 bool isSelectedPointChanged() const { return m_changeTracker.selectedPointChanged; }
125 void setSelectedPointChanged(bool changed) { m_changeTracker.selectedPointChanged = changed; }
126
127 bool isFlipHorizontalGridChanged() const { return m_changeTracker.flipHorizontalGridChanged; }
128 void setFlipHorizontalGridChanged(bool changed)
129 {
130 m_changeTracker.flipHorizontalGridChanged = changed;
131 }
132
133 bool isSurfaceTextureChanged() const { return m_changeTracker.surfaceTextureChanged; }
134 void setSurfaceTextureChanged(bool changed) { m_changeTracker.surfaceTextureChanged = changed; }
135 bool isChangedTexturesEmpty() const { return m_changedTextures.empty(); }
136 bool hasSeriesToChangeTexture(QSurface3DSeries *series) const
137 {
138 return m_changedTextures.contains(t: series);
139 }
140
141 void handleAxisAutoAdjustRangeChangedInOrientation(QAbstract3DAxis::AxisOrientation orientation,
142 bool autoAdjust) override;
143 void handleAxisRangeChangedBySender(QObject *sender) override;
144 void handleSeriesVisibilityChangedBySender(QObject *sender) override;
145 void adjustAxisRanges() override;
146
147 void handleLightingModeChanged() override;
148
149 void renderSliceToImage(int index,
150 int requestedIndex,
151 QtGraphs3D::SliceCaptureType sliceType);
152 Q_REVISION(6, 10)
153 Q_INVOKABLE void renderSliceToImage(int index, int requestedIndex,
154 QtGraphs3D::SliceCaptureType sliceType,
155 const QUrl &filePath);
156
157protected:
158 void componentComplete() override;
159 void synchData() override;
160 void updateGraph() override;
161 void calculateSceneScalingFactors() override;
162 void toggleSliceGraph() override;
163 void updateSingleHighlightColor() override;
164 void updateLightStrength() override;
165 void handleThemeTypeChange() override;
166 bool doPicking(QPointF position) override;
167 bool doRayPicking(QVector3D origin, QVector3D direction) override;
168
169 void createSliceView() override;
170 void updateSliceItemLabel(const QString &label, QVector3D position) override;
171 void updateSelectionMode(QtGraphs3D::SelectionFlags mode) override;
172
173 QQuick3DViewport *createOffscreenSliceView(int index, int requestedIndex,
174 QtGraphs3D::SliceCaptureType sliceType);
175
176public Q_SLOTS:
177 void handleAxisXChanged(QAbstract3DAxis *axis) override;
178 void handleAxisYChanged(QAbstract3DAxis *axis) override;
179 void handleAxisZChanged(QAbstract3DAxis *axis) override;
180
181 void handleShadingChanged();
182 void handleWireframeColorChanged();
183 void handleFlipHorizontalGridChanged(bool flip);
184
185 void handleArrayReset();
186 void handleRowsAdded(qsizetype startIndex, qsizetype count);
187 void handleRowsChanged(qsizetype startIndex, qsizetype count);
188 void handleRowsRemoved(qsizetype startIndex, qsizetype count);
189 void handleRowsInserted(qsizetype startIndex, qsizetype count);
190 void handleItemChanged(qsizetype rowIndex, qsizetype columnIndex);
191
192 void handleFlatShadingSupportedChange(bool supported);
193
194Q_SIGNALS:
195 void axisXChanged(QValue3DAxis *axis);
196 void axisYChanged(QValue3DAxis *axis);
197 void axisZChanged(QValue3DAxis *axis);
198 void selectedSeriesChanged(QSurface3DSeries *series);
199 void flipHorizontalGridChanged(bool flip);
200 Q_REVISION(6, 10)
201 void sliceImageChanged(const QImage &image);
202
203private:
204 struct SurfaceVertex
205 {
206 QVector3D position;
207 QVector2D uv;
208 QPoint coord;
209 };
210
211 struct SurfaceModel
212 {
213 QQuick3DModel *model;
214 QQuick3DModel *gridModel;
215 QQuick3DModel *sliceModel;
216 QQuick3DModel *sliceGridModel;
217 QQuick3DModel *fillModel;
218 QVector<SurfaceVertex> vertices;
219 QVector<QVector4D> heights;
220 QVector<quint32> indices;
221 QVector<quint32> gridIndices;
222 QSurface3DSeries *series;
223 QQuick3DTexture *gradientTexture;
224 QQuick3DTexture *texture;
225 QQuick3DTexture *heightTexture;
226 QQuick3DCustomMaterial *customMaterial;
227 qsizetype columnCount;
228 qsizetype rowCount;
229 SurfaceVertex selectedVertex;
230 bool picked = false;
231 QVector3D boundsMin;
232 QVector3D boundsMax;
233 QRect sampleSpace;
234 bool ascendingX;
235 bool ascendingZ;
236 };
237
238 QVector3D getNormalizedVertex(const QSurfaceDataItem &data, bool polar, bool flipXZ);
239 QRect calculateSampleSpace(SurfaceModel *model);
240 QPointF mapCoordsToWorldSpace(SurfaceModel *model, QPointF coords);
241 QPoint mapCoordsToSampleSpace(SurfaceModel *model, QPointF coords);
242 void createIndices(SurfaceModel *model, qsizetype columnCount, qsizetype rowCount);
243 void createLineIndices(SurfaceModel *model, qsizetype pointCount);
244 void createGridlineIndices(SurfaceModel *model, qsizetype x, qsizetype y, qsizetype endX, qsizetype endY);
245 void handleChangedSeries();
246 void updateModel(SurfaceModel *model);
247 void updateFill(SurfaceModel *model);
248 void updateLineFill(SurfaceModel *model);
249 void updateMaterial(SurfaceModel *model);
250 void updateSelectedPoint();
251 void addModel(QSurface3DSeries *series);
252 void addFillModel(SurfaceModel *model);
253 void addSliceModel(SurfaceModel *model);
254
255 void handleMeshTypeChanged(QAbstract3DSeries::Mesh mesh);
256 void handlePointerChanged(const QString &filename);
257 void changePointerMeshTypeForSeries(QAbstract3DSeries::Mesh mesh, QSurface3DSeries *series);
258 void changePointerForSeries(const QString &filename, QSurface3DSeries *series);
259 void changeSlicePointerMeshTypeForSeries(QAbstract3DSeries::Mesh mesh, QSurface3DSeries *series);
260 void changeSlicePointerForSeries(const QString &filename, QSurface3DSeries *series);
261 QString getMeshFileName(QAbstract3DSeries::Mesh mesh, QSurface3DSeries *series) const;
262
263 QVector3D pickSurfaces(QVector3D rayOrigin, QVector3D rayDir, SurfaceModel *&pickedModel);
264 QVector3D triangleIntersection(QVector3D origin,
265 QVector3D dir,
266 const std::array<QVector3D, 3> &triangle);
267 bool intersectWithAABB(QVector3D boundMin, QVector3D boundsMax, QVector3D origin, QVector3D dir);
268
269 QVector<SurfaceModel *> m_model;
270 QMap<QSurface3DSeries *, QQuick3DModel *> m_selectionPointers = {};
271 QMap<QSurface3DSeries *, QQuick3DModel *> m_sliceSelectionPointers = {};
272
273 bool m_isIndexDirty = true;
274 bool m_selectionDirty = false;
275 QHash<SurfaceModel *, bool> m_fillDirty;
276
277 Surface3DChangeBitField m_changeTracker;
278 QPoint m_selectedPoint;
279 QSurface3DSeries *m_selectedSeries
280 = nullptr; // Points to the series for which the point is selected in
281 // single series selection cases.
282 bool m_flatShadingSupported = true;
283 QList<ChangeItem> m_changedItems;
284 QList<ChangeRow> m_changedRows;
285 bool m_flipHorizontalGrid = false;
286 QList<QSurface3DSeries *> m_changedTextures;
287 bool m_isSeriesVisibilityDirty = false;
288
289 QQuick3DModel *m_topGrid = nullptr;
290 QQuick3DNode *m_topGridScale = nullptr;
291 QQuick3DNode *m_topGridRotation = nullptr;
292
293 DataDimensions m_dataDimensions;
294
295 QImage *m_grabresult = nullptr;
296
297 friend class Q3DSurfaceWidgetItem;
298 friend class QQuickGraphsSurfaceNode;
299};
300
301QT_END_NAMESPACE
302
303#endif // QQUICKGRAPHSSURFACE_P_H
304

source code of qtgraphs/src/graphs3d/qml/qquickgraphssurface_p.h