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

**

** 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 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 QDRAWUTIL_H

#define QDRAWUTIL_H

#include <QtCore/qnamespace.h>

#include <QtCore/qstring.h> // char*->QString conversion

#include <QtCore/qmargins.h>

#include <QtGui/qpixmap.h>

QT_BEGIN_HEADER

QT_BEGIN_NAMESPACE

QT_MODULE(Gui)

class QPainter;

#ifndef QT3_SUPPORT

class QColorGroup;

#endif

class QPalette;

class QPoint;

class QColor;

class QBrush;

class QRect;

//

// Standard shade drawing

//

Q_GUI_EXPORT void qDrawShadeLine(QPainter *p, int x1, int y1, int x2, int y2,

                              const QPalette &pal, bool sunken = true,

                              int lineWidth = 1, int midLineWidth = 0);

Q_GUI_EXPORT void qDrawShadeLine(QPainter *p, const QPoint &p1, const QPoint &p2,

                              const QPalette &pal, bool sunken = true,

                              int lineWidth = 1, int midLineWidth = 0);

Q_GUI_EXPORT void qDrawShadeRect(QPainter *p, int x, int y, int w, int h,

                              const QPalette &pal, bool sunken = false,

                              int lineWidth = 1, int midLineWidth = 0,

                              const QBrush *fill = 0);

Q_GUI_EXPORT void qDrawShadeRect(QPainter *p, const QRect &r,

                              const QPalette &pal, bool sunken = false,

                              int lineWidth = 1, int midLineWidth = 0,

                              const QBrush *fill = 0);

Q_GUI_EXPORT void qDrawShadePanel(QPainter *p, int x, int y, int w, int h,

                               const QPalette &pal, bool sunken = false,

                               int lineWidth = 1, const QBrush *fill = 0);

Q_GUI_EXPORT void qDrawShadePanel(QPainter *p, const QRect &r,

                               const QPalette &pal, bool sunken = false,

                               int lineWidth = 1, const QBrush *fill = 0);

Q_GUI_EXPORT void qDrawWinButton(QPainter *p, int x, int y, int w, int h,

                              const QPalette &pal, bool sunken = false,

                              const QBrush *fill = 0);

Q_GUI_EXPORT void qDrawWinButton(QPainter *p, const QRect &r,

                              const QPalette &pal, bool sunken = false,

                              const QBrush *fill = 0);

Q_GUI_EXPORT void qDrawWinPanel(QPainter *p, int x, int y, int w, int h,

                              const QPalette &pal, bool sunken = false,

                             const QBrush *fill = 0);

Q_GUI_EXPORT void qDrawWinPanel(QPainter *p, const QRect &r,

                              const QPalette &pal, bool sunken = false,

                             const QBrush *fill = 0);

Q_GUI_EXPORT void qDrawPlainRect(QPainter *p, int x, int y, int w, int h, const QColor &,

                              int lineWidth = 1, const QBrush *fill = 0);

Q_GUI_EXPORT void qDrawPlainRect(QPainter *p, const QRect &r, const QColor &,

                              int lineWidth = 1, const QBrush *fill = 0);

#ifdef QT3_SUPPORT

//

// Use QStyle::itemRect(), QStyle::drawItem() and QStyle::drawArrow() instead.

//

Q_GUI_EXPORT QT3_SUPPORT QRect qItemRect(QPainter *p, Qt::GUIStyle gs, int x, int y, int w, int h,

                          int flags, bool enabled,

                          const QPixmap *pixmap, const QString& text, int len=-1);

Q_GUI_EXPORT QT3_SUPPORT void qDrawItem(QPainter *p, Qt::GUIStyle gs, int x, int y, int w, int h,

                         int flags, const QPalette &pal, bool enabled,

                         const QPixmap *pixmap, const QString& text,

                         int len=-1, const QColor* penColor = 0);

Q_GUI_EXPORT QT3_SUPPORT void qDrawArrow(QPainter *p, Qt::ArrowType type, Qt::GUIStyle style, bool down,

                          int x, int y, int w, int h,

                          const QPalette &pal, bool enabled);

#endif

struct QTileRules

{

    inline QTileRules(Qt::TileRule horizontalRule, Qt::TileRule verticalRule)

            : horizontal(horizontalRule), vertical(verticalRule) {}

    inline QTileRules(Qt::TileRule rule = Qt::StretchTile)

            : horizontal(rule), vertical(rule) {}

    Qt::TileRule horizontal;

    Qt::TileRule vertical;

};

#ifndef Q_QDOC

// For internal use only.

namespace QDrawBorderPixmap

{

    enum DrawingHint

    {

        OpaqueTopLeft = 0x0001,

        OpaqueTop = 0x0002,

        OpaqueTopRight = 0x0004,

        OpaqueLeft = 0x0008,

        OpaqueCenter = 0x0010,

        OpaqueRight = 0x0020,

        OpaqueBottomLeft = 0x0040,

        OpaqueBottom = 0x0080,

        OpaqueBottomRight = 0x0100,

        OpaqueCorners = OpaqueTopLeft | OpaqueTopRight | OpaqueBottomLeft | OpaqueBottomRight,

        OpaqueEdges = OpaqueTop | OpaqueLeft | OpaqueRight | OpaqueBottom,

        OpaqueFrame = OpaqueCorners | OpaqueEdges,

        OpaqueAll = OpaqueCenter | OpaqueFrame

    };

    Q_DECLARE_FLAGS(DrawingHints, DrawingHint)

}

#endif

Q_GUI_EXPORT void qDrawBorderPixmap(QPainter *painter,

                                    const QRect &targetRect,

                                    const QMargins &targetMargins,

                                    const QPixmap &pixmap,

                                    const QRect &sourceRect,

                                    const QMargins &sourceMargins,

                                    const QTileRules &rules = QTileRules()

#ifndef Q_QDOC

                                    , QDrawBorderPixmap::DrawingHints hints = 0

#endif

                                    );

inline void qDrawBorderPixmap(QPainter *painter,

                                           const QRect &target,

                                           const QMargins &margins,

                                           const QPixmap &pixmap)

{

    qDrawBorderPixmap(painter, target, margins, pixmap, pixmap.rect(), margins);

}

// For internal use only.

namespace QDrawPixmaps

{

    struct Data

    {

        QPointF point;

        QRectF source;

        qreal scaleX;

        qreal scaleY;

        qreal rotation;

        qreal opacity;

    };

    enum DrawingHint

    {

        OpaqueHint = 0x01

    };

    Q_DECLARE_FLAGS(DrawingHints, DrawingHint)

}

// This function is private and may change without notice. Do not use outside Qt!!!

Q_GUI_EXPORT void qDrawPixmaps(QPainter *painter, const QDrawPixmaps::Data *drawingData,

                               int dataCount, const QPixmap &pixmap, QDrawPixmaps::DrawingHints hints = 0);

QT_END_NAMESPACE

QT_END_HEADER

#endif // QDRAWUTIL_H