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

**

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

#define QPICTURE_H

#include <QtCore/qstringlist.h>

#include <QtCore/qsharedpointer.h>

#include <QtGui/qpaintdevice.h>

QT_BEGIN_HEADER

QT_BEGIN_NAMESPACE

QT_MODULE(Gui)

#ifndef QT_NO_PICTURE

class QPicturePrivate;

class Q_GUI_EXPORT QPicture : public QPaintDevice

{

    Q_DECLARE_PRIVATE(QPicture)

public:

    explicit QPicture(int formatVersion = -1);

    QPicture(const QPicture &);

    ~QPicture();

    bool isNull() const;

    int devType() const;

    uint size() const;

    const char* data() const;

    virtual void setData(const char* data, uint size);

    bool play(QPainter *p);

    bool load(QIODevice *dev, const char *format = 0);

    bool load(const QString &fileName, const char *format = 0);

    bool save(QIODevice *dev, const char *format = 0);

    bool save(const QString &fileName, const char *format = 0);

    QRect boundingRect() const;

    void setBoundingRect(const QRect &r);

    QPicture& operator=(const QPicture &p);

    void detach();

    bool isDetached() const;

    friend Q_GUI_EXPORT QDataStream &operator<<(QDataStream &in, const QPicture &p);

    friend Q_GUI_EXPORT QDataStream &operator>>(QDataStream &in, QPicture &p);

    static const char* pictureFormat(const QString &fileName);

    static QList<QByteArray> inputFormats();

    static QList<QByteArray> outputFormats();

    static QStringList inputFormatList();

    static QStringList outputFormatList();

    QPaintEngine *paintEngine() const;

protected:

    QPicture(QPicturePrivate &data);

    int metric(PaintDeviceMetric m) const;

#ifdef QT3_SUPPORT

    inline QT3_SUPPORT QPicture copy() const { QPicture p(*this); p.detach(); return p; }

#endif

private:

    bool exec(QPainter *p, QDataStream &ds, int i);

    void detach_helper();

    QExplicitlySharedDataPointer<QPicturePrivate> d_ptr;

    friend class QPicturePaintEngine;

    friend class Q3Picture;

    friend class QAlphaPaintEngine;

    friend class QPreviewPaintEngine;

public:

    typedef QExplicitlySharedDataPointer<QPicturePrivate> DataPtr;

    inline DataPtr &data_ptr() { return d_ptr; }

};

Q_DECLARE_SHARED(QPicture)

#ifndef QT_NO_PICTUREIO

class QIODevice;

class QPictureIO;

typedef void (*picture_io_handler)(QPictureIO *); // picture IO handler

struct QPictureIOData;

class Q_GUI_EXPORT QPictureIO

{

public:

    QPictureIO();

    QPictureIO(QIODevice *ioDevice, const char *format);

    QPictureIO(const QString &fileName, const char *format);

    ~QPictureIO();

    const QPicture &picture() const;

    int status() const;

    const char *format() const;

    QIODevice *ioDevice() const;

    QString fileName() const;

    int quality() const;

    QString description() const;

    const char *parameters() const;

    float gamma() const;

    void setPicture(const QPicture &);

    void setStatus(int);

    void setFormat(const char *);

    void setIODevice(QIODevice *);

    void setFileName(const QString &);

    void setQuality(int);

    void setDescription(const QString &);

    void setParameters(const char *);

    void setGamma(float);

    bool read();

    bool write();

    static QByteArray pictureFormat(const QString &fileName);

    static QByteArray pictureFormat(QIODevice *);

    static QList<QByteArray> inputFormats();

    static QList<QByteArray> outputFormats();

    static void defineIOHandler(const char *format,

                                const char *header,

                                const char *flags,

                                picture_io_handler read_picture,

                                picture_io_handler write_picture);

private:

    Q_DISABLE_COPY(QPictureIO)

    void init();

    QPictureIOData *d;

};

#endif //QT_NO_PICTUREIO

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

  QPicture stream functions

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

#ifndef QT_NO_DATASTREAM

Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QPicture &);

Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QPicture &);

#endif

#endif // QT_NO_PICTURE

QT_END_NAMESPACE

QT_END_HEADER

#endif // QPICTURE_H