50 lines
2.5 KiB
Plaintext
50 lines
2.5 KiB
Plaintext
LibRaw can decode most common DNG formats (Bayer/Linear, 16-bit integer and
|
|
floating point) by itself (you need to use zlib for deflate decompression
|
|
support and libjpeg for lossy compressed DNGs).
|
|
|
|
Some rare flavours of DNG files (e.g. for 8-bit files) are not implemented in
|
|
LibRaw. These files never come from camera or DNG files created by
|
|
Adobe DNG Converter, but created by some processing software that uses DNG as
|
|
intermediate format.
|
|
|
|
To decode such files you need to compile LibRaw with Adobe DNG SDK. This SDK
|
|
to be used internally, standard LibRaw API remains untouched (you may specify
|
|
what kinds of DNG files you want to decode via Adobe code, see below).
|
|
|
|
To build LibRaw with DNG SDK specify USE_DNGSDK in defines and adjust
|
|
include/linker path settings to point to DNG SDK's include and library folders.
|
|
|
|
DNG SDK Version compatibility:
|
|
|
|
- DNG SDK 1.6 and 1.7/1.7.1 are tested with LibRaw newer then 0.21
|
|
If you want to use LibRaw with Modern DNG files please use:
|
|
-- DNG SDK 1.7/1.7.1 for JpegXL compressed files
|
|
-- DNG SDK 1.6+ to access Enhanced DNG frames
|
|
|
|
- DNG SDK 1.5 may work too, but have not tested w/ LibRaw.
|
|
- Since LibRaw 0.20, DNG SDK 1.4 or newer is required
|
|
- There are several DNG SDK 1.4 versions circulated, the oldest known is
|
|
dated May 2012, you'll need the last one (dated June 2015).
|
|
- This version is available from Adobe site:
|
|
http://download.adobe.com/pub/adobe/dng/dng_sdk_1_4.zip
|
|
|
|
In your application
|
|
|
|
* create dng_host object (or derived object, e.g. with multithreaded) entity in your program;
|
|
* pass it to LibRaw via LibRaw::set_dng_host(dng_host *) call to enable DNG SDK use on runtime
|
|
* adjust imgdata.rawparams.use_dngsdk parameter with one of this values
|
|
(ORed bitwise):
|
|
LIBRAW_DNG_NONE - do not use DNG SDK for DNG processing
|
|
LIBRAW_DNG_FLOAT - process floating point DNGs via Adobe DNG SDK
|
|
LIBRAW_DNG_LINEAR - process 'linear DNG' (i.e. demosaiced)
|
|
LIBRAW_DNG_DEFLATE - process DNGs compressed with deflate (gzip)
|
|
LIBRAW_DNG_XTRANS - process Fuji X-Trans DNGs (6x6 CFA)
|
|
LIBRAW_DNG_OTHER - process other files (so usual 2x2 bayer)
|
|
LIBRAW_DNG_8BIT - process 8bit DNGs (e.g. JPEG compressed ones)
|
|
|
|
Default value for this field:
|
|
LIBRAW_DNG_DEFAULT=LIBRAW_DNG_FLOAT|LIBRAW_DNG_LINEAR|LIBRAW_DNG_DEFLATE | LIBRAW_DNG_8BIT
|
|
|
|
You also may use this macro to pass all supported DNGs to Adobe SDK:
|
|
LIBRAW_DNG_ALL = LIBRAW_DNG_FLOAT|LIBRAW_DNG_LINEAR|LIBRAW_DNG_XTRANS|LIBRAW_DNG_OTHER | LIBRAW_DNG_8BIT
|