#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 MarkerShapeX
    \value MarkerShapeRectangle
    \value MarkerShapeRoundedRectangle
    \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().
*/

QTCOMMERCIALCHART_BEGIN_NAMESPACE

QScatterSeriesPrivate::QScatterSeriesPrivate(QObject *parent) :
    QObject(parent),
    m_data(QList<QPointF>()),
    m_markerPen(QPen(QColor::Invalid)),
    m_markerBrush(QBrush(QColor::Invalid)),
    m_markerShape(QScatterSeries::MarkerShapeDefault),
    m_markerSize(9.0)
{
}

void QScatterSeriesPrivate::emitChanged()
{
    emit changed();
}

#include "moc_scatterseries_p.cpp"

/*!
    Constructs a series object which is a child of \a parent.
*/
QScatterSeries::QScatterSeries(QObject *parent) :
    QSeries(parent),
    d(new QScatterSeriesPrivate(this))
{
}

/*!
    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));
    d->emitChanged();
}

/*!
    Add single data point with \a value to the series.
*/
void QScatterSeries::add(QPointF value)
{
    d->m_data.append(value);
    d->emitChanged();
}

/*!
    Add list of \a points to the series.
*/
void QScatterSeries::add(QList<QPointF> points)
{
    d->m_data.append(points);
    d->emitChanged();
}

/*!
    Stream operator for adding a data point with \a value to the series.
    \sa add()

    For example:
    \snippet ../example/scatter/main.cpp 2
*/
QScatterSeries& QScatterSeries::operator << (const QPointF &value)
{
    d->m_data.append(value);
    d->emitChanged();
    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);
    d->emitChanged();
    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;
    d->emitChanged();
}

/*!
    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);
        d->emitChanged();
        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);
        d->emitChanged();
        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);
    d->emitChanged();
    return count;
}

/*!
    Remove all data points from the series.
*/
void QScatterSeries::clear()
{
    d->m_data.clear();
    d->emitChanged();
}

/*!
    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;
}

/*!
    Returns the pen used for drawing markers.
*/
QPen QScatterSeries::pen() const
{
    return d->m_markerPen;
}

/*!
    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.

    \sa setBrush()
    \sa QChart::setChartTheme()
*/
void QScatterSeries::setPen(const QPen &pen)
{
    d->m_markerPen = pen;
    d->emitChanged();
}

/*!
    Returns the brush used for drawing markers.
*/
QBrush QScatterSeries::brush() const
{
    return d->m_markerBrush;
}

/*!
    Overrides the default brush of the marker items with a user defined \a brush. The default brush
    is defined by chart theme setting.

    \sa setPen()
    \sa QChart::setChartTheme()
*/
void QScatterSeries::setBrush(const QBrush &brush)
{
    d->m_markerBrush = brush;
    d->emitChanged();
}

/*!
    Returns the shape used for drawing markers.
*/
QScatterSeries::MarkerShape QScatterSeries::shape() const
{
    return (QScatterSeries::MarkerShape) d->m_markerShape;
}

/*!
    Overrides the default shape of the marker items with a user defined \a shape. The default shape
    is defined by chart theme setting.
*/
void QScatterSeries::setShape(MarkerShape shape)
{
    d->m_markerShape = shape;
    d->emitChanged();
}

/*!
    Returns the size of the marker items.
*/
qreal QScatterSeries::size() const
{
    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;
    d->emitChanged();
}

#include "moc_qscatterseries.cpp"

QTCOMMERCIALCHART_END_NAMESPACE