README.DNGSDK.txt 2.3 KB

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