qimage.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:13k
- /****************************************************************************
- **
- ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
- ** Contact: Qt Software Information (qt-info@nokia.com)
- **
- ** This file is part of the QtGui module of the Qt Toolkit.
- **
- ** Commercial Usage
- ** Licensees holding valid Qt Commercial licenses may use this file in
- ** accordance with the Qt Commercial License Agreement provided with the
- ** Software or, alternatively, in accordance with the terms contained in
- ** a written agreement between you and Nokia.
- **
- **
- ** GNU General Public License Usage
- ** Alternatively, this file may be used under the terms of the GNU
- ** General Public License versions 2.0 or 3.0 as published by the Free
- ** Software Foundation and appearing in the file LICENSE.GPL included in
- ** the packaging of this file. Please review the following information
- ** to ensure GNU General Public Licensing requirements will be met:
- ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
- ** http://www.gnu.org/copyleft/gpl.html. In addition, as a special
- ** exception, Nokia gives you certain additional rights. These rights
- ** are described in the Nokia Qt GPL Exception version 1.3, included in
- ** the file GPL_EXCEPTION.txt in this package.
- **
- ** Qt for Windows(R) Licensees
- ** As a special exception, Nokia, as the sole copyright holder for Qt
- ** Designer, grants users of the Qt/Eclipse Integration plug-in the
- ** right for the Qt/Eclipse Integration to link to functionality
- ** provided by Qt Designer and its related libraries.
- **
- ** If you are unsure which license is appropriate for your use, please
- ** contact the sales department at qt-sales@nokia.com.
- **
- ****************************************************************************/
- #ifndef QIMAGE_H
- #define QIMAGE_H
- #include <QtGui/qtransform.h>
- #include <QtGui/qpaintdevice.h>
- #include <QtGui/qrgb.h>
- #include <QtCore/qbytearray.h>
- #include <QtCore/qrect.h>
- #include <QtCore/qstring.h>
- QT_BEGIN_HEADER
- QT_BEGIN_NAMESPACE
- QT_MODULE(Gui)
- class QIODevice;
- class QStringList;
- class QMatrix;
- class QTransform;
- class QVariant;
- template <class T> class QList;
- template <class T> class QVector;
- struct QImageData;
- class QImageDataMisc; // internal
- #ifndef QT_NO_IMAGE_TEXT
- class Q_GUI_EXPORT QImageTextKeyLang {
- public:
- QImageTextKeyLang(const char* k, const char* l) : key(k), lang(l) { }
- QImageTextKeyLang() { }
- QByteArray key;
- QByteArray lang;
- bool operator< (const QImageTextKeyLang& other) const
- { return key < other.key || (key==other.key && lang < other.lang); }
- bool operator== (const QImageTextKeyLang& other) const
- { return key==other.key && lang==other.lang; }
- inline bool operator!= (const QImageTextKeyLang &other) const
- { return !operator==(other); }
- };
- #endif //QT_NO_IMAGE_TEXT
- class Q_GUI_EXPORT QImage : public QPaintDevice
- {
- public:
- enum InvertMode { InvertRgb, InvertRgba };
- enum Format {
- Format_Invalid,
- Format_Mono,
- Format_MonoLSB,
- Format_Indexed8,
- Format_RGB32,
- Format_ARGB32,
- Format_ARGB32_Premultiplied,
- Format_RGB16,
- Format_ARGB8565_Premultiplied,
- Format_RGB666,
- Format_ARGB6666_Premultiplied,
- Format_RGB555,
- Format_ARGB8555_Premultiplied,
- Format_RGB888,
- Format_RGB444,
- Format_ARGB4444_Premultiplied,
- #if 0
- // reserved for future use
- Format_RGB15,
- Format_Grayscale16,
- Format_Grayscale8,
- Format_Grayscale4,
- Format_Grayscale4LSB,
- Format_Grayscale2,
- Format_Grayscale2LSB
- #endif
- #ifndef qdoc
- NImageFormats
- #endif
- };
- QImage();
- QImage(const QSize &size, Format format);
- QImage(int width, int height, Format format);
- QImage(uchar *data, int width, int height, Format format);
- QImage(const uchar *data, int width, int height, Format format);
- QImage(uchar *data, int width, int height, int bytesPerLine, Format format);
- QImage(const uchar *data, int width, int height, int bytesPerLine, Format format);
- #ifndef QT_NO_IMAGEFORMAT_XPM
- explicit QImage(const char * const xpm[]);
- #endif
- explicit QImage(const QString &fileName, const char *format = 0);
- #ifndef QT_NO_CAST_FROM_ASCII
- explicit QImage(const char *fileName, const char *format = 0);
- #endif
- QImage(const QImage &);
- ~QImage();
- QImage &operator=(const QImage &);
- bool isNull() const;
- int devType() const;
- bool operator==(const QImage &) const;
- bool operator!=(const QImage &) const;
- operator QVariant() const;
- void detach();
- bool isDetached() const;
- QImage copy(const QRect &rect = QRect()) const;
- inline QImage copy(int x, int y, int w, int h) const
- { return copy(QRect(x, y, w, h)); }
- Format format() const;
- QImage convertToFormat(Format f, Qt::ImageConversionFlags flags = Qt::AutoColor) const Q_REQUIRED_RESULT;
- QImage convertToFormat(Format f, const QVector<QRgb> &colorTable, Qt::ImageConversionFlags flags = Qt::AutoColor) const Q_REQUIRED_RESULT;
- int width() const;
- int height() const;
- QSize size() const;
- QRect rect() const;
- int depth() const;
- int numColors() const;
- QRgb color(int i) const;
- void setColor(int i, QRgb c);
- void setNumColors(int);
- bool allGray() const;
- bool isGrayscale() const;
- uchar *bits();
- const uchar *bits() const;
- int numBytes() const;
- uchar *scanLine(int);
- const uchar *scanLine(int) const;
- int bytesPerLine() const;
- bool valid(int x, int y) const;
- bool valid(const QPoint &pt) const;
- int pixelIndex(int x, int y) const;
- int pixelIndex(const QPoint &pt) const;
- QRgb pixel(int x, int y) const;
- QRgb pixel(const QPoint &pt) const;
- void setPixel(int x, int y, uint index_or_rgb);
- void setPixel(const QPoint &pt, uint index_or_rgb);
- QVector<QRgb> colorTable() const;
- void setColorTable(const QVector<QRgb> colors);
- void fill(uint pixel);
- bool hasAlphaChannel() const;
- void setAlphaChannel(const QImage &alphaChannel);
- QImage alphaChannel() const;
- QImage createAlphaMask(Qt::ImageConversionFlags flags = Qt::AutoColor) const;
- #ifndef QT_NO_IMAGE_HEURISTIC_MASK
- QImage createHeuristicMask(bool clipTight = true) const;
- #endif
- QImage createMaskFromColor(QRgb color, Qt::MaskMode mode = Qt::MaskInColor) const;
- inline QImage scaled(int w, int h, Qt::AspectRatioMode aspectMode = Qt::IgnoreAspectRatio,
- Qt::TransformationMode mode = Qt::FastTransformation) const
- { return scaled(QSize(w, h), aspectMode, mode); }
- QImage scaled(const QSize &s, Qt::AspectRatioMode aspectMode = Qt::IgnoreAspectRatio,
- Qt::TransformationMode mode = Qt::FastTransformation) const;
- QImage scaledToWidth(int w, Qt::TransformationMode mode = Qt::FastTransformation) const;
- QImage scaledToHeight(int h, Qt::TransformationMode mode = Qt::FastTransformation) const;
- QImage transformed(const QMatrix &matrix, Qt::TransformationMode mode = Qt::FastTransformation) const;
- static QMatrix trueMatrix(const QMatrix &, int w, int h);
- QImage transformed(const QTransform &matrix, Qt::TransformationMode mode = Qt::FastTransformation) const;
- static QTransform trueMatrix(const QTransform &, int w, int h);
- QImage mirrored(bool horizontally = false, bool vertically = true) const;
- QImage rgbSwapped() const;
- void invertPixels(InvertMode = InvertRgb);
- bool load(QIODevice *device, const char* format);
- bool load(const QString &fileName, const char* format=0);
- bool loadFromData(const uchar *buf, int len, const char *format = 0);
- inline bool loadFromData(const QByteArray &data, const char* aformat=0)
- { return loadFromData(reinterpret_cast<const uchar *>(data.constData()), data.size(), aformat); }
- bool save(const QString &fileName, const char* format=0, int quality=-1) const;
- bool save(QIODevice *device, const char* format=0, int quality=-1) const;
- static QImage fromData(const uchar *data, int size, const char *format = 0);
- inline static QImage fromData(const QByteArray &data, const char *format = 0)
- { return fromData(reinterpret_cast<const uchar *>(data.constData()), data.size(), format); }
- int serialNumber() const;
- qint64 cacheKey() const;
- QPaintEngine *paintEngine() const;
- // Auxiliary data
- int dotsPerMeterX() const;
- int dotsPerMeterY() const;
- void setDotsPerMeterX(int);
- void setDotsPerMeterY(int);
- QPoint offset() const;
- void setOffset(const QPoint&);
- #ifndef QT_NO_IMAGE_TEXT
- QStringList textKeys() const;
- QString text(const QString &key = QString()) const;
- void setText(const QString &key, const QString &value);
- // The following functions are obsolete as of 4.1
- QString text(const char* key, const char* lang=0) const;
- QList<QImageTextKeyLang> textList() const;
- QStringList textLanguages() const;
- QString text(const QImageTextKeyLang&) const;
- void setText(const char* key, const char* lang, const QString&);
- #endif
- #ifdef QT3_SUPPORT
- enum Endian { BigEndian, LittleEndian, IgnoreEndian };
- QT3_SUPPORT_CONSTRUCTOR QImage(int width, int height, int depth, int numColors=0, Endian bitOrder=IgnoreEndian);
- QT3_SUPPORT_CONSTRUCTOR QImage(const QSize&, int depth, int numColors=0, Endian bitOrder=IgnoreEndian);
- QT3_SUPPORT_CONSTRUCTOR QImage(uchar *data, int w, int h, int depth, const QRgb *colortable, int numColors, Endian bitOrder);
- #ifdef Q_WS_QWS
- QT3_SUPPORT_CONSTRUCTOR QImage(uchar *data, int w, int h, int depth, int pbl, const QRgb *colortable, int numColors, Endian bitOrder);
- #endif
- inline QT3_SUPPORT Endian bitOrder() const {
- Format f = format();
- return f == Format_Mono ? BigEndian : (f == Format_MonoLSB ? LittleEndian : IgnoreEndian);
- }
- QT3_SUPPORT QImage convertDepth(int, Qt::ImageConversionFlags flags = Qt::AutoColor) const;
- QT3_SUPPORT QImage convertDepthWithPalette(int, QRgb* p, int pc, Qt::ImageConversionFlags flags = Qt::AutoColor) const;
- QT3_SUPPORT QImage convertBitOrder(Endian) const;
- QT3_SUPPORT bool hasAlphaBuffer() const;
- QT3_SUPPORT void setAlphaBuffer(bool);
- QT3_SUPPORT uchar **jumpTable();
- QT3_SUPPORT const uchar * const *jumpTable() const;
- inline QT3_SUPPORT void reset() { *this = QImage(); }
- static inline QT3_SUPPORT Endian systemByteOrder()
- { return QSysInfo::ByteOrder == QSysInfo::BigEndian ? BigEndian : LittleEndian; }
- inline QT3_SUPPORT QImage swapRGB() const { return rgbSwapped(); }
- inline QT3_SUPPORT QImage mirror(bool horizontally = false, bool vertically = true) const
- { return mirrored(horizontally, vertically); }
- QT3_SUPPORT bool create(const QSize&, int depth, int numColors=0, Endian bitOrder=IgnoreEndian);
- QT3_SUPPORT bool create(int width, int height, int depth, int numColors=0, Endian bitOrder=IgnoreEndian);
- inline QT3_SUPPORT QImage xForm(const QMatrix &matrix) const { return transformed(QTransform(matrix)); }
- inline QT3_SUPPORT QImage smoothScale(int w, int h, Qt::AspectRatioMode mode = Qt::IgnoreAspectRatio) const
- { return scaled(QSize(w, h), mode, Qt::SmoothTransformation); }
- inline QImage QT3_SUPPORT smoothScale(const QSize &s, Qt::AspectRatioMode mode = Qt::IgnoreAspectRatio) const
- { return scaled(s, mode, Qt::SmoothTransformation); }
- inline QT3_SUPPORT QImage scaleWidth(int w) const { return scaledToWidth(w); }
- inline QT3_SUPPORT QImage scaleHeight(int h) const { return scaledToHeight(h); }
- inline QT3_SUPPORT void invertPixels(bool invertAlpha) { invertAlpha ? invertPixels(InvertRgba) : invertPixels(InvertRgb); }
- inline QT3_SUPPORT QImage copy(int x, int y, int w, int h, Qt::ImageConversionFlags) const
- { return copy(QRect(x, y, w, h)); }
- inline QT3_SUPPORT QImage copy(const QRect &rect, Qt::ImageConversionFlags) const
- { return copy(rect); }
- static QT3_SUPPORT Endian systemBitOrder();
- inline QT3_SUPPORT_CONSTRUCTOR QImage(const QByteArray &data)
- { d = 0; *this = QImage::fromData(data); }
- #endif
- protected:
- virtual int metric(PaintDeviceMetric metric) const;
- private:
- friend class QWSOnScreenSurface;
- QImageData *d;
- friend class QRasterPixmapData;
- friend class QDetachedPixmap;
- friend Q_GUI_EXPORT qint64 qt_image_id(const QImage &image);
- friend const QVector<QRgb> *qt_image_colortable(const QImage &image);
- public:
- typedef QImageData * DataPtr;
- inline DataPtr &data_ptr() { return d; }
- };
- Q_DECLARE_SHARED(QImage)
- Q_DECLARE_TYPEINFO(QImage, Q_MOVABLE_TYPE);
- // Inline functions...
- Q_GUI_EXPORT_INLINE bool QImage::valid(const QPoint &pt) const { return valid(pt.x(), pt.y()); }
- Q_GUI_EXPORT_INLINE int QImage::pixelIndex(const QPoint &pt) const { return pixelIndex(pt.x(), pt.y());}
- Q_GUI_EXPORT_INLINE QRgb QImage::pixel(const QPoint &pt) const { return pixel(pt.x(), pt.y()); }
- Q_GUI_EXPORT_INLINE void QImage::setPixel(const QPoint &pt, uint index_or_rgb) { setPixel(pt.x(), pt.y(), index_or_rgb); }
- // QImage stream functions
- #if !defined(QT_NO_DATASTREAM)
- Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QImage &);
- Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QImage &);
- #endif
- #ifdef QT3_SUPPORT
- Q_GUI_EXPORT QT3_SUPPORT void bitBlt(QImage* dst, int dx, int dy, const QImage* src,
- int sx=0, int sy=0, int sw=-1, int sh=-1, Qt::ImageConversionFlags flags = Qt::AutoColor);
- #endif
- QT_END_NAMESPACE
- QT_END_HEADER
- #endif // QIMAGE_H