Qt Image Formats

The core Qt Gui library by default supports reading and writing image files of the most common file formats: PNG, JPEG, BMP, GIF and a few more, ref. Reading and Writing Image Files. The Qt Image Formats add-on module provides optional support for other image file formats.

The file format support is provided transparently, through plugins for Qt's image I/O system. As such, this module provides no API of its own. Instead, the functionality is accessed in the same way as other image I/O in Qt: through QImage::load() and QImage::save(). Or, for more detailed control, through QImageReader and QImageWriter.

The Image I/O Plugins

The actual coding and decoding of the file format is done by a codec library. The codec can be Qt or third party code. In case of a third party codec, the build process will look for it among the system libraries. If not found, it may fall back on using a bundled copy (in src/3rdparty).

FormatDescriptionSupport3rd party codec
DDSDirect Draw SurfaceRead/writeNo
ICNSApple Icon ImageRead/writeNo
JP2Joint Photographic Experts Group 2000Read/writeYes (bundled)
MNGMultiple-image Network GraphicsReadYes (bundled)
TGATruevision Graphics AdapterReadNo
TIFFTagged Image File FormatRead/writeYes (bundled)
WBMPWireless BitmapRead/writeNo
WEBPWebPRead/writeYes (bundled)


When built, the Qt Image Formats plugins are located as dynamic libraries in the runtime plugin directory (typically plugins/imageformats), together with the default image format plugins. They may be deployed to the target system in the same way as other plugins, see the Deploying Plugins documentation.

Security considerations

Since these file formats are more rarely used, the codecs may be less thoroughly debugged against potential security holes. As always, care should be taken when creating applications that may be used to decode uncontrolled data files.

© 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.