qimageiohandler.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:5k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtGui module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QIMAGEIOHANDLER_H
  38. #define QIMAGEIOHANDLER_H
  39. #include <QtCore/qplugin.h>
  40. #include <QtCore/qfactoryinterface.h>
  41. QT_BEGIN_HEADER
  42. QT_BEGIN_NAMESPACE
  43. QT_MODULE(Gui)
  44. class QImage;
  45. class QRect;
  46. class QSize;
  47. class QVariant;
  48. class QImageIOHandlerPrivate;
  49. class Q_GUI_EXPORT QImageIOHandler
  50. {
  51.     Q_DECLARE_PRIVATE(QImageIOHandler)
  52. public:
  53.     QImageIOHandler();
  54.     virtual ~QImageIOHandler();
  55.     void setDevice(QIODevice *device);
  56.     QIODevice *device() const;
  57.     void setFormat(const QByteArray &format);
  58.     void setFormat(const QByteArray &format) const;
  59.     QByteArray format() const;
  60.     virtual QByteArray name() const;
  61.     virtual bool canRead() const = 0;
  62.     virtual bool read(QImage *image) = 0;
  63.     virtual bool write(const QImage &image);
  64.     enum ImageOption {
  65.         Size,
  66.         ClipRect,
  67.         Description,
  68.         ScaledClipRect,
  69.         ScaledSize,
  70.         CompressionRatio,
  71.         Gamma,
  72.         Quality,
  73.         Name,
  74.         SubType,
  75.         IncrementalReading,
  76.         Endianness,
  77.         Animation,
  78.         BackgroundColor
  79.     };
  80.     virtual QVariant option(ImageOption option) const;
  81.     virtual void setOption(ImageOption option, const QVariant &value);
  82.     virtual bool supportsOption(ImageOption option) const;
  83.     // incremental loading
  84.     virtual bool jumpToNextImage();
  85.     virtual bool jumpToImage(int imageNumber);
  86.     virtual int loopCount() const;
  87.     virtual int imageCount() const;
  88.     virtual int nextImageDelay() const;
  89.     virtual int currentImageNumber() const;
  90.     virtual QRect currentImageRect() const;
  91. protected:
  92.     QImageIOHandler(QImageIOHandlerPrivate &dd);
  93.     QImageIOHandlerPrivate *d_ptr;
  94. private:
  95.     Q_DISABLE_COPY(QImageIOHandler)
  96. };
  97. struct Q_GUI_EXPORT QImageIOHandlerFactoryInterface : public QFactoryInterface
  98. {
  99.     virtual QImageIOHandler *create(QIODevice *device, const QByteArray &format = QByteArray()) const = 0;
  100. };
  101. #define QImageIOHandlerFactoryInterface_iid "com.trolltech.Qt.QImageIOHandlerFactoryInterface"
  102. Q_DECLARE_INTERFACE(QImageIOHandlerFactoryInterface, QImageIOHandlerFactoryInterface_iid)
  103. class Q_GUI_EXPORT QImageIOPlugin : public QObject, public QImageIOHandlerFactoryInterface
  104. {
  105.     Q_OBJECT
  106.     Q_INTERFACES(QImageIOHandlerFactoryInterface:QFactoryInterface)
  107. public:
  108.     explicit QImageIOPlugin(QObject *parent = 0);
  109.     virtual ~QImageIOPlugin();
  110.     enum Capability {
  111.         CanRead = 0x1,
  112.         CanWrite = 0x2,
  113.         CanReadIncremental = 0x4
  114.     };
  115.     Q_DECLARE_FLAGS(Capabilities, Capability)
  116.     virtual Capabilities capabilities(QIODevice *device, const QByteArray &format) const = 0;
  117.     virtual QStringList keys() const = 0;
  118.     virtual QImageIOHandler *create(QIODevice *device, const QByteArray &format = QByteArray()) const = 0;
  119. };
  120. Q_DECLARE_OPERATORS_FOR_FLAGS(QImageIOPlugin::Capabilities)
  121. QT_END_NAMESPACE
  122. QT_END_HEADER
  123. #endif // QIMAGEIOHANDLER_H