Skip to content

Latest commit

 

History

History
69 lines (52 loc) · 2.73 KB

README.md

File metadata and controls

69 lines (52 loc) · 2.73 KB
Raw

Android LibRaw

Another Android LibRaw implementation. LibRaw is used to render camera raw image files (e.g Nikon NEF, Canon CR2, Sony ARW). The project contains a sample app that shows a simple implementation.

Using the artifact

Follow the instructions on Jitpack.io to include it as a repository.

Add this line to your build.gradle.

implementation 'com.github.dburckh:AndroidLibRaw:2.0.5'

Cloning the Project

Because the project has submodule links, it requires an extra parameter.

git clone --recurse-submodules https://github.com/dburckh/AndroidLibRaw.git

A note on submodules:

If you want to new version of the LibRaw or LibRawCMake, you can update the submodules. Use caution updating the actual LibRaw/LibRawCMake code, updating submodule code can be tricky.

Benefits

  • Decodes the actual raw data. BitmapFactory shows the embedded JPEG, if available
  • Works with modern Android File security constraints (uses FileDescriptors or File paths).
  • Works with Kotlin or Java.
  • Not a custom version of LibRaw! Should work with future releases with little or no modification.
  • Uses CMake build system.

Limitations

  • Requires API 24+ (Nougat).
  • Uses NDK 22, (21 is the current default).
  • Uses Git Submodules.
  • TODO: Unit tests

Sources

Most of the code I did for this was either glue or tweaking of somebody else work.

  • LibRaw The brains of the operation
  • LibRaw-cmake Made building LibRaw in Studio/gradle, much easier.
  • LibRaw-Android Ground breaking "glue" code I borrowed heavily from.

Change Log

2.0.6

  • Faster image processing
  • Extend ColorSpace support
  • White Balance coeffients by Exif.LightSource and Temperature
  • Update Libraw to 0.21.2
  • getBitmap() rework

2.0.5

  • Update Libraw to 0.21.1
  • Migrate build to Jitpack.io

2.0.4

  • Add Proguard rules
  • Update Libraw/Libraw-CMake

2.0.3

  • Removed recycle from getBitmap(). Let me know if you feel it's necessary
  • Added LibRaw.newInstance() factory to get the proper version of LibRaw (LibRaw or LibRaw26)
  • For Android Q+, now creates RGB_888 (not RGBA_8888) and RGBA_F16 Bitmap.Config.Hardware Bitmaps. Create a new LibRaw() directly if you don't want Hardware bitmaps for some reason.

2.0.2

  • Fix rotation issues
  • Add cancel functions

2.0.1

  • Change getBitmap[16]() to remove intermediate step that creates an RGB memory image. Now directly creates the Bitmap from the image[] data.
  • Add methods setCaptureScaleMul(), getColorCurve() and dcrawProcessForce(colorCurve) to force consistent white balance in future runs.

2.0.0

  • Moved from static LibRaw to instance. This allows multiple LibRaw instances to exist at the same time.