| 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 |
