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

**

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

** All rights reserved.

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

**

** This file is part of the QtGui 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 QPAINTENGINEEX_P_H

#define QPAINTENGINEEX_P_H

//

//  W A R N I N G

//  -------------

//

// This file is not part of the Qt API.  It exists purely as an

// implementation detail.  This header file may change from version to

// version without notice, or even be removed.

//

// We mean it.

//

#include <QtGui/qpaintengine.h>

#include <QtGui/qdrawutil.h>

#include <private/qpaintengine_p.h>

#include <private/qstroker_p.h>

#include <private/qpainter_p.h>

#include <private/qvectorpath_p.h>

QT_BEGIN_HEADER

QT_BEGIN_NAMESPACE

QT_MODULE(Gui)

class QPainterState;

class QPaintEngineExPrivate;

struct StrokeHandler;

struct QIntRect {

    int x1, y1, x2, y2;

    inline void set(const QRect &r) {

        x1 = r.x();

        y1 = r.y();

        x2 = r.right() + 1;

        y2 = r.bottom() + 1;

        // We will assume normalized for later...

        Q_ASSERT(x2 >= x1);

        Q_ASSERT(y2 >= y1);

    }

};

class QRectVectorPath : public QVectorPath {

public:

    inline void set(const QRect &r) {

        qreal left = r.x();

        qreal right = r.x() + r.width();

        qreal top = r.y();

        qreal bottom = r.y() + r.height();

        pts[0] = left;

        pts[1] = top;

        pts[2] = right;

        pts[3] = top;

        pts[4] = right;

        pts[5] = bottom;

        pts[6] = left;

        pts[7] = bottom;

    }

    inline void set(const QRectF &r) {

        qreal left = r.x();

        qreal right = r.x() + r.width();

        qreal top = r.y();

        qreal bottom = r.y() + r.height();

        pts[0] = left;

        pts[1] = top;

        pts[2] = right;

        pts[3] = top;

        pts[4] = right;

        pts[5] = bottom;

        pts[6] = left;

        pts[7] = bottom;

    }

    inline QRectVectorPath(const QRect &r)

        : QVectorPath(pts, 4, 0, QVectorPath::RectangleHint | QVectorPath::ImplicitClose)

    {

        set(r);

    }

    inline QRectVectorPath(const QRectF &r)

        : QVectorPath(pts, 4, 0, QVectorPath::RectangleHint | QVectorPath::ImplicitClose)

    {

        set(r);

    }

    inline QRectVectorPath()

        : QVectorPath(pts, 4, 0, QVectorPath::RectangleHint | QVectorPath::ImplicitClose)

    { }

    qreal pts[8];

};

#ifndef QT_NO_DEBUG_STREAM

QDebug Q_GUI_EXPORT &operator<<(QDebug &, const QVectorPath &path);

#endif

class QPixmapFilter;

class Q_GUI_EXPORT QPaintEngineEx : public QPaintEngine

{

    Q_DECLARE_PRIVATE(QPaintEngineEx)

public:

    QPaintEngineEx();

    virtual QPainterState *createState(QPainterState *orig) const;

    virtual void draw(const QVectorPath &path);

    virtual void fill(const QVectorPath &path, const QBrush &brush) = 0;

    virtual void stroke(const QVectorPath &path, const QPen &pen);

    virtual void clip(const QVectorPath &path, Qt::ClipOperation op) = 0;

    virtual void clip(const QRect &rect, Qt::ClipOperation op);

    virtual void clip(const QRegion &region, Qt::ClipOperation op);

    virtual void clip(const QPainterPath &path, Qt::ClipOperation op);

    virtual void clipEnabledChanged() = 0;

    virtual void penChanged() = 0;

    virtual void brushChanged() = 0;

    virtual void brushOriginChanged() = 0;

    virtual void opacityChanged() = 0;

    virtual void compositionModeChanged() = 0;

    virtual void renderHintsChanged() = 0;

    virtual void transformChanged() = 0;

    virtual void fillRect(const QRectF &rect, const QBrush &brush);

    virtual void fillRect(const QRectF &rect, const QColor &color);

    virtual void drawRoundedRect(const QRectF &rect, qreal xrad, qreal yrad, Qt::SizeMode mode);

    virtual void drawRects(const QRect *rects, int rectCount);

    virtual void drawRects(const QRectF *rects, int rectCount);

    virtual void drawLines(const QLine *lines, int lineCount);

    virtual void drawLines(const QLineF *lines, int lineCount);

    virtual void drawEllipse(const QRectF &r);

    virtual void drawEllipse(const QRect &r);

    virtual void drawPath(const QPainterPath &path);

    virtual void drawPoints(const QPointF *points, int pointCount);

    virtual void drawPoints(const QPoint *points, int pointCount);

    virtual void drawPolygon(const QPointF *points, int pointCount, PolygonDrawMode mode);

    virtual void drawPolygon(const QPoint *points, int pointCount, PolygonDrawMode mode);

    virtual void drawPixmap(const QRectF &r, const QPixmap &pm, const QRectF &sr) = 0;

    virtual void drawPixmap(const QPointF &pos, const QPixmap &pm);

    virtual void drawImage(const QRectF &r, const QImage &pm, const QRectF &sr,

                           Qt::ImageConversionFlags flags = Qt::AutoColor) = 0;

    virtual void drawImage(const QPointF &pos, const QImage &image);

    virtual void drawTiledPixmap(const QRectF &r, const QPixmap &pixmap, const QPointF &s);

    virtual void drawPixmaps(const QDrawPixmaps::Data *drawingData, int dataCount, const QPixmap &pixmap, QFlags<QDrawPixmaps::DrawingHint> hints);

    virtual void updateState(const QPaintEngineState &state);

    virtual void setState(QPainterState *s);

    inline QPainterState *state() { return static_cast<QPainterState *>(QPaintEngine::state); }

    inline const QPainterState *state() const { return static_cast<const QPainterState *>(QPaintEngine::state); }

    virtual void sync() {}

    virtual void beginNativePainting() {}

    virtual void endNativePainting() {}

    // Return a pixmap filter of "type" that can render the parameters

    // in "prototype".  The returned filter is owned by the engine and

    // will be destroyed when the engine is destroyed.  The "prototype"

    // allows the engine to pick different filters based on the parameters

    // that will be requested, and not just the "type".

    virtual QPixmapFilter *pixmapFilter(int /*type*/, const QPixmapFilter * /*prototype*/) { return 0; }

    // These flags are needed in the implementation of paint buffers.

    enum Flags

    {

        DoNotEmulate = 0x01,        // If set, QPainter will not wrap this engine in an emulation engine.

        IsEmulationEngine = 0x02    // If set, this object is a QEmulationEngine.

    };

    virtual uint flags() const {return 0;}

protected:

    QPaintEngineEx(QPaintEngineExPrivate &data);

};

class Q_GUI_EXPORT QPaintEngineExPrivate : public QPaintEnginePrivate

{

    Q_DECLARE_PUBLIC(QPaintEngineEx)

public:

    QPaintEngineExPrivate();

    ~QPaintEngineExPrivate();

    void replayClipOperations();

    bool hasClipOperations() const;

    QStroker stroker;

    QDashStroker dasher;

    StrokeHandler *strokeHandler;

    QStrokerOps *activeStroker;

    QPen strokerPen;

    QRect exDeviceRect;

};

inline uint QVectorPath::polygonFlags(QPaintEngine::PolygonDrawMode mode) {

    switch (mode) {

    case QPaintEngine::ConvexMode: return ConvexPolygonHint | ImplicitClose;

    case QPaintEngine::OddEvenMode: return NonCurvedShapeHint | OddEvenFill | ImplicitClose;

    case QPaintEngine::WindingMode: return NonCurvedShapeHint | WindingFill | ImplicitClose;

    case QPaintEngine::PolylineMode: return NonCurvedShapeHint;

    default: return 0;

    }

}

QT_END_NAMESPACE

QT_END_HEADER

#endif