1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
/****************************************************************************
**
** Copyright (C) 2016 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt Charts module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:GPL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3 or (at your option) any later version
** approved by the KDE Free Qt Foundation. The licenses are as published by
** the Free Software Foundation and appearing in the file LICENSE.GPL3
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include <QtCharts/QPolarChart>
#include <QtCharts/QAbstractAxis>
QT_CHARTS_BEGIN_NAMESPACE
/*!
\enum QPolarChart::PolarOrientation
This type is used to specify the polar orientation of an axis.
\value PolarOrientationRadial
\value PolarOrientationAngular
*/
/*!
\class QPolarChart
\inmodule Qt Charts
\brief Polar chart API for Qt Charts.
QPolarChart is a specialization of QChart to show a polar chart.
Polar charts support line, spline, area, and scatter series, and all axis types
supported by those series.
\note When setting ticks to an angular QValueAxis, keep in mind that the first and last tick
are co-located at 0/360 degree angle.
\note If the angular distance between two consecutive points in a series is more than 180 degrees,
any line connecting the two points becomes meaningless, so choose the axis ranges accordingly
when displaying line, spline, or area series. In such case series don't draw a direct line between
the two points, but instead draw a line to and from the center of the chart.
\note Polar charts draw all axes of same orientation in the same position, so using multiple
axes of same orientation can be confusing, unless the extra axes are only used to customize the
grid (e.g. you can display a highlighted range with a secondary shaded QCategoryAxis or provide
unlabeled subticks with a secondary QValueAxis that has its labels hidden).
\sa QChart
*/
/*!
Constructs a polar chart as a child of the \a parent.
Parameter \a wFlags is passed to the QChart constructor.
*/
QPolarChart::QPolarChart(QGraphicsItem *parent, Qt::WindowFlags wFlags)
: QChart(QChart::ChartTypePolar, parent, wFlags)
{
}
/*!
Destroys the polar chart object and its children, like series and axis objects added to it.
*/
QPolarChart::~QPolarChart()
{
}
/*!
Returns the axes added for the \a series with \a polarOrientation. If no series is provided, then any axis with the
specified polar orientation is returned.
\sa addAxis()
*/
QList<QAbstractAxis *> QPolarChart::axes(PolarOrientations polarOrientation, QAbstractSeries *series) const
{
Qt::Orientations orientation(0);
if (polarOrientation.testFlag(PolarOrientationAngular))
orientation |= Qt::Horizontal;
if (polarOrientation.testFlag(PolarOrientationRadial))
orientation |= Qt::Vertical;
return QChart::axes(orientation, series);
}
/*!
This convenience method adds \a axis to the polar chart with \a polarOrientation.
The chart takes the ownership of the axis.
\note Axes can be added to a polar chart also with QChart::addAxis() instead of this method.
The specified alignment determines the polar orientation: horizontal alignments indicate angular
axis and vertical alignments indicate radial axis.
\sa QChart::removeAxis(), QChart::createDefaultAxes(), QAbstractSeries::attachAxis(), QChart::addAxis()
*/
void QPolarChart::addAxis(QAbstractAxis *axis, PolarOrientation polarOrientation)
{
if (!axis || axis->type() == QAbstractAxis::AxisTypeBarCategory) {
qWarning("QAbstractAxis::AxisTypeBarCategory is not a supported axis type for polar charts.");
} else {
Qt::Alignment alignment = Qt::AlignLeft;
if (polarOrientation == PolarOrientationAngular)
alignment = Qt::AlignBottom;
QChart::addAxis(axis, alignment);
}
}
/*!
Angular axes of a polar chart report horizontal orientation and radial axes report
vertical orientation.
This function is a convenience function for converting the orientation of an \a axis to
corresponding polar orientation. If the \a axis is NULL or not added to a polar chart,
the return value is meaningless.
*/
QPolarChart::PolarOrientation QPolarChart::axisPolarOrientation(QAbstractAxis *axis)
{
if (axis && axis->orientation() == Qt::Horizontal)
return PolarOrientationAngular;
else
return PolarOrientationRadial;
}
#include "moc_qpolarchart.cpp"
QT_CHARTS_END_NAMESPACE
|
