/****************************************************************************

**

** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).

** All rights reserved.

** Contact: Nokia Corporation (qt-info@nokia.com)

**

** This file is part of the QtDeclarative module of the Qt Toolkit.

**

** $QT_BEGIN_LICENSE:LGPL$

** No Commercial Usage

** This file contains pre-release code and may not be distributed.

** You may use this file in accordance with the terms and conditions

** contained in the Technology Preview License Agreement accompanying

** this package.

**

** GNU Lesser General Public License Usage

** Alternatively, this file may be used under the terms of the GNU Lesser

** General Public License version 2.1 as published by the Free Software

** Foundation and appearing in the file LICENSE.LGPL included in the

** packaging of this file.  Please review the following information to

** ensure the GNU Lesser General Public License version 2.1 requirements

** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

**

** In addition, as a special exception, Nokia gives you certain additional

** rights.  These rights are described in the Nokia Qt LGPL Exception

** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

**

** If you have questions regarding the use of this file, please contact

** Nokia at qt-info@nokia.com.

**

**

**

**

**

**

**

**

** $QT_END_LICENSE$

**

****************************************************************************/

#ifndef QDECLARATIVEPATH_H

#define QDECLARATIVEPATH_H

#include "qdeclarativeitem.h"

#include <qdeclarative.h>

#include <QtCore/QObject>

#include <QtGui/QPainterPath>

QT_BEGIN_HEADER

QT_BEGIN_NAMESPACE

QT_MODULE(Declarative)

class Q_AUTOTEST_EXPORT QDeclarativePathElement : public QObject

{

    Q_OBJECT

public:

    QDeclarativePathElement(QObject *parent=0) : QObject(parent) {}

Q_SIGNALS:

    void changed();

};

class Q_AUTOTEST_EXPORT QDeclarativePathAttribute : public QDeclarativePathElement

{

    Q_OBJECT

    Q_PROPERTY(QString name READ name WRITE setName NOTIFY nameChanged)

public:

    QDeclarativePathAttribute(QObject *parent=0) : QDeclarativePathElement(parent), _value(0) {}

    QString name() const;

    void setName(const QString &name);

    qreal value() const;

    void setValue(qreal value);

Q_SIGNALS:

    void nameChanged();

private:

    QString _name;

    qreal _value;

};

class Q_AUTOTEST_EXPORT QDeclarativeCurve : public QDeclarativePathElement

{

    Q_OBJECT

public:

    QDeclarativeCurve(QObject *parent=0) : QDeclarativePathElement(parent), _x(0), _y(0) {}

    qreal x() const;

    void setX(qreal x);

    qreal y() const;

    void setY(qreal y);

    virtual void addToPath(QPainterPath &) {}

private:

    qreal _x;

    qreal _y;

};

class Q_AUTOTEST_EXPORT QDeclarativePathLine : public QDeclarativeCurve

{

    Q_OBJECT

public:

    QDeclarativePathLine(QObject *parent=0) : QDeclarativeCurve(parent) {}

    void addToPath(QPainterPath &path);

};

class Q_AUTOTEST_EXPORT QDeclarativePathQuad : public QDeclarativeCurve

{

    Q_OBJECT

public:

    QDeclarativePathQuad(QObject *parent=0) : QDeclarativeCurve(parent), _controlX(0), _controlY(0) {}

    qreal controlX() const;

    void setControlX(qreal x);

    qreal controlY() const;

    void setControlY(qreal y);

    void addToPath(QPainterPath &path);

private:

    qreal _controlX;

    qreal _controlY;

};

class Q_AUTOTEST_EXPORT QDeclarativePathCubic : public QDeclarativeCurve

{

    Q_OBJECT

public:

    QDeclarativePathCubic(QObject *parent=0) : QDeclarativeCurve(parent), _control1X(0), _control1Y(0), _control2X(0), _control2Y(0) {}

    qreal control1X() const;

    void setControl1X(qreal x);

    qreal control1Y() const;

    void setControl1Y(qreal y);

    qreal control2X() const;

    void setControl2X(qreal x);

    qreal control2Y() const;

    void setControl2Y(qreal y);

    void addToPath(QPainterPath &path);

private:

};

class Q_AUTOTEST_EXPORT QDeclarativePathPercent : public QDeclarativePathElement

{

    Q_OBJECT

public:

    QDeclarativePathPercent(QObject *parent=0) : QDeclarativePathElement(parent) {}

    qreal value() const;

    void setValue(qreal value);

private:

    qreal _value;

};

class QDeclarativePathPrivate;

class Q_AUTOTEST_EXPORT QDeclarativePath : public QObject, public QDeclarativeParserStatus

{

    Q_OBJECT

    Q_INTERFACES(QDeclarativeParserStatus)

    Q_PROPERTY(QDeclarativeListProperty<QDeclarativePathElement> pathElements READ pathElements)

    Q_PROPERTY(qreal startX READ startX WRITE setStartX NOTIFY startXChanged)

    Q_PROPERTY(qreal startY READ startY WRITE setStartY NOTIFY startYChanged)

    Q_PROPERTY(bool closed READ isClosed NOTIFY changed)

    Q_CLASSINFO("DefaultProperty", "pathElements")

    Q_INTERFACES(QDeclarativeParserStatus)

public:

    QDeclarativePath(QObject *parent=0);

    ~QDeclarativePath();

    QDeclarativeListProperty<QDeclarativePathElement> pathElements();

    qreal startX() const;

    void setStartX(qreal x);

    qreal startY() const;

    void setStartY(qreal y);

    bool isClosed() const;

    QPainterPath path() const;

    QStringList attributes() const;

    qreal attributeAt(const QString &, qreal) const;

    QPointF pointAt(qreal) const;

Q_SIGNALS:

    void changed();

    void startXChanged();

    void startYChanged();

protected:

    virtual void componentComplete();

    virtual void classBegin();

private Q_SLOTS:

    void processPath();

private:

    struct AttributePoint {

        AttributePoint() : percent(0), scale(1), origpercent(0) {}

        AttributePoint(const AttributePoint &other)

            : percent(other.percent), scale(other.scale), origpercent(other.origpercent), values(other.values) {}

        AttributePoint &operator=(const AttributePoint &other) {

            percent = other.percent; scale = other.scale; origpercent = other.origpercent; values = other.values; return *this;

        }

        qreal percent;      //massaged percent along the painter path

        qreal scale;

        qreal origpercent;  //'real' percent along the painter path

        QHash<QString, qreal> values;

    };

    void interpolate(int idx, const QString &name, qreal value);

    void endpoint(const QString &name);

    void createPointCache() const;

private:

    Q_DISABLE_COPY(QDeclarativePath)

    Q_DECLARE_PRIVATE(QDeclarativePath)

};

QT_END_NAMESPACE

QML_DECLARE_TYPE(QDeclarativePathElement)

QML_DECLARE_TYPE(QDeclarativePathAttribute)

QML_DECLARE_TYPE(QDeclarativeCurve)

QML_DECLARE_TYPE(QDeclarativePathLine)

QML_DECLARE_TYPE(QDeclarativePathQuad)

QML_DECLARE_TYPE(QDeclarativePathCubic)

QML_DECLARE_TYPE(QDeclarativePathPercent)

QML_DECLARE_TYPE(QDeclarativePath)

QT_END_HEADER

#endif // QDECLARATIVEPATH_H