libultrahdr is an image compression library that uses gain map technology to store and distribute HDR images. Conceptually on the encoding side, the library accepts SDR and HDR rendition of an image and from these a Gain Map (quotient between the two renditions) is computed. The library then uses backward compatible means to store the base image (SDR), gain map image and some associated metadata. Legacy readers that do not support parsing the gain map image and/or metadata, will display the base image. Readers that support the format combine the base image with the gain map and render a high dynamic range image on compatible displays.
More information about libultrahdr can be found at https://developer.android.com/guide/topics/media/platform/hdr-image-format.
libultrahdr compresses base image and gain map image in to jpeg format. For this libjpeg-turbo is used. This is cloned from https://github.com/libjpeg-turbo/libjpeg-turbo.git and included in the build process.
-
CMake v3.13 or later
-
NASM or Yasm (If libjpeg-turbo is building on x86 or x86-64 with SIMD extensions)
Should work with GCC v7 (or later) and Clang 5 (or later) on Linux and Mac Platforms.
To build libultrahdr and sample application:
mkdir {build_directory}
cd {build_directory}
cmake ../ -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
make
To build unit tests:
mkdir {build_directory}
cd {build_directory}
cmake ../ -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ -DUHDR_BUILD_TESTS=1
make
ctest
This will generate the following files under {build_directory}:
libultrahdr.a
Static link library for the ultrahdr API
ultrahdr_app
Sample application demonstrating ultrahdr API
ultrahdr_unit_test
Unit tests
Refer to README.md for complete instructions.
libultrahdr includes two classes of APIs, one to compress and the other to decompress HDR images:
- Refer to jpegr.h for detailed description of various encode and decode api.
- Refer to ultrahdr_app.cpp for examples of its usage.