1 | /**************************************************************************** |
2 | ** |
3 | ** Copyright (C) 2017 The Qt Company Ltd. |
4 | ** Contact: https://www.qt.io/licensing/ |
5 | ** |
6 | ** This file is part of the Qt Charts 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 | #include "declarativepolarchart_p.h" |
31 | #include <QtCharts/QChart> |
32 | |
33 | QT_CHARTS_BEGIN_NAMESPACE |
34 | |
35 | /*! |
36 | \qmltype PolarChartView |
37 | \inherits ChartView |
38 | \instantiates DeclarativePolarChart |
39 | \inqmlmodule QtCharts |
40 | |
41 | \brief Presents data in polar charts. |
42 | |
43 | Polar charts present data in a circular graph, where the placement of data |
44 | is based on the angle and distance from the center of the graph, the |
45 | \e pole. |
46 | |
47 | \image examples_qmlpolarchart1.png |
48 | |
49 | A polar chart is a specialization of the ChartView type. It supports line, |
50 | spline, area, and scatter series, and all axis types supported by them. Each |
51 | axis can be used either as a radial or an angular axis. |
52 | |
53 | The first and last tick mark on an angular ValueAxis are co-located at a |
54 | 0/360 degree angle. |
55 | |
56 | If the angular distance between two consecutive points in a series is more |
57 | than 180 degrees, any direct line connecting the two points becomes |
58 | meaningless, and will not be drawn. Instead, a line will be drawn to and |
59 | from the center of the chart. Therefore, the axis ranges must be chosen |
60 | accordingly when displaying line, spline, or area series. |
61 | |
62 | Polar charts draw all axes of the same orientation in the same position, so |
63 | using multiple axes of the same orientation can be confusing, unless the |
64 | extra axes are only used to customize the grid. For example, you can display |
65 | a highlighted range with a secondary shaded CategoryAxis or provide |
66 | unlabeled subticks with a secondary ValueAxis thas has hidden labels. |
67 | |
68 | The following QML code shows how to create a polar chart with a spline and |
69 | scatter series and two value axes: |
70 | \snippet qmlpolarchart/qml/qmlpolarchart/View1.qml 1 |
71 | */ |
72 | |
73 | DeclarativePolarChart::DeclarativePolarChart(QQuickItem *parent) |
74 | : DeclarativeChart(QChart::ChartTypePolar, parent) |
75 | { |
76 | } |
77 | |
78 | DeclarativePolarChart::~DeclarativePolarChart() |
79 | { |
80 | } |
81 | |
82 | QT_CHARTS_END_NAMESPACE |
83 | |
84 | #include "moc_declarativepolarchart_p.cpp" |
85 | |