1/****************************************************************************
2**
3** Copyright (C) 2016 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the Qt Data Visualization module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:GPL$
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 General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU
19** General Public License version 3 or (at your option) any later version
20** approved by the KDE Free Qt Foundation. The licenses are as published by
21** the Free Software Foundation and appearing in the file LICENSE.GPL3
22** included in the packaging of this file. Please review the following
23** information to ensure the GNU General Public License requirements will
24** be met: https://www.gnu.org/licenses/gpl-3.0.html.
25**
26** $QT_END_LICENSE$
27**
28****************************************************************************/
29
30//
31// W A R N I N G
32// -------------
33//
34// This file is not part of the QtDataVisualization API. It exists purely as an
35// implementation detail. This header file may change from version to
36// version without notice, or even be removed.
37//
38// We mean it.
39
40#ifndef Q3DBARSCONTROLLER_p_H
41#define Q3DBARSCONTROLLER_p_H
42
43#include "datavisualizationglobal_p.h"
44#include "abstract3dcontroller_p.h"
45
46QT_BEGIN_NAMESPACE_DATAVISUALIZATION
47
48class Bars3DRenderer;
49class QBar3DSeries;
50
51struct Bars3DChangeBitField {
52 bool multiSeriesScalingChanged : 1;
53 bool barSpecsChanged : 1;
54 bool selectedBarChanged : 1;
55 bool rowsChanged : 1;
56 bool itemChanged : 1;
57 bool floorLevelChanged : 1;
58
59 Bars3DChangeBitField() :
60 multiSeriesScalingChanged(true),
61 barSpecsChanged(true),
62 selectedBarChanged(true),
63 rowsChanged(false),
64 itemChanged(false),
65 floorLevelChanged(false)
66 {
67 }
68};
69
70class QT_DATAVISUALIZATION_EXPORT Bars3DController : public Abstract3DController
71{
72 Q_OBJECT
73
74public:
75 struct ChangeItem {
76 QBar3DSeries *series;
77 QPoint point;
78 };
79 struct ChangeRow {
80 QBar3DSeries *series;
81 int row;
82 };
83
84private:
85 Bars3DChangeBitField m_changeTracker;
86 QVector<ChangeItem> m_changedItems;
87 QVector<ChangeRow> m_changedRows;
88
89 // Interaction
90 QPoint m_selectedBar; // Points to row & column in data window.
91 QBar3DSeries *m_selectedBarSeries; // Points to the series for which the bar is selected in
92 // single series selection cases.
93 QBar3DSeries *m_primarySeries; // Category axis labels are taken from the primary series
94
95 // Look'n'feel
96 bool m_isMultiSeriesUniform;
97 bool m_isBarSpecRelative;
98 GLfloat m_barThicknessRatio;
99 QSizeF m_barSpacing;
100 float m_floorLevel;
101
102 // Rendering
103 Bars3DRenderer *m_renderer;
104
105public:
106 explicit Bars3DController(QRect rect, Q3DScene *scene = 0);
107 ~Bars3DController();
108
109 virtual void initializeOpenGL();
110 virtual void synchDataToRenderer();
111
112 void setMultiSeriesScaling(bool uniform);
113 bool multiSeriesScaling() const;
114
115 // bar thickness, spacing between bars, and is spacing relative to thickness or absolute
116 // y -component sets the thickness/spacing of z -direction
117 // With relative 0.0f means side-to-side, 1.0f = one thickness in between
118 void setBarSpecs(GLfloat thicknessRatio = 1.0f,
119 const QSizeF &spacing = QSizeF(1.0, 1.0),
120 bool relative = true);
121 GLfloat barThickness();
122 QSizeF barSpacing();
123 bool isBarSpecRelative();
124 void setFloorLevel(float level);
125 float floorLevel() const;
126
127 inline QBar3DSeries *selectedSeries() const { return m_selectedBarSeries; }
128
129 void setSelectionMode(QAbstract3DGraph::SelectionFlags mode);
130 void setSelectedBar(const QPoint &position, QBar3DSeries *series, bool enterSlice);
131 virtual void clearSelection();
132
133 virtual void handleAxisAutoAdjustRangeChangedInOrientation(
134 QAbstract3DAxis::AxisOrientation orientation, bool autoAdjust);
135 virtual void handleSeriesVisibilityChangedBySender(QObject *sender);
136 virtual void handlePendingClick();
137
138 static QPoint invalidSelectionPosition();
139
140 virtual void setAxisX(QAbstract3DAxis *axis);
141 virtual void setAxisZ(QAbstract3DAxis *axis);
142
143 virtual void setPrimarySeries(QBar3DSeries *series);
144 virtual QBar3DSeries *primarySeries() const;
145 virtual void addSeries(QAbstract3DSeries *series);
146 virtual void removeSeries(QAbstract3DSeries *series);
147 virtual void insertSeries(int index, QAbstract3DSeries *series);
148 virtual QList<QBar3DSeries *> barSeriesList();
149
150 virtual void handleAxisRangeChangedBySender(QObject *sender);
151 virtual void adjustAxisRanges();
152
153public Q_SLOTS:
154 void handleArrayReset();
155 void handleRowsAdded(int startIndex, int count);
156 void handleRowsChanged(int startIndex, int count);
157 void handleRowsRemoved(int startIndex, int count);
158 void handleRowsInserted(int startIndex, int count);
159 void handleItemChanged(int rowIndex, int columnIndex);
160 void handleDataRowLabelsChanged();
161 void handleDataColumnLabelsChanged();
162
163Q_SIGNALS:
164 void primarySeriesChanged(QBar3DSeries *series);
165 void selectedSeriesChanged(QBar3DSeries *series);
166
167protected:
168 virtual QAbstract3DAxis *createDefaultAxis(QAbstract3DAxis::AxisOrientation orientation);
169
170private:
171 void adjustSelectionPosition(QPoint &pos, const QBar3DSeries *series);
172
173 Q_DISABLE_COPY(Bars3DController)
174};
175
176QT_END_NAMESPACE_DATAVISUALIZATION
177
178#endif
179

source code of qtdatavis3d/src/datavisualization/engine/bars3dcontroller_p.h