1// Copyright (C) 2025 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 QQUICKGRAPHSBARSNODE_P_H
15#define QQUICKGRAPHSBARSNODE_P_H
16
17#include "qbar3dseries.h"
18#include "qquickgraphsbars_p.h"
19#include "qquickgraphsnode_p.h"
20
21#include <private/qgraphsglobal_p.h>
22
23QT_BEGIN_NAMESPACE
24
25class QQuickGraphsBarsNode;
26
27class Q_GRAPHS_EXPORT QQuickGraphsBarsNode : public QQuickGraphsNode
28{
29 Q_OBJECT
30 Q_PROPERTY(QCategory3DAxis *rowAxis READ rowAxis WRITE setRowAxis NOTIFY rowAxisChanged)
31 Q_PROPERTY(QValue3DAxis *valueAxis READ valueAxis WRITE setValueAxis NOTIFY valueAxisChanged)
32 Q_PROPERTY(
33 QCategory3DAxis *columnAxis READ columnAxis WRITE setColumnAxis NOTIFY columnAxisChanged)
34 Q_PROPERTY(bool multiSeriesUniform READ isMultiSeriesUniform WRITE setMultiSeriesUniform NOTIFY
35 multiSeriesUniformChanged)
36 Q_PROPERTY(float barThickness READ barThickness WRITE setBarThickness NOTIFY barThicknessChanged)
37 Q_PROPERTY(QSizeF barSpacing READ barSpacing WRITE setBarSpacing NOTIFY barSpacingChanged)
38 Q_PROPERTY(bool barSpacingRelative READ isBarSpacingRelative WRITE setBarSpacingRelative NOTIFY
39 barSpacingRelativeChanged)
40 Q_PROPERTY(QSizeF barSeriesMargin READ barSeriesMargin WRITE setBarSeriesMargin NOTIFY
41 barSeriesMarginChanged)
42 Q_PROPERTY(QQmlListProperty<QBar3DSeries> seriesList READ seriesList CONSTANT)
43 Q_PROPERTY(QBar3DSeries *selectedSeries READ selectedSeries NOTIFY selectedSeriesChanged)
44 Q_PROPERTY(QBar3DSeries *primarySeries READ primarySeries WRITE setPrimarySeries NOTIFY
45 primarySeriesChanged)
46 Q_PROPERTY(float floorLevel READ floorLevel WRITE setFloorLevel NOTIFY floorLevelChanged)
47 Q_CLASSINFO("DefaultProperty", "seriesList")
48
49 QML_ADDED_IN_VERSION(6, 10)
50 QML_NAMED_ELEMENT(Bars3DNode)
51
52public:
53 explicit QQuickGraphsBarsNode(QQuick3DNode *parent = nullptr);
54 ~QQuickGraphsBarsNode() override;
55
56 void setRowAxis(QCategory3DAxis *axis);
57 QCategory3DAxis *rowAxis() const;
58 void setValueAxis(QValue3DAxis *axis);
59 QValue3DAxis *valueAxis() const;
60 void setColumnAxis(QCategory3DAxis *axis);
61 QCategory3DAxis *columnAxis() const;
62
63 void setMultiSeriesUniform(bool uniform);
64 bool isMultiSeriesUniform() const;
65
66 void setBarThickness(float thickness);
67 float barThickness() const;
68
69 void setBarSpacing(QSizeF spacing);
70 QSizeF barSpacing() const;
71
72 void setBarSpacingRelative(bool relative);
73 bool isBarSpacingRelative() const;
74
75 void setBarSeriesMargin(QSizeF margin);
76 QSizeF barSeriesMargin() const;
77
78 QBar3DSeries *selectedSeries() const;
79
80 void setPrimarySeries(QBar3DSeries *series);
81 QBar3DSeries *primarySeries() const;
82
83 void setFloorLevel(float floorLevel);
84 float floorLevel() const;
85
86 QList<QBar3DSeries *> barSeriesList();
87 QQmlListProperty<QBar3DSeries> seriesList();
88 static void appendSeriesFunc(QQmlListProperty<QBar3DSeries> *list, QBar3DSeries *series);
89 static qsizetype countSeriesFunc(QQmlListProperty<QBar3DSeries> *list);
90 static QBar3DSeries *atSeriesFunc(QQmlListProperty<QBar3DSeries> *list, qsizetype index);
91 static void clearSeriesFunc(QQmlListProperty<QBar3DSeries> *list);
92
93 Q_INVOKABLE void addSeries(QBar3DSeries *series);
94 Q_INVOKABLE void removeSeries(QBar3DSeries *series);
95 Q_INVOKABLE void insertSeries(qsizetype index, QBar3DSeries *series);
96 Q_INVOKABLE void clearSelection() override;
97
98
99 Q_INVOKABLE bool doPicking(QPointF point) override;
100 Q_INVOKABLE bool doRayPicking(const QVector3D &origin, const QVector3D &direction) override;
101
102protected:
103 void componentComplete() override;
104
105Q_SIGNALS:
106 void rowAxisChanged(QCategory3DAxis *axis);
107 void valueAxisChanged(QValue3DAxis *axis);
108 void columnAxisChanged(QCategory3DAxis *axis);
109 void multiSeriesUniformChanged(bool uniform);
110 void barThicknessChanged(float thicknessRatio);
111 void barSpacingChanged(QSizeF spacing);
112 void barSpacingRelativeChanged(bool relative);
113 void barSeriesMarginChanged(QSizeF margin);
114 void primarySeriesChanged(QBar3DSeries *series);
115 void selectedSeriesChanged(QBar3DSeries *series);
116 void floorLevelChanged(float level);
117
118private:
119 QQuickGraphsBars *graphBars();
120 const QQuickGraphsBars *graphBars() const;
121
122 bool m_multiSeriesUniform;
123 QSizeF m_barSpacing;
124 float m_barThickness;
125 bool m_barSpacingRelative;
126 QSizeF m_barSeriesMargin;
127 QBar3DSeries *m_primarySeries = nullptr;
128 QBar3DSeries *m_selectedSeries = nullptr;
129 float m_floorLevel;
130};
131
132QT_END_NAMESPACE
133
134#endif // QQUICKGRAPHSBARSNODE_P_H
135

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