/**************************************************************************** ** ** 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$ ** ****************************************************************************/ #include "qsplineseries.h" #include "qsplineseries_p.h" #include "splinechartitem_p.h" #include "chartdataset_p.h" #include "charttheme_p.h" #include "splineanimation_p.h" /*! \class QSplineSeries \brief Series type used to store data needed to draw a spline. QSplineSeries stores the data points along with the segment control points needed by QPainterPath to draw spline Control points are automatically calculated when data changes. The algorithm computes the points so that the normal spline can be drawn. \image examples_splinechart.png Creating basic spline chart is simple: \code QSplineSeries* series = new QSplineSeries(); series->append(0, 6); series->append(2, 4); ... chart->addSeries(series); \endcode */ /*! \qmlclass SplineSeries QSplineSeries \inherits XYSeries The following QML shows how to create a simple spline chart: \snippet ../demos/qmlchart/qml/qmlchart/View3.qml 1 \beginfloatleft \image demos_qmlchart3.png \endfloat \clearfloat */ /*! \fn QSeriesType QSplineSeries::type() const Returns the type of the series */ /*! \qmlproperty AbstractAxis SplineSeries::axisX The x axis used for the series. If you leave the x axis undefined, a ValueAxis is created for the series. */ /*! \qmlproperty AbstractAxis SplineSeries::axisY The y axis used for the series. If you leave the y axis undefined, a ValueAxis is created for the series. */ /*! \qmlproperty real SplineSeries::width The width of the line. By default the width is 2.0. */ /*! \qmlproperty Qt::PenStyle SplineSeries::style Controls the style of the line. Set to one of Qt.NoPen, Qt.SolidLine, Qt.DashLine, Qt.DotLine, Qt.DashDotLine or Qt.DashDotDotLine. Using Qt.CustomDashLine is not supported in the QML API. By default the style is Qt.SolidLine. */ /*! \qmlproperty Qt::PenCapStyle SplineSeries::capStyle Controls the cap style of the line. Set to one of Qt.FlatCap, Qt.SquareCap or Qt.RoundCap. By default the cap style is Qt.SquareCap. */ QTCOMMERCIALCHART_BEGIN_NAMESPACE /*! Constructs empty series object which is a child of \a parent. When series object is added to QChartView or QChart instance then the ownerships is transferred. */ QSplineSeries::QSplineSeries(QObject *parent) : QLineSeries(*new QSplineSeriesPrivate(this),parent) { Q_D(QSplineSeries); QObject::connect(this,SIGNAL(pointAdded(int)), d, SLOT(updateControlPoints())); QObject::connect(this,SIGNAL(pointRemoved(int)), d, SLOT(updateControlPoints())); QObject::connect(this,SIGNAL(pointReplaced(int)), d, SLOT(updateControlPoints())); QObject::connect(this,SIGNAL(pointsReplaced()), d, SLOT(updateControlPoints())); } /*! Destroys the object. */ QSplineSeries::~QSplineSeries() { Q_D(QSplineSeries); if(d->m_dataset){ d->m_dataset->removeSeries(this); } } QAbstractSeries::SeriesType QSplineSeries::type() const { return QAbstractSeries::SeriesTypeSpline; } //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// QSplineSeriesPrivate::QSplineSeriesPrivate(QSplineSeries* q):QLineSeriesPrivate(q) { } /*! Calculates control points which are needed by QPainterPath.cubicTo function to draw the cubic Bezier cureve between two points. */ void QSplineSeriesPrivate::calculateControlPoints() { Q_Q(QSplineSeries); const QList& points = q->points(); int n = points.count() - 1; if (n == 1) { //for n==1 m_controlPoints[0].setX((2 * points[0].x() + points[1].x()) / 3); m_controlPoints[0].setY((2 * points[0].y() + points[1].y()) / 3); m_controlPoints[1].setX(2 * m_controlPoints[0].x() - points[0].x()); m_controlPoints[1].setY(2 * m_controlPoints[0].y() - points[0].y()); return; } // Calculate first Bezier control points // Set of equations for P0 to Pn points. // // | 2 1 0 0 ... 0 0 0 ... 0 0 0 | | P1_1 | | P0 + 2 * P1 | // | 1 4 1 0 ... 0 0 0 ... 0 0 0 | | P1_2 | | 4 * P1 + 2 * P2 | // | 0 1 4 1 ... 0 0 0 ... 0 0 0 | | P1_3 | | 4 * P2 + 2 * P3 | // | . . . . . . . . . . . . | | ... | | ... | // | 0 0 0 0 ... 1 4 1 ... 0 0 0 | * | P1_i | = | 4 * P(i-1) + 2 * Pi | // | . . . . . . . . . . . . | | ... | | ... | // | 0 0 0 0 0 0 0 0 ... 1 4 1 | | P1_(n-1)| | 4 * P(n-2) + 2 * P(n-1) | // | 0 0 0 0 0 0 0 0 ... 0 2 7 | | P1_n | | 8 * P(n-1) + Pn | // QVector vector; vector.resize(n); vector[0] = points[0].x() + 2 * points[1].x(); for (int i = 1; i < n - 1; ++i){ vector[i] = 4 * points[i].x() + 2 * points[i + 1].x(); } vector[n - 1] = (8 * points[n-1].x() + points[n].x()) / 2.0; QVector xControl = firstControlPoints(vector); vector[0] = points[0].y() + 2 * points[1].y(); for (int i = 1; i < n - 1; ++i) { vector[i] = 4 * points[i].y() + 2 * points[i + 1].y(); } vector[n - 1] = (8 * points[n-1].y() + points[n].y()) / 2.0; QVector yControl = firstControlPoints(vector); for (int i = 0,j =0; i < n; ++i, ++j) { m_controlPoints[j].setX(xControl[i]); m_controlPoints[j].setY(yControl[i]); j++; if (i < n - 1){ m_controlPoints[j].setX(2 * points[i+1].x() - xControl[i + 1]); m_controlPoints[j].setY(2 * points[i+1].y() - yControl[i + 1]); }else{ m_controlPoints[j].setX((points[n].x() + xControl[n - 1]) / 2); m_controlPoints[j].setY((points[n].y() + yControl[n - 1]) / 2); } } } QVector QSplineSeriesPrivate::firstControlPoints(const QVector& vector) { QVector result; int count = vector.count(); result.resize(count); result[0] = vector[0] / 2.0; QVector temp; temp.resize(count); temp[0] = 0; qreal b = 2.0; for (int i = 1; i < count; i++) { temp[i] = 1 / b; b = (i < count - 1 ? 4.0 : 3.5) - temp[i]; result[i]=(vector[i] - result[i - 1]) / b; } for (int i = 1; i < count; i++) result[count - i - 1] -= temp[count - i] * result[count - i]; return result; } QPointF QSplineSeriesPrivate::controlPoint(int index) const { return m_controlPoints[index]; } /*! Updates the control points, besed on currently avaiable knots. */ void QSplineSeriesPrivate::updateControlPoints() { Q_Q(QSplineSeries); if (q->count() > 1) { m_controlPoints.resize(2*q->count()-2); calculateControlPoints(); } } ChartElement* QSplineSeriesPrivate::createGraphics(ChartPresenter* presenter) { Q_Q(QSplineSeries); SplineChartItem* spline = new SplineChartItem(q,presenter); if(presenter->animationOptions().testFlag(QChart::SeriesAnimations)) { spline->setAnimation(new SplineAnimation(spline)); } presenter->chartTheme()->decorate(q, presenter->dataSet()->seriesIndex(q)); return spline; } #include "moc_qsplineseries.cpp" #include "moc_qsplineseries_p.cpp" QTCOMMERCIALCHART_END_NAMESPACE