Revision control
Copy as Markdown
// Copyright (C) 2021 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
#include <QtCharts/QScatterSeries>
#include <private/qscatterseries_p.h>
#include <private/scatterchartitem_p.h>
#include <private/chartdataset_p.h>
#include <private/charttheme_p.h>
#include <private/scatteranimation_p.h>
#include <private/qchart_p.h>
/*!
\class QScatterSeries
\inmodule QtCharts
\brief The QScatterSeries class presents data in scatter charts.
The scatter data is displayed as a collection of points on the chart. For
each point, two values are specified that determine its position on the
horizontal axis and the vertical axis.
\image examples_scatterchart.png {Scatter chart plotting three series as
circle, square, and star markers scattered across the plot}
The following code snippet illustrates how to create a basic scatter chart:
\code
QScatterSeries* series = new QScatterSeries();
series->append(0, 6);
series->append(2, 4);
...
chart->addSeries(series);
\endcode
For more information, see \l{Charts with Widgets Gallery} and
\l {Creating Scatter Charts}.
*/
/*!
\qmltype ScatterSeries
\nativetype QScatterSeries
\inqmlmodule QtCharts
\inherits XYSeries
\brief The ScatterSeries type presents data in scatter charts.
The scatter data is displayed as a collection of points on the chart. For
each point, two values are specified that determine its position on the
horizontal axis and the vertical axis.
\image examples_qmlchart5.png {Scatter chart plotting two series of
points as blue and green markers}
The following QML code shows how to create a chart with two simple scatter
series:
\snippet qmlchartsgallery/qml/ScatterSeries.qml 1
For more information, see \l{Charts with QML Gallery}.
*/
/*!
\enum QScatterSeries::MarkerShape
This enum value describes the shape used when rendering marker items.
\value MarkerShapeCircle
The marker is a circle. This is the default value.
\value MarkerShapeRectangle
The marker is a rectangle.
\value MarkerShapeRotatedRectangle
The marker is a rotated rectangle.
\value MarkerShapeTriangle
The marker is a triangle.
\value MarkerShapeStar
The marker is a star.
\value MarkerShapePentagon
The marker is a pentagon.
*/
/*!
\property QScatterSeries::brush
\brief The brush used to draw the scatter series markers.
The brush can be an image that can be created using QPainterPath,
for example.
*/
/*!
\qmlproperty brush ScatterSeries::brush
The brush used to draw the scatter series markers.
*/
/*!
\property QScatterSeries::borderColor
\brief The color used to draw the marker borders.
This is a convenience property for modifying the color of the pen.
\sa QScatterSeries::pen()
*/
/*!
\qmlproperty int ScatterSeries::count
The number of data points in the series.
*/
/*!
\qmlproperty color ScatterSeries::borderColor
The color used to draw the marker borders.
*/
/*!
\qmlproperty real ScatterSeries::borderWidth
The width of the border line. By default, the width is 2.0.
*/
/*!
\property QScatterSeries::markerShape
\brief The shape of the marker used to render the points in the series.
The default shape is MarkerShapeCircle.
\sa MarkerShape
*/
/*!
\qmlproperty enumeration ScatterSeries::markerShape
The shape used when rendering marker items:
\value ScatterSeries.MarkerShapeCircle
The marker is a circle. This is the default value.
\value ScatterSeries.MarkerShapeRectangle
The marker is a rectangle.
*/
/*!
\property QScatterSeries::markerSize
\brief The size of the marker used to render the points in the series.
\sa QXYSeries::setMarkerSize
*/
/*!
\qmlproperty real ScatterSeries::markerSize
The size of the marker used to render the points in the series.
*/
/*!
\qmlproperty string ScatterSeries::brushFilename
The name of the file used as a brush for the series.
*/
/*!
\fn void QScatterSeries::colorChanged(QColor color)
This signal is emitted when the fill (brush) color changes to \a color.
*/
/*!
\fn void QScatterSeries::borderColorChanged(QColor color)
This signal is emitted when the line (pen) color changes to \a color.
*/
/*!
\fn void QScatterSeries::markerShapeChanged(MarkerShape shape)
This signal is emitted when the marker shape changes to \a shape.
*/
/*!
\fn void QScatterSeries::markerSizeChanged(qreal size)
This signal is emitted when the marker size changes to \a size.
*/
QT_BEGIN_NAMESPACE
/*!
Constructs a series object that is a child of \a parent.
*/
QScatterSeries::QScatterSeries(QObject *parent)
: QXYSeries(*new QScatterSeriesPrivate(this), parent)
{
setPointsVisible(true);
// Emit QScatterSeries' markerSizeChanged signal as it's not the same as
// QXYSeries' markerSizeChanged
connect(this, &QXYSeries::markerSizeChanged, this, &QScatterSeries::markerSizeChanged);
}
/*!
Deletes the scatter series.
\note Adding the series to QChart transfers the ownership to the chart.
*/
QScatterSeries::~QScatterSeries()
{
Q_D(QScatterSeries);
if (d->m_chart)
d->m_chart->removeSeries(this);
}
/*!
\reimp
*/
QAbstractSeries::SeriesType QScatterSeries::type() const
{
return QAbstractSeries::SeriesTypeScatter;
}
/*!
\reimp
*/
void QScatterSeries::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->seriesUpdated();
if (emitColorChanged)
emit borderColorChanged(pen.color());
}
}
/*!
\reimp
*/
void QScatterSeries::setBrush(const QBrush &brush)
{
Q_D(QScatterSeries);
if (d->m_brush != brush) {
bool emitColorChanged = d->m_brush.color() != brush.color();
d->m_brush = brush;
emit d->seriesUpdated();
if (emitColorChanged)
emit colorChanged(brush.color());
}
}
QBrush QScatterSeries::brush() const
{
Q_D(const QScatterSeries);
if (d->m_brush == QChartPrivate::defaultBrush())
return QBrush();
else
return d->m_brush;
}
void QScatterSeries::setColor(const QColor &color)
{
QBrush b = brush();
if (b == QChartPrivate::defaultBrush())
b = QBrush();
if (b == QBrush())
b.setStyle(Qt::SolidPattern);
b.setColor(color);
setBrush(b);
}
QColor QScatterSeries::color() const
{
return brush().color();
}
void QScatterSeries::setBorderColor(const QColor &color)
{
QPen p = pen();
if (p == QChartPrivate::defaultPen())
p = QPen();
p.setColor(color);
setPen(p);
}
QColor QScatterSeries::borderColor() const
{
return pen().color();
}
QScatterSeries::MarkerShape QScatterSeries::markerShape() const
{
Q_D(const QScatterSeries);
return d->m_shape;
}
void QScatterSeries::setMarkerShape(MarkerShape shape)
{
Q_D(QScatterSeries);
if (d->m_shape != shape) {
d->m_shape = shape;
emit d->seriesUpdated();
emit markerShapeChanged(shape);
}
}
qreal QScatterSeries::markerSize() const
{
// markerSize has moved to QXYSeries, but this method needs to remain for API compatibility.
return QXYSeries::markerSize();
}
void QScatterSeries::setMarkerSize(qreal size)
{
// markerSize has moved to QXYSeries, but this method needs to remain for API compatibility.
QXYSeries::setMarkerSize(size);
}
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
QScatterSeriesPrivate::QScatterSeriesPrivate(QScatterSeries *q)
: QXYSeriesPrivate(q),
m_shape(QScatterSeries::MarkerShapeCircle)
{
}
void QScatterSeriesPrivate::initializeGraphics(QGraphicsItem* parent)
{
Q_Q(QScatterSeries);
ScatterChartItem *scatter = new ScatterChartItem(q,parent);
m_item.reset(scatter);
QAbstractSeriesPrivate::initializeGraphics(parent);
}
void QScatterSeriesPrivate::initializeTheme(int index, ChartTheme* theme, bool forced)
{
Q_Q(QScatterSeries);
const QList<QColor> colors = theme->seriesColors();
const QList<QGradient> gradients = theme->seriesGradients();
if (forced || QChartPrivate::defaultPen() == m_pen) {
QPen pen;
pen.setColor(ChartThemeManager::colorAt(gradients.at(index % gradients.size()), 0.0));
pen.setWidthF(2);
q->setPen(pen);
}
if (forced || QChartPrivate::defaultBrush() == m_brush) {
QBrush brush(colors.at(index % colors.size()));
q->setBrush(brush);
}
if (forced || QChartPrivate::defaultPen().color() == m_pointLabelsColor) {
QColor color = theme->labelBrush().color();
q->setPointLabelsColor(color);
}
}
void QScatterSeriesPrivate::initializeAnimations(QChart::AnimationOptions options, int duration,
QEasingCurve &curve)
{
ScatterChartItem *item = static_cast<ScatterChartItem *>(m_item.get());
Q_ASSERT(item);
if (item->animation())
item->animation()->stopAndDestroyLater();
if (options.testFlag(QChart::SeriesAnimations))
item->setAnimation(new ScatterAnimation(item, duration, curve));
else
item->setAnimation(0);
// AXIVION Next Line Qt-SkippedBaseMethod: Intentionally skipping QXYSeriesPrivate
QAbstractSeriesPrivate::initializeAnimations(options, duration, curve);
}
QT_END_NAMESPACE
#include "moc_qscatterseries.cpp"