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 #ifndef QABSTRACT3DAXIS_H
31 #define QABSTRACT3DAXIS_H
32 
33 #include <QtDataVisualization/qdatavisualizationglobal.h>
34 #include <QtCore/QObject>
35 #include <QtCore/QScopedPointer>
36 #include <QtCore/QStringList>
37 
38 QT_BEGIN_NAMESPACE_DATAVISUALIZATION
39 
40 class QAbstract3DAxisPrivate;
41 
42 class QT_DATAVISUALIZATION_EXPORT QAbstract3DAxis : public QObject
43 {
44     Q_OBJECT
45     Q_ENUMS(AxisOrientation)
46     Q_ENUMS(AxisType)
47     Q_PROPERTY(QString title READ title WRITE setTitle NOTIFY titleChanged)
48     Q_PROPERTY(QStringList labels READ labels WRITE setLabels NOTIFY labelsChanged)
49     Q_PROPERTY(AxisOrientation orientation READ orientation NOTIFY orientationChanged)
50     Q_PROPERTY(AxisType type READ type CONSTANT)
51     Q_PROPERTY(float min READ min WRITE setMin NOTIFY minChanged)
52     Q_PROPERTY(float max READ max WRITE setMax NOTIFY maxChanged)
53     Q_PROPERTY(bool autoAdjustRange READ isAutoAdjustRange WRITE setAutoAdjustRange NOTIFY autoAdjustRangeChanged)
54     Q_PROPERTY(float labelAutoRotation READ labelAutoRotation WRITE setLabelAutoRotation NOTIFY labelAutoRotationChanged REVISION 1)
55     Q_PROPERTY(bool titleVisible READ isTitleVisible WRITE setTitleVisible NOTIFY titleVisibilityChanged REVISION 1)
56     Q_PROPERTY(bool titleFixed READ isTitleFixed WRITE setTitleFixed NOTIFY titleFixedChanged REVISION 1)
57 
58 public:
59     enum AxisOrientation {
60         AxisOrientationNone = 0,
61         AxisOrientationX = 1,
62         AxisOrientationY = 2,
63         AxisOrientationZ = 4
64     };
65 
66     enum AxisType {
67         AxisTypeNone = 0,
68         AxisTypeCategory = 1,
69         AxisTypeValue = 2
70     };
71 
72 protected:
73     explicit QAbstract3DAxis(QAbstract3DAxisPrivate *d, QObject *parent = nullptr);
74 
75 public:
76     virtual ~QAbstract3DAxis();
77 
78     void setTitle(const QString &title);
79     QString title() const;
80 
81     void setLabels(const QStringList &labels);
82     QStringList labels() const;
83 
84     AxisOrientation orientation() const;
85     AxisType type() const;
86 
87     void setMin(float min);
88     float min() const;
89 
90     void setMax(float max);
91     float max() const;
92 
93     void setAutoAdjustRange(bool autoAdjust);
94     bool isAutoAdjustRange() const;
95 
96     void setRange(float min, float max);
97 
98     void setLabelAutoRotation(float angle);
99     float labelAutoRotation() const;
100 
101     void setTitleVisible(bool visible);
102     bool isTitleVisible() const;
103 
104     void setTitleFixed(bool fixed);
105     bool isTitleFixed() const;
106 
107 Q_SIGNALS:
108     void titleChanged(const QString &newTitle);
109     void labelsChanged();
110     void orientationChanged(QAbstract3DAxis::AxisOrientation orientation);
111     void minChanged(float value);
112     void maxChanged(float value);
113     void rangeChanged(float min, float max);
114     void autoAdjustRangeChanged(bool autoAdjust);
115     Q_REVISION(1) void labelAutoRotationChanged(float angle);
116     Q_REVISION(1) void titleVisibilityChanged(bool visible);
117     Q_REVISION(1) void titleFixedChanged(bool fixed);
118 
119 protected:
120     QScopedPointer<QAbstract3DAxisPrivate> d_ptr;
121 
122 private:
123     Q_DISABLE_COPY(QAbstract3DAxis)
124 
125     friend class Abstract3DController;
126     friend class Bars3DController;
127     friend class QScatterDataProxyPrivate;
128     friend class QSurfaceDataProxyPrivate;
129 };
130 
131 QT_END_NAMESPACE_DATAVISUALIZATION
132 
133 #endif
134