mirror of
https://invent.kde.org/frameworks/kimageformats.git
synced 2025-05-28 00:30:23 -04:00
9173f02ea3
Added support for RLE compressed images. This patch makes the player almost complete allowing to read all type 1,2 and 3 RAS files. Only types 4 and 5 are missing which are images converted from TIFF and IFF.
72 lines
2.2 KiB
Markdown
72 lines
2.2 KiB
Markdown
# KImageFormats
|
|
|
|
Plugins to allow QImage to support extra file formats.
|
|
|
|
## Introduction
|
|
|
|
This framework provides additional image format plugins for QtGui. As
|
|
such it is not required for the compilation of any other software, but
|
|
may be a runtime requirement for Qt-based software to support certain
|
|
image formats.
|
|
|
|
## Formats
|
|
|
|
The following image formats have read-only support:
|
|
|
|
- Animated Windows cursors (ani)
|
|
- Camera RAW images (arw, cr2, cr3, dcs, dng, ...)
|
|
- Gimp (xcf)
|
|
- Krita (kra)
|
|
- OpenEXR (exr)
|
|
- OpenRaster (ora)
|
|
- Photoshop documents (psd, psb, pdd, psdt)
|
|
- Radiance HDR (hdr)
|
|
- Sun Raster (im1, im8, im24, im32, ras, sun)
|
|
|
|
The following image formats have read and write support:
|
|
|
|
- AV1 Image File Format (AVIF)
|
|
- Encapsulated PostScript (eps)
|
|
- High Efficiency Image File Format (heif). Can be enabled with the KIMAGEFORMATS_HEIF build option.
|
|
- JPEG XL (jxl)
|
|
- Personal Computer Exchange (pcx)
|
|
- Quite OK Image format (qoi)
|
|
- SGI images (rgb, rgba, sgi, bw)
|
|
- Softimage PIC (pic)
|
|
- Targa (tga): supports more formats than Qt's version
|
|
|
|
## Contributing
|
|
|
|
See the QImageIOPlugin documentation for information on how to write a
|
|
new plugin.
|
|
|
|
The main difference between this framework and the qimageformats module
|
|
of Qt is the license. As such, if you write an imageformat plugin and
|
|
you are willing to sign the Qt Project contributor agreement, it may be
|
|
better to submit the plugin directly to the Qt Project.
|
|
|
|
Note that the imageformat plugins provided by this module also provide a
|
|
desktop file. This is for the benefit of KImageIO in the KDE4 Support
|
|
framework.
|
|
|
|
## Duplicated Plugins
|
|
|
|
The TGA plugin supports more formats than Qt's own TGA plugin;
|
|
specifically, the one provided here supports indexed, greyscale and RLE
|
|
images (types 1-3 and 9-11), while Qt's plugin only supports type 2
|
|
(RGB) files.
|
|
|
|
The code for this cannot be contributed upstream directly because of
|
|
licensing. If anyone were willing to write fresh code to improve Qt's
|
|
TGA plugin, it would allow the TGA plugin in this framework to be
|
|
removed.
|
|
|
|
## License
|
|
|
|
This framework is licensed under the
|
|
[LGPLv2.1](http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html#SEC1).
|
|
|
|
The CMake code in this framework is licensed under the
|
|
[BSD license](http://opensource.org/licenses/BSD-3-Clause).
|
|
|