Note: All functions in this class are reentrant.
|QImageIOPlugin(QObject * parent = 0)|
|virtual Capabilities||capabilities(QIODevice * device, const QByteArray & format) const = 0|
Reimplemented Public Functions
|virtual QImageIOHandler *||create(QIODevice * device, const QByteArray & format = QByteArray()) const = 0|
|virtual QStringList||keys() const = 0|
- 29 public functions inherited from QObject
Additional Inherited Members
- 1 property inherited from QObject
- 1 public slot inherited from QObject
- 1 signal inherited from QObject
- 7 static public members inherited from QObject
- 8 protected functions inherited from QObject
The QImageIOPlugin class defines an interface for writing an image format plugin.
Writing an image I/O plugin is achieved by subclassing this base class, reimplementing the pure virtual functions capabilities(), create(), and keys(), and exporting the class with the Q_EXPORT_PLUGIN2() macro. See How to Create Qt Plugins for details.
An image format plugin can support three capabilities: reading (CanRead), writing (CanWrite) and incremental reading (CanReadIncremental). Reimplement capabilities() in you subclass to expose the capabilities of your image format.
create() should create an instance of your QImageIOHandler subclass, with the provided device and format properly set, and return this handler. You must also reimplement keys() so that Qt knows which image formats your plugin supports.
Different plugins can support different capabilities. For example, you may have one plugin that supports reading the GIF format, and another that supports writing. Qt will select the correct plugin for the job, depending on the return value of capabilities(). If several plugins support the same capability, Qt will select one arbitrarily.
Member Type Documentation
This enum describes the capabilities of a QImageIOPlugin.
|The plugin can read images.|
|The plugin can write images.|
|The plugin can read images incrementally.|
The Capabilities type is a typedef for QFlags<Capability>. It stores an OR combination of Capability values.
Member Function Documentation
QImageIOPlugin::QImageIOPlugin(QObject * parent = 0)
Constructs an image plugin with the given parent. This is invoked automatically by the Q_EXPORT_PLUGIN2() macro.
Destroys the picture format plugin.
You never have to call this explicitly. Qt destroys a plugin automatically when it is no longer used.
[pure virtual] Capabilities QImageIOPlugin::capabilities(QIODevice * device, const QByteArray & format) const
Returns the capabilities on the plugin, based on the data in device and the format format. For example, if the QImageIOHandler supports the BMP format, and the data in the device starts with the characters "BM", this function should return CanRead. If format is "bmp" and the handler supports both reading and writing, this function should return CanRead | CanWrite.
[pure virtual] QImageIOHandler * QImageIOPlugin::create(QIODevice * device, const QByteArray & format = QByteArray()) const
See also keys().
[pure virtual] QStringList QImageIOPlugin::keys() const
Returns the list of image keys this plugin supports.
These keys are usually the names of the image formats that are implemented in the plugin (e.g., "jpg" or "gif").
See also capabilities().
© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.