HG_REPOSITORIES/LPP/INSTRUMENTATION/USERS/JEANDET/qtcharts Commit - r397:e3d058df67ba

Added size customization to QScatterSeries

Tero Ahola -

r397:e3d058df67ba

parent child

Context file:

r397:e3d058df67ba

Collapse all files

doc/images/scatter_example_custom.jpg created 644 binary 0 0

NO CONTENT: new file 100644, binary diff hidden

doc/images/scatter_example1.jpg binary modified 0 0

NO CONTENT: modified file, binary diff hidden

example/scatter/main.cpp +16 -24

             #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);
+                chartView->setRenderHint(QPainter::Antialiasing);
-                // Add scatter series with simple test data
+                chartView->setChartTheme(QChart::ChartThemeScientific);
+                // Add scatter series with linear test data with random "noise"
                 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);
+                for (qreal i(0.0); i < 20; i += 0.25) {
+                    qreal x = i + (qreal)(rand() % 100) / 100.0;
+                    qreal y = i + (qreal)(rand() % 100) / 100.0;
+                    (*scatter) << QPointF(x, y);
+                }
                 // Chart takes ownership
                 chartView->addSeries(scatter);
                 //! [1]
-            //    scatter->replace(0, QPointF(0.75, 5.0));
                 // And more
-                //! [3]
+                //! [2]
-                *scatter << QPointF(2.0, 5.5) << QPointF(2.2, 5.4);
+                //*scatter << QPointF(2.0, 5.5) << QPointF(2.2, 5.4);
-                //! [3]
+                //! [2]
-                // Add another scatter series (re-use the previous pointer because the code used as snippets
+                //! [3]
-                // in the docs)
+                QBrush brush(QColor(255, 0, 0, 80), Qt::SolidPattern);
-                // - 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]
+                QPen pen(QColor(0, 255, 0, 60), 3);
-                //! [5]
-                QPen pen(QColor(0, 255, 0, 80), 3);
                 scatter->setPen(pen);
-                //! [5]
-                //! [6]
                 scatter->setShape(QScatterSeries::MarkerShapeRectangle);
-                //! [6]
+                scatter->setSize(15.0);
-                chartView->addSeries(scatter);
+                //! [3]
                 // 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 +29 -22

             #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
+                To customize the graphical representation of the series, you can modify pen, brush, shape and
+                size of the marker items. For example:
+                \snippet ../example/scatter/main.cpp 3
+                Would present your scatter markers as big rectangles with opaque, uglyish green outlines and
+                opaque red filling instead of the beatiful markers defined by the chart's theme:
+                \image scatter_example_custom.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)
+                m_markerShape(QScatterSeries::MarkerShapeDefault),
+                m_markerSize(9.0)
             {
             }
             /*!
                 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
+                \snippet ../example/scatter/main.cpp 2
             */
             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;
             }
             /*!
                 Replaces the point at \a index with \a newPoint. Returns true if \a index is a valid position
                 in the series data, false otherwise.
             */
             bool QScatterSeries::replace(int index, QPointF newPoint)
             {
                 if (index >= 0 && index < d->m_data.count()) {
                     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;
             }
+            /*!
+                Returns the size of the marker items.
+            */
+            qreal QScatterSeries::size()
+            {
+                return d->m_markerSize;
+            }
+            /*!
+                Set the \a size of the marker items. The default size is 9.0.
+            */
+            void QScatterSeries::setSize(qreal size)
+            {
+                d->m_markerSize = size;
+                emit changed();
+            }
             #include "moc_qscatterseries.cpp"
             QTCOMMERCIALCHART_END_NAMESPACE

src/scatterseries/qscatterseries.h +2 -2

             #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 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?
+                qreal size();
+                void setSize(qreal 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

src/scatterseries/scatterpresenter.cpp +1 -4

             #include "scatterpresenter_p.h"
             #include "qscatterseries.h"
             #include "chartpresenter_p.h"
             #include <QPen>
             #include <QPainter>
             #include <QGraphicsScene>
             #include <QGraphicsSceneMouseEvent>
             #include <QGraphicsDropShadowEffect>
             #include <QDebug>
             #include <QTime>
             QTCOMMERCIALCHART_BEGIN_NAMESPACE
             ScatterPresenter::ScatterPresenter(QScatterSeries *series, QGraphicsObject *parent) :
                 ChartItem(parent),
                 m_series(series),
                 m_boundingRect(),
                 m_visibleChartArea()
             {
                 if (parent)
                     m_boundingRect = parent->boundingRect();
                 if (series) {
                     connect(series, SIGNAL(changed()), this, SLOT(handleModelChanged()));
                 }
                 setZValue(ChartPresenter::ScatterSeriesZValue);
                 // TODO: how to draw a drop shadow?
             //    QGraphicsDropShadowEffect *dropShadow = new QGraphicsDropShadowEffect();
             //    dropShadow->setOffset(2.0);
             //    dropShadow->setBlurRadius(2.0);
             //    setGraphicsEffect(dropShadow);
             }
             void ScatterPresenter::handleDomainChanged(const Domain& domain)
             {
                 m_visibleChartArea = domain;
                 changeGeometry();
             }
             void ScatterPresenter::handleGeometryChanged(const QRectF& rect)
             {
                 m_boundingRect = rect.translated(-rect.topLeft());
                 changeGeometry();
                 setPos(rect.topLeft());
             }
             void ScatterPresenter::handleModelChanged()
             {
                 // TODO: more fine grained modelChanged signaling
                 changeGeometry();
             }
             void ScatterPresenter::paint(QPainter *painter, const QStyleOptionGraphicsItem */*option*/, QWidget */*widget*/)
             {
                 painter->save();
                 painter->setClipRect(m_boundingRect);
                 // TODO: how to draw a drop shadow?
                 // Now using a custom implementation for drop shadow instead of QGraphicsDropShadowEffect.
                 // It seems QGraphicsDropShadowEffect is quite heavy, at least on windows without open gl.
                 QPen dropShadowPen(QColor(0, 0, 0, 70));
                 dropShadowPen.setWidth(3);
                 painter->setPen(dropShadowPen);
                 painter->setBrush(dropShadowPen.color());
             //    painter->setRenderHint(QPainter::Antialiasing);
                 painter->drawPath(m_path.translated(2, 2));
                 // Paint the shape
                 // The custom settings in series override those defined by the theme
                 QPen pen = m_markerPen;
                 if (m_series->pen().color().isValid())
                     pen = m_series->pen();
                 painter->setPen(pen);
                 if (m_series->brush().color().isValid())
                     painter->setBrush(m_series->brush());
                 else
                     painter->setBrush(m_markerBrush);
                 // If either pen or brush is opaque, we need to draw the polygons one-by-one
                 if (painter->pen().color().alpha() < 255 || painter->brush().color().alpha() < 255) {
                     foreach (QPolygonF pol, m_path.toSubpathPolygons())
                         painter->drawPolygon(pol);
                 } else {
                     painter->drawPath(m_path);
                 }
                 painter->restore();
             }
             void ScatterPresenter::mousePressEvent(QGraphicsSceneMouseEvent *event)
             {
                 // Empty implementation to grab mouse release events for this item
                 Q_UNUSED(event)
             }
             void ScatterPresenter::mouseReleaseEvent(QGraphicsSceneMouseEvent *event)
             {
                 QPointF clickedPoint(
                     m_visibleChartArea.m_minX + (event->lastPos().x() / m_boundingRect.width()) * m_visibleChartArea.spanX(),
                     m_visibleChartArea.m_maxY - (event->lastPos().y() / m_boundingRect.height()) * m_visibleChartArea.spanY());
                 emit clicked(clickedPoint);
             }
             void ScatterPresenter::changeGeometry()
             {
                 if (m_boundingRect.isValid()) {
                     prepareGeometryChange();
                     qreal scalex = m_boundingRect.width() / m_visibleChartArea.spanX();
                     qreal scaley = m_boundingRect.height() / m_visibleChartArea.spanY();
                     int shape = m_series->shape();
                     m_path = QPainterPath();
                     m_path.setFillRule(Qt::WindingFill);
-                    const qreal size(9); // TODO: user defined size?
+                    const qreal size = m_series->size();
                     foreach (QPointF point, m_series->data()) {
                         // Convert relative coordinates to absolute pixel coordinates that can be used for drawing
                         qreal x = point.x() * scalex - m_visibleChartArea.m_minX * scalex - size / 2;
                         qreal y = m_boundingRect.height() - point.y() * scaley + m_visibleChartArea.m_minY * scaley - size / 2;
                         if (x < scene()->width() && y < scene()->height()) {
                             switch (shape) {
                             case QScatterSeries::MarkerShapeDefault:
                                 // Fallthrough, defaults to circle
                             case QScatterSeries::MarkerShapeCircle:
                                 m_path.addEllipse(x, y, size, size);
                                 break;
-                            case QScatterSeries::MarkerShapePoint:
-                                m_path.addEllipse(x, y, 2, 2);
-                                break;
                             case QScatterSeries::MarkerShapeRectangle:
                                 m_path.addRect(x, y, size, size);
                                 break;
                             case QScatterSeries::MarkerShapeTiltedRectangle: {
                                 // TODO: tilt the rectangle
                                 m_path.addRect(x, y, size, size);
                                 break;
                             }
                             default:
                                 // TODO: implement the rest of the shapes
                                 Q_ASSERT(false);
                                 break;
                             }
                         }
                     }
                 }
             }
             #include "moc_scatterpresenter_p.cpp"
             QTCOMMERCIALCHART_END_NAMESPACE

src/scatterseries/scatterseries_p.h +1 0

             #ifndef QSCATTERSERIESPRIVATE_H
             #define QSCATTERSERIESPRIVATE_H
             #include "qchartglobal.h"
             #include "qseries.h"
             #include <QPen>
             QTCOMMERCIALCHART_BEGIN_NAMESPACE
             /*!
              * The PIMPL class of QScatterSeries.
              */
             class QScatterSeriesPrivate
             {
             public:
                 QScatterSeriesPrivate();
             public:
                 QList<QPointF> m_data;
                 QPen m_markerPen;
                 QBrush m_markerBrush;
                 int m_markerShape;
+                qreal m_markerSize;
             };
             QTCOMMERCIALCHART_END_NAMESPACE
             #endif // QSCATTERSERIESPRIVATE_H

doc/images/scatter_example_brush.jpg removed binary 0 0

NO CONTENT: file was removed, binary diff hidden

doc/images/scatter_example_pen.jpg removed binary 0 0

NO CONTENT: file was removed, binary diff hidden

doc/images/scatter_example_shape.jpg removed binary 0 0

NO CONTENT: file was removed, binary diff hidden

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