diff options
Diffstat (limited to 'src/charts/xychart/qxyseries.cpp')
-rw-r--r-- | src/charts/xychart/qxyseries.cpp | 801 |
1 files changed, 801 insertions, 0 deletions
diff --git a/src/charts/xychart/qxyseries.cpp b/src/charts/xychart/qxyseries.cpp new file mode 100644 index 00000000..6805a1c7 --- /dev/null +++ b/src/charts/xychart/qxyseries.cpp @@ -0,0 +1,801 @@ +/**************************************************************************** +** +** Copyright (C) 2014 Digia Plc +** All rights reserved. +** For any questions to Digia, please use contact form at http://qt.digia.com +** +** This file is part of the Qt Enterprise Charts Add-on. +** +** $QT_BEGIN_LICENSE$ +** Licensees holding valid Qt Enterprise licenses may use this file in +** accordance with the Qt Enterprise License Agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. +** +** If you have questions regarding the use of this file, please use +** contact form at http://qt.digia.com +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#include "qxyseries.h" +#include "qxyseries_p.h" +#include "abstractdomain_p.h" +#include "qvalueaxis.h" +#include "xychart_p.h" +#include "qxylegendmarker.h" +#include "charthelpers_p.h" +#include "qchart_p.h" +#include <QPainter> + +QT_CHARTS_BEGIN_NAMESPACE + +/*! + \class QXYSeries + \inmodule Qt Charts + \brief The QXYSeries class is a base class for line, spline and scatter series. +*/ +/*! + \qmltype XYSeries + \instantiates QXYSeries + \inqmlmodule QtCharts + + \inherits AbstractSeries + + \brief The XYSeries type is a base type for line, spline and scatter series. + + The XYSeries class is a base class for line, spline and scatter series. + The class cannot be instantiated directly. +*/ + +/*! + \qmlproperty AbstractAxis XYSeries::axisX + The x axis used for the series. If you leave both axisX and axisXTop undefined, a ValueAxis is created for + the series. + \sa axisXTop +*/ + +/*! + \qmlproperty AbstractAxis XYSeries::axisY + The y axis used for the series. If you leave both axisY and axisYRight undefined, a ValueAxis is created for + the series. + \sa axisYRight +*/ + +/*! + \qmlproperty AbstractAxis XYSeries::axisXTop + The x axis used for the series, drawn on top of the chart view. Note that you can only provide either axisX or + axisXTop, but not both. + \sa axisX +*/ + +/*! + \qmlproperty AbstractAxis XYSeries::axisYRight + The y axis used for the series, drawn to the right on the chart view. Note that you can only provide either axisY + or axisYRight, but not both. + \sa axisY +*/ + +/*! + \qmlproperty AbstractAxis XYSeries::axisAngular + The angular axis used for the series, drawn around the polar chart view. + \sa axisX +*/ + +/*! + \qmlproperty AbstractAxis XYSeries::axisRadial + The radial axis used for the series, drawn inside the polar chart view. + \sa axisY +*/ + +/*! + \property QXYSeries::pointsVisible + Controls if the data points are visible and should be drawn. +*/ +/*! + \qmlproperty bool XYSeries::pointsVisible + Controls if the data points are visible and should be drawn. +*/ + +/*! + \fn QPen QXYSeries::pen() const + \brief Returns pen used to draw points for series. + \sa setPen() +*/ + +/*! + \fn QBrush QXYSeries::brush() const + \brief Returns brush used to draw points for series. + \sa setBrush() +*/ + +/*! + \property QXYSeries::color + The color of the series. This is line (pen) color in case of QLineSeries or QSplineSeries and + fill (brush) color in case of QScatterSeries or QAreaSeries. + \sa QXYSeries::pen(), QXYSeries::brush() +*/ +/*! + \qmlproperty color XYSeries::color + The color of the series. This is line (pen) color in case of LineSeries or SplineSeries and + fill (brush) color in case of ScatterSeries or AreaSeries. +*/ + +/*! + \property QXYSeries::pointLabelsFormat + The \a format used for showing labels with series points. + + QXYSeries supports the following format tags: + \table + \row + \li @xPoint \li The x value of the data point + \row + \li @yPoint \li The y value of the data point + \endtable + + For example, the following usage of the format tags would produce labels that have the data + point (x, y) shown inside brackets separated by a comma: + \code + series->setPointLabelsFormat("(@xPoint, @yPoint)"); + \endcode + + By default, the labels format is set to '@xPoint, @yPoint'. The labels are shown on the plot + area, labels on the edge of the plot area are cut. If the points are close to each other the + labels may overlap. + + \sa QXYSeries::pointLabelsVisible, QXYSeries::pointLabelsFont, QXYSeries::pointLabelsColor +*/ +/*! + \qmlproperty string XYSeries::pointLabelsFormat + The \a format used for showing labels with series points. + + \sa QXYSeries::pointLabelsFormat, pointLabelsVisible, pointLabelsFont, pointLabelsColor +*/ +/*! + \fn void QXYSeries::pointLabelsFormatChanged(const QString &format) + Signal is emitted when the \a format of data point labels is changed. +*/ +/*! + \qmlsignal XYSeries::onPointLabelsFormatChanged(string format) + Signal is emitted when the \a format of data point labels is changed. +*/ + +/*! + \property QXYSeries::pointLabelsVisible + Defines the visibility for data point labels. False by default. + + \sa QXYSeries::pointLabelsFormat +*/ +/*! + \qmlproperty bool XYSeries::pointLabelsVisible + Defines the visibility for data point labels. + + \sa pointLabelsFormat +*/ +/*! + \fn void QXYSeries::pointLabelsVisibilityChanged(bool visible) + The visibility of the data point labels is changed to \a visible. +*/ +/*! + \qmlsignal XYSeries::onPointLabelsVisibilityChanged(bool visible) + The visibility of the data point labels is changed to \a visible. +*/ + +/*! + \property QXYSeries::pointLabelsFont + Defines the font used for data point labels. + + \sa QXYSeries::pointLabelsFormat +*/ +/*! + \qmlproperty font XYSeries::pointLabelsFont + Defines the font used for data point labels. + + \sa pointLabelsFormat +*/ +/*! + \fn void QXYSeries::pointLabelsFontChanged(const QFont &font); + The font used for data point labels is changed to \a font. +*/ +/*! + \qmlsignal XYSeries::onPointLabelsFontChanged(Font font) + The font used for data point labels is changed to \a font. +*/ + +/*! + \property QXYSeries::pointLabelsColor + Defines the color used for data point labels. By default, the color is the color of the brush + defined in theme for labels. + + \sa QXYSeries::pointLabelsFormat +*/ +/*! + \qmlproperty font XYSeries::pointLabelsColor + Defines the color used for data point labels. By default, the color is the color of the brush + defined in theme for labels. + + \sa pointLabelsFormat +*/ +/*! + \fn void QXYSeries::pointLabelsColorChanged(const QColor &color); + The color used for data point labels is changed to \a color. +*/ +/*! + \qmlsignal XYSeries::onPointLabelsColorChanged(Color color) + The color used for data point labels is changed to \a color. +*/ + +/*! + \fn void QXYSeries::clicked(const QPointF& point) + \brief Signal is emitted when user clicks the \a point on chart. +*/ +/*! + \qmlsignal XYSeries::onClicked(QPointF point) + Signal is emitted when user clicks the \a point on chart. For example: + \code + LineSeries { + XYPoint { x: 0; y: 0 } + XYPoint { x: 1.1; y: 2.1 } + onClicked: console.log("onClicked: " + point.x + ", " + point.y); + } + \endcode +*/ + +/*! + \fn void QXYSeries::hovered(const QPointF &point, bool state) + This signal is emitted when user has hovered over or away from the series. \a point shows the origin (coordinate) + of the hover event. \a state is true when user has hovered over the series and false when hover has moved away from + the series. +*/ +/*! + \qmlsignal XYSeries::onHovered(point point, bool state) + This signal is emitted when user has hovered over or away from the series. \a point shows the origin (coordinate) + of the hover event. \a state is true when user has hovered over the series and false when hover has moved away from + the series. +*/ + +/*! + \fn void QXYSeries::pointReplaced(int index) + Signal is emitted when a point has been replaced at \a index. + \sa replace() +*/ +/*! + \qmlsignal XYSeries::onPointReplaced(int index) + Signal is emitted when a point has been replaced at \a index. +*/ + +/*! + \fn void QXYSeries::pointsReplaced() + Signal is emitted when all points have been replaced with other points. + \sa replace() +*/ +/*! + \qmlsignal XYSeries::onPointsReplaced() +*/ + +/*! + \fn void QXYSeries::pointAdded(int index) + Signal is emitted when a point has been added at \a index. + \sa append(), insert() +*/ +/*! + \qmlsignal XYSeries::onPointAdded(int index) + Signal is emitted when a point has been added at \a index. +*/ + +/*! + \fn void QXYSeries::pointRemoved(int index) + Signal is emitted when a point has been removed from \a index. + \sa remove() +*/ +/*! + \qmlsignal XYSeries::onPointRemoved(int index) + Signal is emitted when a point has been removed from \a index. +*/ + +/*! + \fn void QXYSeries::colorChanged(QColor color) + \brief Signal is emitted when the line (pen) color has changed to \a color. +*/ +/*! + \qmlsignal XYSeries::onColorChanged(color color) + Signal is emitted when the line (pen) color has changed to \a color. +*/ + +/*! + \fn void QXYSeriesPrivate::updated() + \brief \internal +*/ + +/*! + \qmlmethod XYSeries::append(real x, real y) + Append point (\a x, \a y) to the series +*/ + +/*! + \qmlmethod XYSeries::replace(real oldX, real oldY, real newX, real newY) + Replaces point (\a oldX, \a oldY) with point (\a newX, \a newY). Does nothing, if point (oldX, oldY) does not + exist. +*/ + +/*! + \qmlmethod XYSeries::remove(real x, real y) + Removes point (\a x, \a y) from the series. Does nothing, if point (x, y) does not exist. +*/ + +/*! + \qmlmethod XYSeries::insert(int index, real x, real y) + Inserts point (\a x, \a y) to the \a index. If index is 0 or smaller than 0 the point is prepended to the list of + points. If index is the same as or bigger than count, the point is appended to the list of points. +*/ + +/*! + \qmlmethod QPointF XYSeries::at(int index) + Returns point at \a index. Returns (0, 0) if the index is not valid. +*/ + +/*! + \internal + + Constructs empty series object which is a child of \a parent. + When series object is added to QChart instance ownerships is transferred. +*/ +QXYSeries::QXYSeries(QXYSeriesPrivate &d, QObject *parent) + : QAbstractSeries(d, parent) +{ +} + +/*! + Destroys the object. Series added to QChart instances are owned by those, + and are destroyed when QChart instances are destroyed. +*/ +QXYSeries::~QXYSeries() +{ +} + +/*! + Adds data point (\a x, \a y) to the series. + */ +void QXYSeries::append(qreal x, qreal y) +{ + append(QPointF(x, y)); +} + +/*! + This is an overloaded function. + Adds data \a point to the series. + */ +void QXYSeries::append(const QPointF &point) +{ + Q_D(QXYSeries); + + if (isValidValue(point)) { + d->m_points << point; + emit pointAdded(d->m_points.count() - 1); + } +} + +/*! + This is an overloaded function. + Adds list of data \a points to the series. + */ +void QXYSeries::append(const QList<QPointF> &points) +{ + foreach (const QPointF &point , points) + append(point); +} + +/*! + Replaces data point (\a oldX, \a oldY) with data point (\a newX, \a newY). + \sa QXYSeries::pointReplaced() +*/ +void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY) +{ + replace(QPointF(oldX, oldY), QPointF(newX, newY)); +} + +/*! + Replaces \a oldPoint with \a newPoint. + \sa QXYSeries::pointReplaced() +*/ +void QXYSeries::replace(const QPointF &oldPoint, const QPointF &newPoint) +{ + Q_D(QXYSeries); + int index = d->m_points.indexOf(oldPoint); + if (index == -1) + return; + replace(index, newPoint); +} + +/*! + Replaces the point at \a index with data point (\a newX, \a newY). + \sa QXYSeries::pointReplaced() +*/ +void QXYSeries::replace(int index, qreal newX, qreal newY) +{ + replace(index, QPointF(newX, newY)); +} + +/*! + Replaces the point at \a index with \a newPoint. + \sa QXYSeries::pointReplaced() +*/ +void QXYSeries::replace(int index, const QPointF &newPoint) +{ + Q_D(QXYSeries); + if (isValidValue(newPoint)) { + d->m_points[index] = newPoint; + emit pointReplaced(index); + } +} + +/*! + Replaces the current points with \a points. + \note This is much faster than replacing data points one by one, + or first clearing all data, and then appending the new data. Emits QXYSeries::pointsReplaced() + when the points have been replaced. + \sa QXYSeries::pointsReplaced() +*/ +void QXYSeries::replace(QList<QPointF> points) +{ + Q_D(QXYSeries); + d->m_points = points.toVector(); + emit pointsReplaced(); +} + +/*! + Removes the point (\a x, \a y) from the series. +*/ +void QXYSeries::remove(qreal x, qreal y) +{ + remove(QPointF(x, y)); +} + +/*! + Removes the \a point from the series. +*/ +void QXYSeries::remove(const QPointF &point) +{ + Q_D(QXYSeries); + int index = d->m_points.indexOf(point); + if (index == -1) + return; + remove(index); +} + +/*! + Removes the point at \a index from the series. +*/ +void QXYSeries::remove(int index) +{ + Q_D(QXYSeries); + d->m_points.remove(index); + emit pointRemoved(index); +} + +/*! + Inserts a \a point in the series at \a index position. +*/ +void QXYSeries::insert(int index, const QPointF &point) +{ + Q_D(QXYSeries); + if (isValidValue(point)) { + d->m_points.insert(index, point); + emit pointAdded(index); + } +} + +/*! + Removes all points from the series. +*/ +void QXYSeries::clear() +{ + Q_D(QXYSeries); + for (int i = d->m_points.size() - 1; i >= 0; i--) + remove(d->m_points.at(i)); +} + +/*! + Returns list of points in the series. +*/ +QList<QPointF> QXYSeries::points() const +{ + Q_D(const QXYSeries); + return d->m_points.toList(); +} + +/*! + Returns point at \a index in internal points vector. +*/ +const QPointF &QXYSeries::at(int index) const +{ + Q_D(const QXYSeries); + return d->m_points.at(index); +} + +/*! + Returns number of data points within series. +*/ +int QXYSeries::count() const +{ + Q_D(const QXYSeries); + return d->m_points.count(); +} + + +/*! + Sets \a pen used for drawing points on the chart. If the pen is not defined, the + pen from chart theme is used. + \sa QChart::setTheme() +*/ +void QXYSeries::setPen(const QPen &pen) +{ + Q_D(QXYSeries); + if (d->m_pen != pen) { + bool emitColorChanged = d->m_pen.color() != pen.color(); + d->m_pen = pen; + emit d->updated(); + if (emitColorChanged) + emit colorChanged(pen.color()); + } +} + +QPen QXYSeries::pen() const +{ + Q_D(const QXYSeries); + if (d->m_pen == QChartPrivate::defaultPen()) + return QPen(); + else + return d->m_pen; +} + +/*! + Sets \a brush used for drawing points on the chart. If the brush is not defined, brush + from chart theme setting is used. + \sa QChart::setTheme() +*/ +void QXYSeries::setBrush(const QBrush &brush) +{ + Q_D(QXYSeries); + if (d->m_brush != brush) { + d->m_brush = brush; + emit d->updated(); + } +} + +QBrush QXYSeries::brush() const +{ + Q_D(const QXYSeries); + if (d->m_brush == QChartPrivate::defaultBrush()) + return QBrush(); + else + return d->m_brush; +} + +void QXYSeries::setColor(const QColor &color) +{ + QPen p = pen(); + if (p.color() != color) { + p.setColor(color); + setPen(p); + } +} + +QColor QXYSeries::color() const +{ + return pen().color(); +} + +void QXYSeries::setPointsVisible(bool visible) +{ + Q_D(QXYSeries); + if (d->m_pointsVisible != visible) { + d->m_pointsVisible = visible; + emit d->updated(); + } +} + +bool QXYSeries::pointsVisible() const +{ + Q_D(const QXYSeries); + return d->m_pointsVisible; +} + +void QXYSeries::setPointLabelsFormat(const QString &format) +{ + Q_D(QXYSeries); + if (d->m_pointLabelsFormat != format) { + d->m_pointLabelsFormat = format; + emit pointLabelsFormatChanged(format); + } +} + +QString QXYSeries::pointLabelsFormat() const +{ + Q_D(const QXYSeries); + return d->m_pointLabelsFormat; +} + +void QXYSeries::setPointLabelsVisible(bool visible) +{ + Q_D(QXYSeries); + if (d->m_pointLabelsVisible != visible) { + d->m_pointLabelsVisible = visible; + emit pointLabelsVisibilityChanged(visible); + } +} + +bool QXYSeries::pointLabelsVisible() const +{ + Q_D(const QXYSeries); + return d->m_pointLabelsVisible; +} + +void QXYSeries::setPointLabelsFont(const QFont &font) +{ + Q_D(QXYSeries); + if (d->m_pointLabelsFont != font) { + d->m_pointLabelsFont = font; + emit pointLabelsFontChanged(font); + } +} + +QFont QXYSeries::pointLabelsFont() const +{ + Q_D(const QXYSeries); + return d->m_pointLabelsFont; +} + +void QXYSeries::setPointLabelsColor(const QColor &color) +{ + Q_D(QXYSeries); + if (d->m_pointLabelsColor != color) { + d->m_pointLabelsColor = color; + emit pointLabelsColorChanged(color); + } +} + +QColor QXYSeries::pointLabelsColor() const +{ + Q_D(const QXYSeries); + if (d->m_pointLabelsColor == QChartPrivate::defaultPen().color()) + return QPen().color(); + else + return d->m_pointLabelsColor; +} + +/*! + Stream operator for adding a data \a point to the series. + \sa append() +*/ +QXYSeries &QXYSeries::operator<< (const QPointF &point) +{ + append(point); + return *this; +} + + +/*! + Stream operator for adding a list of \a points to the series. + \sa append() +*/ + +QXYSeries &QXYSeries::operator<< (const QList<QPointF>& points) +{ + append(points); + return *this; +} + +////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// + + +QXYSeriesPrivate::QXYSeriesPrivate(QXYSeries *q) + : QAbstractSeriesPrivate(q), + m_pen(QChartPrivate::defaultPen()), + m_brush(QChartPrivate::defaultBrush()), + m_pointsVisible(false), + m_pointLabelsFormat(QLatin1String("@xPoint, @yPoint")), + m_pointLabelsVisible(false), + m_pointLabelsFont(QChartPrivate::defaultFont()), + m_pointLabelsColor(QChartPrivate::defaultPen().color()) +{ +} + +void QXYSeriesPrivate::initializeDomain() +{ + qreal minX(0); + qreal minY(0); + qreal maxX(1); + qreal maxY(1); + + Q_Q(QXYSeries); + + const QList<QPointF>& points = q->points(); + + if (!points.isEmpty()) { + minX = points[0].x(); + minY = points[0].y(); + maxX = minX; + maxY = minY; + + for (int i = 0; i < points.count(); i++) { + qreal x = points[i].x(); + qreal y = points[i].y(); + minX = qMin(minX, x); + minY = qMin(minY, y); + maxX = qMax(maxX, x); + maxY = qMax(maxY, y); + } + } + + domain()->setRange(minX, maxX, minY, maxY); +} + +QList<QLegendMarker*> QXYSeriesPrivate::createLegendMarkers(QLegend* legend) +{ + Q_Q(QXYSeries); + QList<QLegendMarker*> list; + return list << new QXYLegendMarker(q,legend); +} + +void QXYSeriesPrivate::initializeAxes() +{ + +} + +QAbstractAxis::AxisType QXYSeriesPrivate::defaultAxisType(Qt::Orientation orientation) const +{ + Q_UNUSED(orientation); + return QAbstractAxis::AxisTypeValue; +} + +QAbstractAxis* QXYSeriesPrivate::createDefaultAxis(Qt::Orientation orientation) const +{ + Q_UNUSED(orientation); + return new QValueAxis; +} + +void QXYSeriesPrivate::initializeAnimations(QtCharts::QChart::AnimationOptions options) +{ + XYChart *item = static_cast<XYChart *>(m_item.data()); + Q_ASSERT(item); + if (item->animation()) + item->animation()->stopAndDestroyLater(); + + if (options.testFlag(QChart::SeriesAnimations)) + item->setAnimation(new XYAnimation(item)); + else + item->setAnimation(0); + QAbstractSeriesPrivate::initializeAnimations(options); +} + +void QXYSeriesPrivate::drawSeriesPointLabels(QPainter *painter, const QVector<QPointF> &points, + const int offset) +{ + static const QString xPointTag(QLatin1String("@xPoint")); + static const QString yPointTag(QLatin1String("@yPoint")); + const int labelOffset = offset + 2; + + painter->setFont(m_pointLabelsFont); + painter->setPen(QPen(m_pointLabelsColor)); + QFontMetrics fm(painter->font()); + + for (int i(0); i < m_points.size(); i++) { + QString pointLabel = m_pointLabelsFormat; + pointLabel.replace(xPointTag, presenter()->numberToString(m_points.at(i).x())); + pointLabel.replace(yPointTag, presenter()->numberToString(m_points.at(i).y())); + + // Position text in relation to the point + int pointLabelWidth = fm.width(pointLabel); + QPointF position(points.at(i)); + position.setX(position.x() - pointLabelWidth / 2); + position.setY(position.y() - labelOffset); + + painter->drawText(position, pointLabel); + } +} + +#include "moc_qxyseries.cpp" +#include "moc_qxyseries_p.cpp" + +QT_CHARTS_END_NAMESPACE |