forked from LibRaw/LibRaw
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.DNGSDK.txt
42 lines (34 loc) · 2.15 KB
/
README.DNGSDK.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
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:
- Since LibRaw 0.20, DNG SDK 1.4 is required (DNG SDK 1.5 may work too, but
have not tested w LibRaw).
- 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.params.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)
Default value for this field:
LIBRAW_DNG_DEFAULT=LIBRAW_DNG_FLOAT|LIBRAW_DNG_LINEAR|LIBRAW_DNG_DEFLATE
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