mirror/kimageformats
1
0
Fork 0
mirror of https://invent.kde.org/frameworks/kimageformats.git synced 2025-05-27 08:20:21 -04:00
Code Issues Packages Projects Releases Wiki Activity
65a20b43fc
kimageformats/README.md
Mirco Miranda 65a20b43fc Camera RAW images plugin 
Plugin to read RAW camera images based on LibRAW.

- Supersedes MR !86 
- Support to LibRaw 0.20 and 0.21-Beta
- Support to multi-shot images: use imageCount(), jumpToImage() to select the wanted shot
- By default generates 16-bits sRGB images using camera white balance and interpolation AHD
- Should fix CCBUG: 454208: on my Debian with KF5.96 and the pulgin installed, I see the preview of all my RAW files (ARW included) in Dolphin

News compared to V1 (MR !86)

- Fix possible stack overflow due to the huge size of LibRaw class
- Fix image allocation with Qt 6 (make use of QImageIOHandler::allocateImage()) 
- Support to XMP metapacket
- Support to quality option. For e.g. you can focus on quality (q = 10) or speed (q = 1)
- oss-fuzz available [here](https://github.com/mircomir/oss-fuzz/tree/raw_fuzz/projects/kimageformats)
2022-09-19 23:52:43 +00:00

2.0 KiB
Raw Blame History

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)
  • Gimp (xcf)
  • OpenEXR (exr)
  • Photoshop documents (psd, psb, pdd, psdt)
  • Sun Raster (ras)
  • Camera RAW images (arw, cr2, cr3, dcs, dng, ...)

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.

The CMake code in this framework is licensed under the BSD license.