qareaseries.cpp
385 lines
| 10.5 KiB
| text/x-c
|
CppLexer
Jani Honkonen
|
r794 | /**************************************************************************** | ||
| ** | ||||
| ** Copyright (C) 2012 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 Commercial Charts Add-on. | ||||
| ** | ||||
| ** $QT_BEGIN_LICENSE$ | ||||
| ** Licensees holding valid Qt Commercial licenses may use this file in | ||||
| ** accordance with the Qt Commercial 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$ | ||||
| ** | ||||
| ****************************************************************************/ | ||||
Michal Klocek
|
r421 | #include "qareaseries.h" | ||
|
Michal Klocek
|
r938 | #include "qareaseries_p.h" | ||
|
Michal Klocek
|
r421 | #include "qlineseries.h" | ||
|
Michal Klocek
|
r943 | #include "areachartitem_p.h" | ||
|
Michal Klocek
|
r950 | #include "legendmarker_p.h" | ||
|
Michal Klocek
|
r943 | #include "domain_p.h" | ||
| #include "chartdataset_p.h" | ||||
| #include "charttheme_p.h" | ||||
| #include "chartanimator_p.h" | ||||
|
Michal Klocek
|
r421 | |||
| QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||||
| /*! | ||||
| \class QAreaSeries | ||||
| \brief The QAreaSeries class is used for making area charts. | ||||
| \mainclass | ||||
| An area chart is used to show quantitative data. It is based on line chart, in the way that area between axis and the line | ||||
| is emphasized with color. Since the area chart is based on line chart, QAreaSeries constructor needs QLineSeries instance, | ||||
|
Michal Klocek
|
r424 | which defines "upper" boundary of the area. "Lower" boundary is defined by default by axis X. Instead of axis X "lower" boundary can be specified by other line. | ||
|
Michal Klocek
|
r421 | In that case QAreaSeries should be initiated with two QLineSerie instances. Please note terms "upper" and "lower" boundary can be misleading in cases | ||
|
Michal Klocek
|
r424 | where "lower" boundary had bigger values than the "upper" one, however the main point that area between these two boundary lines will be filled. | ||
|
Michal Klocek
|
r421 | |||
Tero Ahola
|
r995 | See the \l {AreaChart Example} {area chart example} to learn how to create a simple area chart. | ||
| \image examples_areachart.png | ||||
|
Michal Klocek
|
r421 | */ | ||
|
Tero Ahola
|
r1491 | /*! | ||
| \qmlclass AreaSeries QAreaSeries | ||||
| The following QML shows how to create a simple area chart: | ||||
| \snippet ../demos/qmlchart/qml/qmlchart/View4.qml 1 | ||||
| \beginfloatleft | ||||
| \image demos_qmlchart4.png | ||||
| \endfloat | ||||
| \clearfloat | ||||
| */ | ||||
|
Michal Klocek
|
r421 | |||
| /*! | ||||
|
Tero Ahola
|
r1462 | \property QAreaSeries::upperSeries | ||
| \brief The upper one of the two line series used to define area series boundaries. | ||||
|
Michal Klocek
|
r421 | */ | ||
|
Tero Ahola
|
r1491 | /*! | ||
| \qmlproperty LineSeries AreaSeries::upperSeries | ||||
| The upper one of the two line series used to define area series boundaries. | ||||
| */ | ||||
|
Michal Klocek
|
r421 | |||
| /*! | ||||
|
Tero Ahola
|
r1462 | \property QAreaSeries::lowerSeries | ||
| The lower one of the two line series used to define are series boundaries. Note if | ||||
| QAreaSeries was counstucted wihtout a\ lowerSeries this is null. | ||||
|
Michal Klocek
|
r421 | */ | ||
|
Tero Ahola
|
r1491 | /*! | ||
| \qmlproperty LineSeries AreaSeries::lowerSeries | ||||
| The lower one of the two line series used to define are series boundaries. Note if | ||||
| AreaSeries was counstucted wihtout a\ lowerSeries this is null. | ||||
| */ | ||||
|
Michal Klocek
|
r421 | |||
|
Tero Ahola
|
r1481 | /*! | ||
| \property QAreaSeries::color | ||||
| Fill (brush) color of the series. This is a convenience property for modifying the color of brush. | ||||
| \sa QAreaSeries::brush() | ||||
| */ | ||||
|
Tero Ahola
|
r1491 | /*! | ||
| \qmlproperty color AreaSeries::color | ||||
| Fill (brush) color of the series. | ||||
| */ | ||||
|
Tero Ahola
|
r1481 | |||
| /*! | ||||
| \property QAreaSeries::borderColor | ||||
| Line (pen) color of the series. This is a convenience property for modifying the color of pen. | ||||
| \sa QAreaSeries::pen() | ||||
| */ | ||||
|
Tero Ahola
|
r1491 | /*! | ||
| \qmlproperty color AreaSeries::borderColor | ||||
| Line (pen) color of the series. | ||||
| */ | ||||
|
Tero Ahola
|
r1481 | |||
|
Michal Klocek
|
r421 | /*! | ||
| \fn QPen QAreaSeries::pen() const | ||||
| \brief Returns the pen used to draw line for this series. | ||||
| \sa setPen() | ||||
| */ | ||||
| /*! | ||||
| \fn QPen QAreaSeries::brush() const | ||||
| \brief Returns the brush used to draw line for this series. | ||||
| \sa setBrush() | ||||
| */ | ||||
|
Tero Ahola
|
r1481 | /*! | ||
| \fn void QAreaSeries::colorChanged(QColor color) | ||||
| \brief Signal is emitted when the fill (brush) color has changed to \a color. | ||||
| */ | ||||
|
Tero Ahola
|
r1491 | /*! | ||
| \qmlsignal AreaSeries::colorChanged(color color) | ||||
| Signal is emitted when the fill (brush) color has changed to \a color. | ||||
| */ | ||||
|
Tero Ahola
|
r1481 | |||
| /*! | ||||
| \fn void QAreaSeries::borderColorChanged(QColor color) | ||||
| \brief Signal is emitted when the line (pen) color has changed to \a color. | ||||
| */ | ||||
|
Michal Klocek
|
r421 | /*! | ||
|
Tero Ahola
|
r1491 | \qmlsignal AreaSeries::borderColorChanged(color color) | ||
| Signal is emitted when the line (pen) color has changed to \a color. | ||||
|
Michal Klocek
|
r421 | */ | ||
|
Michal Klocek
|
r574 | /*! | ||
| \fn void QAreaSeries::clicked(const QPointF& point) | ||||
| \brief Signal is emitted when user clicks the \a point on area chart. | ||||
| */ | ||||
|
Tero Ahola
|
r1491 | /*! | ||
| \qmlsignal AreaSeries::clicked(QPointF point) | ||||
| Signal is emitted when user clicks the \a point on area chart. | ||||
| */ | ||||
|
Michal Klocek
|
r574 | |||
|
Tero Ahola
|
r973 | /*! | ||
| \fn void QAreaSeries::selected() | ||||
| The signal is emitted if the user selects/deselects the XY series. The logic for maintaining selections should be | ||||
| implemented by the user of QAreaSeries API. | ||||
| */ | ||||
|
Tero Ahola
|
r1491 | /*! | ||
| \qmlsignal AreaSeries::selected() | ||||
| The signal is emitted if the user selects/deselects the XY series. The logic for maintaining selections should be | ||||
| implemented by the user of AreaSeries API. | ||||
| */ | ||||
|
Tero Ahola
|
r973 | |||
|
Michal Klocek
|
r421 | /*! | ||
Marek Rosa
|
r940 | \fn void QAreaSeriesPrivate::updated() | ||
|
Michal Klocek
|
r421 | \brief \internal | ||
| */ | ||||
| /*! | ||||
| Constructs area series object which is a child of \a upperSeries. Area will be spanned between \a | ||||
| upperSeries line and \a lowerSeries line. If no \a lowerSeries is passed to constructor, area is specified by axis x (y=0) instead. | ||||
|
Michal Klocek
|
r974 | When series object is added to QChartView or QChart instance ownerships is transferred. | ||
|
Michal Klocek
|
r421 | */ | ||
|
Tero Ahola
|
r761 | QAreaSeries::QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries) | ||
|
Tero Ahola
|
r988 | : QAbstractSeries(*new QAreaSeriesPrivate(upperSeries,lowerSeries,this),upperSeries) | ||
|
Michal Klocek
|
r421 | { | ||
| } | ||||
|
Tero Ahola
|
r761 | |||
|
Tero Ahola
|
r1202 | /*! | ||
|
Jani Honkonen
|
r1351 | Constructs area series object without upper or lower series with \a parent object. | ||
|
Tero Ahola
|
r1202 | */ | ||
| QAreaSeries::QAreaSeries(QObject *parent) | ||||
| : QAbstractSeries(*new QAreaSeriesPrivate(0, 0, this), parent) | ||||
| { | ||||
| } | ||||
|
Michal Klocek
|
r421 | /*! | ||
| Destroys the object. Series added to QChartView or QChart instances are owned by those, | ||||
| and are deleted when mentioned object are destroyed. | ||||
| */ | ||||
| QAreaSeries::~QAreaSeries() | ||||
| { | ||||
| } | ||||
|
Jani Honkonen
|
r1345 | /*! | ||
| Returns QChartSeries::SeriesTypeArea. | ||||
| */ | ||||
|
Michal Klocek
|
r1107 | QAbstractSeries::SeriesType QAreaSeries::type() const | ||
|
Michal Klocek
|
r938 | { | ||
|
Tero Ahola
|
r988 | return QAbstractSeries::SeriesTypeArea; | ||
|
Michal Klocek
|
r938 | } | ||
|
Marek Rosa
|
r1369 | /*! | ||
| Sets the \a series that is to be used as the area chart upper series. | ||||
| */ | ||||
|
Tero Ahola
|
r1202 | void QAreaSeries::setUpperSeries(QLineSeries* series) | ||
| { | ||||
| Q_D(QAreaSeries); | ||||
| d->m_upperSeries = series; | ||||
| } | ||||
|
Michal Klocek
|
r938 | QLineSeries* QAreaSeries::upperSeries() const | ||
| { | ||||
| Q_D(const QAreaSeries); | ||||
| return d->m_upperSeries; | ||||
| } | ||||
|
Marek Rosa
|
r1369 | /*! | ||
| Sets the \a series that is to be used as the area chart lower series. | ||||
| */ | ||||
|
Tero Ahola
|
r1202 | void QAreaSeries::setLowerSeries(QLineSeries* series) | ||
| { | ||||
| Q_D(QAreaSeries); | ||||
| d->m_lowerSeries = series; | ||||
| } | ||||
|
Michal Klocek
|
r938 | QLineSeries* QAreaSeries::lowerSeries() const | ||
| { | ||||
| Q_D(const QAreaSeries); | ||||
| return d->m_lowerSeries; | ||||
| } | ||||
|
Michal Klocek
|
r421 | /*! | ||
| Sets \a pen used for drawing area outline. | ||||
| */ | ||||
|
Tero Ahola
|
r761 | void QAreaSeries::setPen(const QPen &pen) | ||
|
Michal Klocek
|
r421 | { | ||
|
Michal Klocek
|
r938 | Q_D(QAreaSeries); | ||
| if (d->m_pen != pen) { | ||||
| d->m_pen = pen; | ||||
| emit d->updated(); | ||||
|
Michal Klocek
|
r571 | } | ||
|
Michal Klocek
|
r421 | } | ||
|
Michal Klocek
|
r938 | QPen QAreaSeries::pen() const | ||
| { | ||||
| Q_D(const QAreaSeries); | ||||
| return d->m_pen; | ||||
| } | ||||
|
Michal Klocek
|
r421 | /*! | ||
| Sets \a brush used for filling the area. | ||||
| */ | ||||
sauimone
|
r743 | void QAreaSeries::setBrush(const QBrush &brush) | ||
|
Michal Klocek
|
r421 | { | ||
|
Michal Klocek
|
r938 | Q_D(QAreaSeries); | ||
| if (d->m_brush != brush) { | ||||
| d->m_brush = brush; | ||||
| emit d->updated(); | ||||
|
Michal Klocek
|
r571 | } | ||
|
Michal Klocek
|
r421 | } | ||
|
Michal Klocek
|
r938 | |||
| QBrush QAreaSeries::brush() const | ||||
| { | ||||
| Q_D(const QAreaSeries); | ||||
| return d->m_brush; | ||||
| } | ||||
|
Tero Ahola
|
r1481 | |||
| void QAreaSeries::setColor(const QColor &color) | ||||
| { | ||||
| QBrush b = brush(); | ||||
| if (b.color() != color) { | ||||
| b.setColor(color); | ||||
| setBrush(b); | ||||
| emit colorChanged(color); | ||||
| } | ||||
| } | ||||
| QColor QAreaSeries::color() const | ||||
| { | ||||
| return brush().color(); | ||||
| } | ||||
| void QAreaSeries::setBorderColor(const QColor &color) | ||||
| { | ||||
| QPen p = pen(); | ||||
| if (p.color() != color) { | ||||
| p.setColor(color); | ||||
| setPen(p); | ||||
| emit borderColorChanged(color); | ||||
| } | ||||
| } | ||||
| QColor QAreaSeries::borderColor() const | ||||
| { | ||||
| return pen().color(); | ||||
| } | ||||
|
Michal Klocek
|
r421 | /*! | ||
| Sets if data points are \a visible and should be drawn on line. | ||||
| */ | ||||
| void QAreaSeries::setPointsVisible(bool visible) | ||||
| { | ||||
|
Michal Klocek
|
r938 | Q_D(QAreaSeries); | ||
| if (d->m_pointsVisible != visible) { | ||||
| d->m_pointsVisible = visible; | ||||
| emit d->updated(); | ||||
|
Michal Klocek
|
r571 | } | ||
|
Michal Klocek
|
r421 | } | ||
|
Tero Ahola
|
r1491 | /*! | ||
| Returns if the points are drawn for this series. | ||||
| \sa setPointsVisible() | ||||
| */ | ||||
|
Michal Klocek
|
r938 | bool QAreaSeries::pointsVisible() const | ||
| { | ||||
| Q_D(const QAreaSeries); | ||||
| return d->m_pointsVisible; | ||||
| } | ||||
| //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||||
|
Tero Ahola
|
r973 | QAreaSeriesPrivate::QAreaSeriesPrivate(QLineSeries *upperSeries, QLineSeries *lowerSeries,QAreaSeries* q) : | ||
|
Tero Ahola
|
r988 | QAbstractSeriesPrivate(q), | ||
|
Tero Ahola
|
r973 | m_upperSeries(upperSeries), | ||
| m_lowerSeries(lowerSeries), | ||||
| m_pointsVisible(false) | ||||
|
Michal Klocek
|
r938 | { | ||
|
Tero Ahola
|
r973 | } | ||
|
Michal Klocek
|
r938 | |||
|
Michal Klocek
|
r943 | void QAreaSeriesPrivate::scaleDomain(Domain& domain) | ||
| { | ||||
| Q_Q(QAreaSeries); | ||||
| qreal minX(domain.minX()); | ||||
| qreal minY(domain.minY()); | ||||
| qreal maxX(domain.maxX()); | ||||
| qreal maxY(domain.maxY()); | ||||
| int tickXCount(domain.tickXCount()); | ||||
| int tickYCount(domain.tickYCount()); | ||||
| QLineSeries* upperSeries = q->upperSeries(); | ||||
| QLineSeries* lowerSeries = q->lowerSeries(); | ||||
|
Michal Klocek
|
r1057 | const QList<QPointF>& points = upperSeries->points(); | ||
| for (int i = 0; i < points.count(); i++) | ||||
|
Michal Klocek
|
r943 | { | ||
|
Michal Klocek
|
r1057 | qreal x = points[i].x(); | ||
| qreal y = points[i].y(); | ||||
|
Michal Klocek
|
r943 | minX = qMin(minX, x); | ||
| minY = qMin(minY, y); | ||||
| maxX = qMax(maxX, x); | ||||
| maxY = qMax(maxY, y); | ||||
| } | ||||
| if(lowerSeries) { | ||||
|
Michal Klocek
|
r1057 | |||
|
Michal Klocek
|
r1059 | const QList<QPointF>& points = lowerSeries->points(); | ||
|
Michal Klocek
|
r1057 | |||
| for (int i = 0; i < points.count(); i++) | ||||
|
Michal Klocek
|
r943 | { | ||
|
Michal Klocek
|
r1057 | qreal x = points[i].x(); | ||
| qreal y = points[i].y(); | ||||
|
Michal Klocek
|
r943 | minX = qMin(minX, x); | ||
| minY = qMin(minY, y); | ||||
| maxX = qMax(maxX, x); | ||||
| maxY = qMax(maxY, y); | ||||
| }} | ||||
|
Michal Klocek
|
r1078 | domain.setRange(minX,maxX,minY,maxY,tickXCount,tickYCount); | ||
|
Michal Klocek
|
r943 | } | ||
| Chart* QAreaSeriesPrivate::createGraphics(ChartPresenter* presenter) | ||||
| { | ||||
| Q_Q(QAreaSeries); | ||||
| AreaChartItem* area = new AreaChartItem(q,presenter); | ||||
| if(presenter->animationOptions().testFlag(QChart::SeriesAnimations)) { | ||||
|
Michal Klocek
|
r1217 | area->upperLineItem()->setAnimator(presenter->animator()); | ||
| area->upperLineItem()->setAnimation(new XYAnimation(area->upperLineItem())); | ||||
| if(q->lowerSeries()) { | ||||
| area->lowerLineItem()->setAnimator(presenter->animator()); | ||||
| area->lowerLineItem()->setAnimation(new XYAnimation(area->lowerLineItem())); | ||||
| } | ||||
|
Michal Klocek
|
r943 | } | ||
| presenter->chartTheme()->decorate(q, presenter->dataSet()->seriesIndex(q)); | ||||
| return area; | ||||
| } | ||||
|
Michal Klocek
|
r950 | QList<LegendMarker*> QAreaSeriesPrivate::createLegendMarker(QLegend* legend) | ||
| { | ||||
| Q_Q(QAreaSeries); | ||||
| QList<LegendMarker*> list; | ||||
| return list << new AreaLegendMarker(q,legend); | ||||
| } | ||||
|
Michal Klocek
|
r421 | #include "moc_qareaseries.cpp" | ||
|
Michal Klocek
|
r938 | #include "moc_qareaseries_p.cpp" | ||
|
Michal Klocek
|
r421 | |||
| QTCOMMERCIALCHART_END_NAMESPACE | ||||