mirror of
https://invent.kde.org/frameworks/kimageformats.git
synced 2025-05-28 00:30:23 -04:00
9438540735
This MR adds read-only QOI (https://qoiformat.org/) image format support for KImageFormats. This format has received it's MIME type inclusion in shared-mime-info 4 months ago:ff51a0a9e3The code is based on the reference QOI implementation at https://github.com/phoboslab/qoi/blob/master/qoi.h Official test images: https://qoiformat.org/qoi_test_images.zip  Also: This is my first MR to KDE ;) (cherry picked from commitb209e54b6f)
70 lines
2.1 KiB
Markdown
70 lines
2.1 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)
|
|
- OpenEXR (exr)
|
|
- Photoshop documents (psd, psb, pdd, psdt)
|
|
- Radiance HDR (hdr)
|
|
- Sun Raster (ras)
|
|
- Quite OK Image format (qoi)
|
|
|
|
The following image formats have read and write support:
|
|
|
|
- AV1 Image File Format (AVIF)
|
|
- Encapsulated PostScript (eps)
|
|
- JPEG XL (jxl)
|
|
- Personal Computer Exchange (pcx)
|
|
- SGI images (rgb, rgba, sgi, bw)
|
|
- Softimage PIC (pic)
|
|
- Targa (tga): supports more formats than Qt's version
|
|
- XView (xv)
|
|
|
|
## 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).
|
|
|