← Back to branch summary

~ubuntu-branches/ubuntu/wily/qtbase-opensource-src/wily

« back to all changes in this revision

Viewing changes to src/gui/image/qimageiohandler.h

  • Committer: Package Import Robot
  • Author(s): Timo Jyrinki
  • Date: 2013-02-05 12:46:17 UTC
  • Revision ID: package-import@ubuntu.com-20130205124617-c8jouts182j002fx
Tags: upstream-5.0.1+dfsg
Import upstream version 5.0.1+dfsg

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/gui/image/qimageiohandler.h
 
1
/****************************************************************************
 
2
**
 
3
** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
 
4
** Contact: http://www.qt-project.org/legal
 
5
**
 
6
** This file is part of the QtGui module of the Qt Toolkit.
 
7
**
 
8
** $QT_BEGIN_LICENSE:LGPL$
 
9
** Commercial License Usage
 
10
** Licensees holding valid commercial Qt licenses may use this file in
 
11
** accordance with the commercial license agreement provided with the
 
12
** Software or, alternatively, in accordance with the terms contained in
 
13
** a written agreement between you and Digia.  For licensing terms and
 
14
** conditions see http://qt.digia.com/licensing.  For further information
 
15
** use the contact form at http://qt.digia.com/contact-us.
 
16
**
 
17
** GNU Lesser General Public License Usage
 
18
** Alternatively, this file may be used under the terms of the GNU Lesser
 
19
** General Public License version 2.1 as published by the Free Software
 
20
** Foundation and appearing in the file LICENSE.LGPL included in the
 
21
** packaging of this file.  Please review the following information to
 
22
** ensure the GNU Lesser General Public License version 2.1 requirements
 
23
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
 
24
**
 
25
** In addition, as a special exception, Digia gives you certain additional
 
26
** rights.  These rights are described in the Digia Qt LGPL Exception
 
27
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
 
28
**
 
29
** GNU General Public License Usage
 
30
** Alternatively, this file may be used under the terms of the GNU
 
31
** General Public License version 3.0 as published by the Free Software
 
32
** Foundation and appearing in the file LICENSE.GPL included in the
 
33
** packaging of this file.  Please review the following information to
 
34
** ensure the GNU General Public License version 3.0 requirements will be
 
35
** met: http://www.gnu.org/copyleft/gpl.html.
 
36
**
 
37
**
 
38
** $QT_END_LICENSE$
 
39
**
 
40
****************************************************************************/
 
41
 
 
42
#ifndef QIMAGEIOHANDLER_H
 
43
#define QIMAGEIOHANDLER_H
 
44
 
 
45
#include <QtCore/qplugin.h>
 
46
#include <QtCore/qfactoryinterface.h>
 
47
#include <QtCore/qscopedpointer.h>
 
48
 
 
49
QT_BEGIN_HEADER
 
50
 
 
51
QT_BEGIN_NAMESPACE
 
52
 
 
53
 
 
54
class QImage;
 
55
class QRect;
 
56
class QSize;
 
57
class QVariant;
 
58
 
 
59
class QImageIOHandlerPrivate;
 
60
class Q_GUI_EXPORT QImageIOHandler
 
61
{
 
62
    Q_DECLARE_PRIVATE(QImageIOHandler)
 
63
public:
 
64
    QImageIOHandler();
 
65
    virtual ~QImageIOHandler();
 
66
 
 
67
    void setDevice(QIODevice *device);
 
68
    QIODevice *device() const;
 
69
 
 
70
    void setFormat(const QByteArray &format);
 
71
    void setFormat(const QByteArray &format) const;
 
72
    QByteArray format() const;
 
73
 
 
74
    virtual QByteArray name() const;
 
75
 
 
76
    virtual bool canRead() const = 0;
 
77
    virtual bool read(QImage *image) = 0;
 
78
    virtual bool write(const QImage &image);
 
79
 
 
80
    enum ImageOption {
 
81
        Size,
 
82
        ClipRect,
 
83
        Description,
 
84
        ScaledClipRect,
 
85
        ScaledSize,
 
86
        CompressionRatio,
 
87
        Gamma,
 
88
        Quality,
 
89
        Name,
 
90
        SubType,
 
91
        IncrementalReading,
 
92
        Endianness,
 
93
        Animation,
 
94
        BackgroundColor,
 
95
        ImageFormat
 
96
    };
 
97
    virtual QVariant option(ImageOption option) const;
 
98
    virtual void setOption(ImageOption option, const QVariant &value);
 
99
    virtual bool supportsOption(ImageOption option) const;
 
100
 
 
101
    // incremental loading
 
102
    virtual bool jumpToNextImage();
 
103
    virtual bool jumpToImage(int imageNumber);
 
104
    virtual int loopCount() const;
 
105
    virtual int imageCount() const;
 
106
    virtual int nextImageDelay() const;
 
107
    virtual int currentImageNumber() const;
 
108
    virtual QRect currentImageRect() const;
 
109
 
 
110
protected:
 
111
    QImageIOHandler(QImageIOHandlerPrivate &dd);
 
112
    QScopedPointer<QImageIOHandlerPrivate> d_ptr;
 
113
private:
 
114
    Q_DISABLE_COPY(QImageIOHandler)
 
115
};
 
116
 
 
117
#ifndef QT_NO_IMAGEFORMATPLUGIN
 
118
 
 
119
#define QImageIOHandlerFactoryInterface_iid "org.qt-project.Qt.QImageIOHandlerFactoryInterface"
 
120
 
 
121
class Q_GUI_EXPORT QImageIOPlugin : public QObject
 
122
{
 
123
    Q_OBJECT
 
124
public:
 
125
    explicit QImageIOPlugin(QObject *parent = 0);
 
126
    virtual ~QImageIOPlugin();
 
127
 
 
128
    enum Capability {
 
129
        CanRead = 0x1,
 
130
        CanWrite = 0x2,
 
131
        CanReadIncremental = 0x4
 
132
    };
 
133
    Q_DECLARE_FLAGS(Capabilities, Capability)
 
134
 
 
135
    virtual Capabilities capabilities(QIODevice *device, const QByteArray &format) const = 0;
 
136
    virtual QImageIOHandler *create(QIODevice *device, const QByteArray &format = QByteArray()) const = 0;
 
137
};
 
138
 
 
139
Q_DECLARE_OPERATORS_FOR_FLAGS(QImageIOPlugin::Capabilities)
 
140
 
 
141
#endif // QT_NO_IMAGEFORMATPLUGIN
 
142
 
 
143
QT_END_NAMESPACE
 
144
 
 
145
QT_END_HEADER
 
146
 
 
147
#endif // QIMAGEIOHANDLER_H