frameworks/kimageformats/README.md

0001 # KImageFormats
0002
0003 Plugins to allow QImage to support extra file formats.
0004
0005 ## Introduction
0006
0007 This framework provides additional image format plugins for QtGui.  As
0008 such it is not required for the compilation of any other software, but
0009 may be a runtime requirement for Qt-based software to support certain
0010 image formats.
0011
0012 ## Formats
0013
0014 The following image formats have read-only support:
0015
0016 - Animated Windows cursors (ani)
0017 - Gimp (xcf)
0018 - OpenEXR (exr)
0019 - Photoshop documents (psd, psb, pdd, psdt)
0020 - Sun Raster (ras)
0021 - Camera RAW images (arw, cr2, cr3, dcs, dng, ...)
0022
0023 The following image formats have read and write support:
0024
0025 - AV1 Image File Format (AVIF)
0026 - Encapsulated PostScript (eps)
0027 - JPEG XL (jxl)
0028 - Personal Computer Exchange (pcx)
0029 - SGI images (rgb, rgba, sgi, bw)
0030 - Softimage PIC (pic)
0031 - Targa (tga): supports more formats than Qt's version
0032 - XView (xv)
0033
0034 ## Contributing
0035
0036 See the QImageIOPlugin documentation for information on how to write a
0037 new plugin.
0038
0039 The main difference between this framework and the qimageformats module
0040 of Qt is the license.  As such, if you write an imageformat plugin and
0041 you are willing to sign the Qt Project contributor agreement, it may be
0042 better to submit the plugin directly to the Qt Project.
0043
0044 Note that the imageformat plugins provided by this module also provide a
0045 desktop file.  This is for the benefit of KImageIO in the KDE4 Support
0046 framework.
0047
0048 ## Duplicated Plugins
0049
0050 The TGA plugin supports more formats than Qt's own TGA plugin;
0051 specifically, the one provided here supports indexed, greyscale and RLE
0052 images (types 1-3 and 9-11), while Qt's plugin only supports type 2
0053 (RGB) files.
0054
0055 The code for this cannot be contributed upstream directly because of
0056 licensing.  If anyone were willing to write fresh code to improve Qt's
0057 TGA plugin, it would allow the TGA plugin in this framework to be
0058 removed.
0059
0060 ## License
0061
0062 This framework is licensed under the
0063 [LGPLv2.1](http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html#SEC1).
0064
0065 The CMake code in this framework is licensed under the
0066 [BSD license](http://opensource.org/licenses/BSD-3-Clause).
0067