1
/****************************************************************************
3
** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
4
** Contact: http://www.qt-project.org/legal
6
** This file is part of the QtGui module of the Qt Toolkit.
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.
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.
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.
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.
40
****************************************************************************/
42
#ifndef QIMAGEREADER_H
43
#define QIMAGEREADER_H
45
#include <QtCore/qbytearray.h>
46
#include <QtGui/qimage.h>
47
#include <QtGui/qimageiohandler.h>
60
class QImageReaderPrivate;
61
class Q_GUI_EXPORT QImageReader
64
enum ImageReaderError {
68
UnsupportedFormatError,
73
explicit QImageReader(QIODevice *device, const QByteArray &format = QByteArray());
74
explicit QImageReader(const QString &fileName, const QByteArray &format = QByteArray());
77
void setFormat(const QByteArray &format);
78
QByteArray format() const;
80
void setAutoDetectImageFormat(bool enabled);
81
bool autoDetectImageFormat() const;
83
void setDecideFormatFromContent(bool ignored);
84
bool decideFormatFromContent() const;
86
void setDevice(QIODevice *device);
87
QIODevice *device() const;
89
void setFileName(const QString &fileName);
90
QString fileName() const;
94
QImage::Format imageFormat() const;
96
QStringList textKeys() const;
97
QString text(const QString &key) const;
99
void setClipRect(const QRect &rect);
100
QRect clipRect() const;
102
void setScaledSize(const QSize &size);
103
QSize scaledSize() const;
105
void setQuality(int quality);
108
void setScaledClipRect(const QRect &rect);
109
QRect scaledClipRect() const;
111
void setBackgroundColor(const QColor &color);
112
QColor backgroundColor() const;
114
bool supportsAnimation() const;
116
bool canRead() const;
118
bool read(QImage *image);
120
bool jumpToNextImage();
121
bool jumpToImage(int imageNumber);
122
int loopCount() const;
123
int imageCount() const;
124
int nextImageDelay() const;
125
int currentImageNumber() const;
126
QRect currentImageRect() const;
128
ImageReaderError error() const;
129
QString errorString() const;
131
bool supportsOption(QImageIOHandler::ImageOption option) const;
133
static QByteArray imageFormat(const QString &fileName);
134
static QByteArray imageFormat(QIODevice *device);
135
static QList<QByteArray> supportedImageFormats();
138
Q_DISABLE_COPY(QImageReader)
139
QImageReaderPrivate *d;
146
#endif // QIMAGEREADER_H