Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/darktable-org/rawspeed
fast raw decoding library
https://github.com/darktable-org/rawspeed
bayer camera cmake cpp cpp17 cr2 decoding dng dslr gpr jpeg library nef openmp raw vc5 x-trans xml zlib
Last synced: 4 days ago
JSON representation
fast raw decoding library
- Host: GitHub
- URL: https://github.com/darktable-org/rawspeed
- Owner: darktable-org
- License: lgpl-2.1
- Created: 2016-12-23T13:27:05.000Z (about 8 years ago)
- Default Branch: develop
- Last Pushed: 2024-12-13T20:15:16.000Z (11 days ago)
- Last Synced: 2024-12-14T01:04:57.686Z (11 days ago)
- Topics: bayer, camera, cmake, cpp, cpp17, cr2, decoding, dng, dslr, gpr, jpeg, library, nef, openmp, raw, vc5, x-trans, xml, zlib
- Language: C++
- Homepage:
- Size: 14 MB
- Stars: 363
- Watchers: 39
- Forks: 115
- Open Issues: 96
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
rawspeed |github actions| OBS_ |codecov| |oss-fuzz|
.. |github actions| image:: https://github.com/darktable-org/rawspeed/actions/workflows/CI.yml/badge.svg
:target: https://github.com/darktable-org/rawspeed/actions/workflows/CI.yml.. _OBS: https://build.opensuse.org/project/monitor/graphics:darktable:master
.. |codecov| image:: https://codecov.io/gh/darktable-org/rawspeed/branch/develop/graph/badge.svg
:target: https://codecov.io/gh/darktable-org/rawspeed.. |oss-fuzz| image:: https://oss-fuzz-build-logs.storage.googleapis.com/badges/librawspeed.svg
:target: https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:librawspeed================================================================================
RawSpeed Developer Information
================================================================================What is RawSpeed?
--------------------------------------------------------------------------------RawSpeed…
- is capable of decoding various images in RAW file format.
- is intended to provide the fastest decoding speed possible.
- supports the most common DSLR and similar class brands.
- supplies unmodified RAW data, optionally scaled to 16 bit, or normalized to 0->1 float point data.
- supplies CFA layout for all known cameras.
- provides automatic black level calculation for cameras having such information.
- optionally crops off “junk” areas of images, containing no valid image information.
- can add support for new cameras by adding definitions to an xml file.
- decodes images from memory, not a file stream.
- is being continuously fuzzed |oss-fuzz| as part of the `oss-fuzz`_ project.
- is currently tested on |rpu-button-cameras| unique cameras, on |rpu-button-samples| unique samples.
**Please read** `this `_ **for more info on how to contribute samples!**
- open source under the `LGPL v2`_ license... _oss-fuzz: https://github.com/google/oss-fuzz
.. |rpu-button-cameras| image:: https://raw.pixls.us/button-cameras.svg
:target: https://raw.pixls.us/.. |rpu-button-samples| image:: https://raw.pixls.us/button-samples.svg
:target: https://raw.pixls.us/.. _rpu-post: https://discuss.pixls.us/t/raw-samples-wanted/5420?u=lebedevri
.. _LGPL v2: https://choosealicense.com/licenses/lgpl-2.1/
RawSpeed does **NOT**…
- read metadata information, beside whitebalance information.
- do any color correction or whitebalance correction.
- de-mosaic the image.
- supply a viewable image or thumbnail.
- crop the image to the same sizes as manufactures, but supplies biggest possible images.So RawSpeed is not intended to be a complete RAW file display library, but only act as the first stage decoding, delivering the RAW data to your application.
Version 2, new cameras and features
--------------------------------------------------------------------------------
- Support for Sigma foveon cameras.
- Support for Fuji cameras.
- Support old Minolta, Panasonic, Sony cameras (contributed by Pedro Côrte-Real)
- Arbitrary CFA definition sizes.
- Use pugixml_ for xml parsing to avoid depending on libxml... _pugixml: http://pugixml.org/
Getting Source Code
--------------------------------------------------------------------------------
You can get access to the latest version using `from here `_. You will need to include the “RawSpeed” and “data” folder in your own project.CMake-based build system is provided.
Integration into LLVM LNT / Test-Suite
--------------------------------------
It is possible to natively integrate the RawSpeed into LLVM test-suite, and use
`LLVM LNT `_ to do testing, benchmarking, performance tracking.
For quick overview please see `LLVM LNT / Test-Suite Integration `_Background of RawSpeed
----------------------
The main objectives were to make a very fast loader that worked for 75% of the cameras out there, and was able to decode a RAW file at close to the optimal speed. The last 25% of the cameras out there could be serviced by a more generic loader, or convert their images to DNG – which as a sidenote usually compresses better than your camera.RawSpeed is not at the moment a separate library, so you have to include it in your project directly.
Submitting Requests and Patches
--------------------------------------------------------------------------------
Please go to the `github page `_ and submit your (pull)requests and issues there... _rawspeed: https://github.com/darktable-org/rawspeed