rawengine/libraw/README.DNGSDK.txt

0001 LibRaw can decode most common DNG formats (Bayer/Linear, 16-bit integer and
0002 floating point) by itself (you need to use zlib for deflate decompression
0003 support and libjpeg for lossy compressed DNGs).
0004
0005 Some rare flavours of DNG files (e.g. for 8-bit files) are not implemented in
0006 LibRaw. These files never come from camera or DNG files created by
0007 Adobe DNG Converter, but created by some processing software that uses DNG as
0008 intermediate format.
0009
0010 To decode such files you need to compile LibRaw with Adobe DNG SDK. This SDK
0011 to be used internally, standard LibRaw API remains untouched (you may specify
0012 what kinds of DNG files you want to decode via Adobe code, see below).
0013
0014 To build LibRaw with DNG SDK specify USE_DNGSDK in defines and adjust
0015 include/linker path settings to point to DNG SDK's include and library folders.
0016
0017 DNG SDK Version compatibility:
0018  - Since LibRaw 0.20, DNG SDK 1.4 is required (DNG SDK 1.5 may work too, but
0019    have not tested w/ LibRaw).
0020  - There are several DNG SDK 1.4 versions circulated, the oldest known is
0021    dated May 2012, you'll need the last one (dated June 2015).
0022  - This version is available from Adobe site:
0023     http://download.adobe.com/pub/adobe/dng/dng_sdk_1_4.zip
0024
0025 In your application
0026
0027  * create dng_host object (or derived object, e.g. with multithreaded) entity in your program;
0028  * pass it to LibRaw via LibRaw::set_dng_host(dng_host *) call to enable DNG SDK use on runtime
0029  * adjust imgdata.rawparams.use_dngsdk parameter with one of this values
0030        (ORed bitwise):
0031        LIBRAW_DNG_NONE - do not use DNG SDK for DNG processing
0032        LIBRAW_DNG_FLOAT - process floating point DNGs via Adobe DNG SDK
0033        LIBRAW_DNG_LINEAR - process 'linear DNG' (i.e. demosaiced)
0034        LIBRAW_DNG_DEFLATE - process DNGs compressed with deflate (gzip)
0035        LIBRAW_DNG_XTRANS - process Fuji X-Trans DNGs (6x6 CFA)
0036        LIBRAW_DNG_OTHER - process other files (so usual 2x2 bayer)
0037        LIBRAW_DNG_8BIT - process 8bit DNGs (e.g. JPEG compressed ones)
0038
0039     Default value for this field:
0040        LIBRAW_DNG_DEFAULT=LIBRAW_DNG_FLOAT|LIBRAW_DNG_LINEAR|LIBRAW_DNG_DEFLATE | LIBRAW_DNG_8BIT
0041
0042     You also may use this macro to pass all supported DNGs to Adobe SDK:
0043        LIBRAW_DNG_ALL = LIBRAW_DNG_FLOAT|LIBRAW_DNG_LINEAR|LIBRAW_DNG_XTRANS|LIBRAW_DNG_OTHER | LIBRAW_DNG_8BIT