HG_REPOSITORIES/LPP/INSTRUMENTATION/USERS/JEANDET/qtcharts Commit - r395:9f537617b108

Replace to QScatterSeries

Tero Ahola -

r395:9f537617b108

parent child

Context file:

r395:9f537617b108

Collapse all files

example/scatter/main.cpp +3 -1

             #include <QtGui/QApplication>
             #include <QMainWindow>
             #include <qchartglobal.h>
             #include <qchartview.h>
             #include <qscatterseries.h>
             QTCOMMERCIALCHART_USE_NAMESPACE
             int main(int argc, char *argv[])
             {
                 QApplication a(argc, argv);
                 //! [1]
                 // Create chart view
                 QChartView *chartView = new QChartView();
                 chartView->setChartTheme(QChart::ChartThemeIcy);
                 // Add scatter series with simple test data
                 QScatterSeries *scatter = new QScatterSeries();
                 *scatter << QPointF(0.5, 5.0) << QPointF(1.0, 4.5) << QPointF(1.0, 5.5) << QPointF(1.5, 5.0);
                 // Chart takes ownership
                 chartView->addSeries(scatter);
                 //! [1]
+            //    scatter->replace(0, QPointF(0.75, 5.0));
                 // And more
                 //! [3]
                 *scatter << QPointF(2.0, 5.5) << QPointF(2.2, 5.4);
                 //! [3]
-                // Add another scatter series (re-use the previous pointer)
+                // Add another scatter series (re-use the previous pointer because the code used as snippets
+                // in the docs)
                 // - more data with random component
                 scatter = new QScatterSeries();
                 for (qreal i(0.0); i < 20; i += 0.15) {
                     (*scatter) << QPointF(i + (qreal)(rand() % 100) / 100.0,
                                            i + (qreal)(rand() % 100) / 100.0);
                 }
                 //! [4]
                 QBrush brush(QColor(255, 0, 0, 100), Qt::SolidPattern);
                 scatter->setBrush(brush);
                 //! [4]
                 //! [5]
                 QPen pen(QColor(0, 255, 0, 80), 3);
                 scatter->setPen(pen);
                 //! [5]
                 //! [6]
                 scatter->setShape(QScatterSeries::MarkerShapeRectangle);
                 //! [6]
                 chartView->addSeries(scatter);
                 // Use the chart widget as the central widget
                 QMainWindow w;
                 w.resize(400, 300);
                 w.setCentralWidget(chartView);
                 w.setWindowFlags(Qt::FramelessWindowHint);
                 w.show();
                 return a.exec();
             }

src/scatterseries/qscatterseries.cpp +19 -5

             #include "qscatterseries.h"
             #include "scatterseries_p.h"
             #include "qchart.h"
             /*!
                 \class QScatterSeries
                 \brief QtCommercial Chart series API for showing scatter series.
                 \mainclass
                 Example on how to create a chart with scatter series:
                 \snippet ../example/scatter/main.cpp 1
                 The example code would result the following:
                 \image scatter_example1.jpg
             */
             /*!
                 \enum QScatterSeries::MarkerShape
                 This enum describes the shape used when rendering marker items.
                 \value MarkerShapeDefault
                 \value MarkerShapePoint
                 \value MarkerShapeX
                 \value MarkerShapeRectangle
                 \value MarkerShapeTiltedRectangle
                 \value MarkerShapeTriangle
                 \value MarkerShapeCircle
             */
             /*!
                 \fn QChartSeriesType QScatterSeries::type() const
                 \brief Returns QChartSeries::SeriesTypeScatter.
             */
             /*!
                 \fn void QScatterSeries::clicked(QPointF coordinate)
                 User clicked the scatter series. Note that the \a coordinate is the chart coordinate that the
                 click occurred on; not necessarily a data point coordinate. To find the corresponding (closest)
                 data point you can use closestPoint().
             */
             /*!
                 \fn void QScatterSeries::changed()
                 \brief TODO
             */
             QTCOMMERCIALCHART_BEGIN_NAMESPACE
             QScatterSeriesPrivate::QScatterSeriesPrivate() :
                 m_data(QList<QPointF>()),
                 m_markerPen(QPen(QColor::Invalid)),
                 m_markerBrush(QBrush(QColor::Invalid)),
                 m_markerShape(QScatterSeries::MarkerShapeDefault)
             {
             }
             /*!
                 Constructs a series object which is a child of \a parent.
             */
             QScatterSeries::QScatterSeries(QObject *parent) :
                 QSeries(parent),
                 d(new QScatterSeriesPrivate())
             {
             }
             /*!
                 Destroys the object. Note that adding series to QChart transfers the ownership to the chart.
             */
             QScatterSeries::~QScatterSeries()
             {
                 delete d;
             }
             /*!
                 Add single data point with \a x and \a y coordinates to the series.
             */
             void QScatterSeries::add(qreal x, qreal y)
             {
                 d->m_data.append(QPointF(x, y));
                 emit changed();
             }
             /*!
                 Add single data point with \a value to the series.
             */
             void QScatterSeries::add(QPointF value)
             {
                 d->m_data.append(value);
                 emit changed();
             }
             /*!
                 Add list of \a points to the series.
             */
             void QScatterSeries::add(QList<QPointF> points)
             {
                 d->m_data.append(points);
                 emit changed();
             }
             /*!
                 Stream operator for adding a data point with \a value to the series.
                 \sa add()
                 For example:
                 \snippet ../example/scatter/main.cpp 3
             */
             QScatterSeries& QScatterSeries::operator << (const QPointF &value)
             {
                 d->m_data.append(value);
                 emit changed();
                 return *this;
             }
             /*!
                 Stream operator for adding a list of points to the series.
                 \sa add()
             */
             QScatterSeries& QScatterSeries::operator << (QList<QPointF> value)
             {
                 d->m_data.append(value);
                 emit changed();
                 return *this;
             }
             /*!
                 Replaces the data of the series with the given list of data \a points.
             */
             void QScatterSeries::setData(QList<QPointF> points)
             {
                 d->m_data = points;
                 emit changed();
             }
             /*!
                 Returns the current list of data points of the series.
             */
             QList<QPointF> QScatterSeries::data()
             {
                 return d->m_data;
             }
             /*!
-                Remove the data point at \a pointIndex. Returns true if a point was removed, false if the point
+                Replaces the point at \a index with \a newPoint. Returns true if \a index is a valid position
-                at \a pointIndex does not exist on the series.
+                in the series data, false otherwise.
             */
-            bool QScatterSeries::removeAt(int pointIndex)
+            bool QScatterSeries::replace(int index, QPointF newPoint)
             {
-                if (pointIndex >=0 && pointIndex < d->m_data.count()) {
+                if (index >= 0 && index < d->m_data.count()) {
-                    d->m_data.removeAt(pointIndex);
+                    d->m_data.replace(index, newPoint);
+                    emit changed();
+                    return true;
+                }
+                return false;
+            }
+            /*!
+                Remove the data point at \a index. Returns true if a point was removed, false if the point
+                at \a index does not exist on the series.
+            */
+            bool QScatterSeries::removeAt(int index)
+            {
+                if (index >=0 && index < d->m_data.count()) {
+                    d->m_data.removeAt(index);
                     emit changed();
                     return true;
                 }
                 return false;
             }
             /*!
                 Remove all occurrences of \a point from the series and returns the number of points removed.
             */
             int QScatterSeries::removeAll(QPointF point)
             {
                 int count = d->m_data.removeAll(point);
                 emit changed();
                 return count;
             }
             /*!
                 Remove all data points from the series.
             */
             void QScatterSeries::clear()
             {
                 d->m_data.clear();
                 emit changed();
             }
             /*!
                 Returns the index of the data point that is closest to \a coordinate. If several data points
                 are at the same distance from the \a coordinate, returns the last one. If no points exist,
                 returns -1.
             */
             int QScatterSeries::closestPoint(QPointF coordinate)
             {
                 qreal distance(-1);
                 int pointIndex(-1);
                 for (int i(0); i < d->m_data.count(); i++) {
                     QPointF dataPoint = d->m_data.at(i);
                     QPointF difference = dataPoint - coordinate;
                     if (i == 0 || difference.manhattanLength() <= distance) {
                         distance = difference.manhattanLength();
                         pointIndex = i;
                     }
                 }
                 return pointIndex;
             }
             /*!
                 Overrides the default pen used for drawing a marker item with a user defined \a pen. The
                 default pen is defined by chart theme setting.
                 For example:
                 \snippet ../example/scatter/main.cpp 5
                 Would present your scatter markers with an opaque, uglyish green outlines instead of the
                 beatiful markers defined by the chart's theme:
                 \image scatter_example_pen.jpg
                 \sa setBrush()
                 \sa QChart::setChartTheme()
             */
             void QScatterSeries::setPen(QPen pen)
             {
                 d->m_markerPen = pen;
             }
             /*!
                 Returns the pen used for drawing markers.
             */
             QPen QScatterSeries::pen()
             {
                 return d->m_markerPen;
             }
             /*!
                 Overrides the default brush of the marker items with a user defined \a brush. The default brush
                 is defined by chart theme setting.
                 For example:
                 \snippet ../example/scatter/main.cpp 4
                 Would fill your scatter markers with an opaque red color:
                 \image scatter_example_brush.jpg
                 \sa setPen()
                 \sa QChart::setChartTheme()
             */
             void QScatterSeries::setBrush(QBrush brush)
             {
                 d->m_markerBrush = brush;
             }
             /*!
                 Returns the brush used for drawing markers.
             */
             QBrush QScatterSeries::brush()
             {
                 return d->m_markerBrush;
             }
             /*!
                 Overrides the default shape of the marker items with a user defined \a shape. The default shape
                 is defined by chart theme setting.
                 For example:
                 \snippet ../example/scatter/main.cpp 6
                 Would make your scatter marker items rectangle:
                 \image scatter_example_shape.jpg
             */
             void QScatterSeries::setShape(MarkerShape shape)
             {
                 d->m_markerShape = shape;
             }
             /*!
                 Returns the shape used for drawing markers.
             */
             QScatterSeries::MarkerShape QScatterSeries::shape()
             {
                 return (QScatterSeries::MarkerShape) d->m_markerShape;
             }
             #include "moc_qscatterseries.cpp"
             QTCOMMERCIALCHART_END_NAMESPACE

src/scatterseries/qscatterseries.h +2 -1

             #ifndef QSCATTERSERIES_H
             #define QSCATTERSERIES_H
             #include "qseries.h"
             #include <QRectF>
             #include <QColor>
             QTCOMMERCIALCHART_BEGIN_NAMESPACE
             class QScatterSeriesPrivate;
             class QTCOMMERCIALCHART_EXPORT QScatterSeries : public QSeries
             {
                 Q_OBJECT
             public:
                 enum MarkerShape {
                     // TODO: to be defined by the graphics design
                     // TODO: marker shapes: "x", star, rectangle, tilted rect, triangle, circle, dot
                     MarkerShapeDefault = 0,
                     MarkerShapePoint,
                     MarkerShapeX,
                     MarkerShapeRectangle,
                     MarkerShapeTiltedRectangle,
                     MarkerShapeTriangle,
                     MarkerShapeCircle
                 };
             public:
                 QScatterSeries(QObject *parent = 0);
                 ~QScatterSeries();
             public: // from QChartSeries
                 QSeriesType type() const { return QSeries::SeriesTypeScatter; }
             public:
                 void add(qreal x, qreal y);
                 void add(QPointF value);
                 void add(QList<QPointF> points);
                 void setData(QList<QPointF> points);
                 QScatterSeries& operator << (const QPointF &value);
                 QScatterSeries& operator << (QList<QPointF> points);
                 QList<QPointF> data();
-                bool removeAt(int pointIndex);
+                bool replace(int index, QPointF newPoint);
+                bool removeAt(int index);
                 int removeAll(QPointF point);
                 void clear();
                 int closestPoint(QPointF coordinate);
                 //TODO: insert, replace...?
                 QPen pen();
                 void setPen(QPen pen);
                 QBrush brush();
                 void setBrush(QBrush brush);
                 MarkerShape shape();
                 void setShape(MarkerShape shape);
                 // TODO: marker size?
             Q_SIGNALS:
                 void clicked(QPointF coordinate);
                 // TODO: move to PIMPL for simplicity or does the user ever need changed signals?
                 // TODO: more finegrained signaling for performance reasons
                 // (check QPieSeries implementation with change sets)
                 void changed();
             private:
                 Q_DECLARE_PRIVATE(QScatterSeries)
                 Q_DISABLE_COPY(QScatterSeries)
                 QScatterSeriesPrivate *const d;
             };
             QTCOMMERCIALCHART_END_NAMESPACE
             #endif // QSCATTERSERIES_H

General Comments 0

Write
Preview

You need to be logged in to leave comments. Login now

No TODOs yet

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages