qpolarchart.cpp
142 lines
| 5.2 KiB
| text/x-c
|
CppLexer
Miikka Heikkinen
|
r2854 | /**************************************************************************** | ||
Miikka Heikkinen
|
r2483 | ** | ||
|
Miikka Heikkinen
|
r2854 | ** Copyright (C) 2016 The Qt Company Ltd. | ||
| ** Contact: https://www.qt.io/licensing/ | ||||
|
Miikka Heikkinen
|
r2483 | ** | ||
|
Miikka Heikkinen
|
r2854 | ** This file is part of the Qt Charts module of the Qt Toolkit. | ||
|
Miikka Heikkinen
|
r2483 | ** | ||
|
Miikka Heikkinen
|
r2854 | ** $QT_BEGIN_LICENSE:GPL$ | ||
Titta Heikkala
|
r2845 | ** 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 | ||||
|
Miikka Heikkinen
|
r2854 | ** 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. | ||||
|
Miikka Heikkinen
|
r2483 | ** | ||
|
Titta Heikkala
|
r2845 | ** $QT_END_LICENSE$ | ||
| ** | ||||
|
Miikka Heikkinen
|
r2854 | ****************************************************************************/ | ||
|
Miikka Heikkinen
|
r2483 | |||
|
Titta Heikkala
|
r2714 | #include <QtCharts/QPolarChart> | ||
| #include <QtCharts/QAbstractAxis> | ||||
|
Miikka Heikkinen
|
r2483 | |||
Titta Heikkala
|
r2712 | QT_CHARTS_BEGIN_NAMESPACE | ||
|
Miikka Heikkinen
|
r2483 | |||
| /*! | ||||
| \enum QPolarChart::PolarOrientation | ||||
|
Miikka Heikkinen
|
r2494 | This type is used to specify the polar orientation of an axis. | ||
|
Miikka Heikkinen
|
r2483 | |||
| \value PolarOrientationRadial | ||||
| \value PolarOrientationAngular | ||||
| */ | ||||
| /*! | ||||
| \class QPolarChart | ||||
|
Titta Heikkala
|
r2639 | \inmodule Qt Charts | ||
|
Miikka Heikkinen
|
r2591 | \brief Polar chart API for Qt Charts. | ||
|
Miikka Heikkinen
|
r2483 | |||
| 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 | ||||
|
Miikka Heikkinen
|
r2494 | 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. | ||||
|
Miikka Heikkinen
|
r2483 | |||
|
Miikka Heikkinen
|
r2547 | \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). | ||||
|
Miikka Heikkinen
|
r2483 | |||
| \sa QChart | ||||
| */ | ||||
| /*! | ||||
|
Miikka Heikkinen
|
r2494 | Constructs a polar chart as a child of the \a parent. | ||
|
Miikka Heikkinen
|
r2483 | Parameter \a wFlags is passed to the QChart constructor. | ||
| */ | ||||
| QPolarChart::QPolarChart(QGraphicsItem *parent, Qt::WindowFlags wFlags) | ||||
| : QChart(QChart::ChartTypePolar, parent, wFlags) | ||||
| { | ||||
| } | ||||
| /*! | ||||
|
Miikka Heikkinen
|
r2494 | Destroys the polar chart object and its children, like series and axis objects added to it. | ||
|
Miikka Heikkinen
|
r2483 | */ | ||
| 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. | ||||
|
Miikka Heikkinen
|
r2494 | |||
|
Miikka Heikkinen
|
r2483 | \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. | ||||
|
Miikka Heikkinen
|
r2494 | |||
|
Miikka Heikkinen
|
r2483 | \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" | ||||
|
Titta Heikkala
|
r2712 | QT_CHARTS_END_NAMESPACE | ||