Project web: http://lumahdrv.org/

The Luma HDRv package provides libraries for encoding and decoding of HDR video sequences. The encoding is done using the high bit depth profiles of google's VP9 codec. To be able to store HDR images with the limited bits available, luminance and color transformations are done in such way to ensure that quantization errors are below the visibility threshold of the human visual system. This assumes that the input is given in physical units (cd/m^2).

For examples on how to use the libraries, please see the simple test examples in ./test.

The Luma HDRv package also provides command line applications for encoding, decoding and playback of HDR video using the libraries. The input video for encoding could either be provided as separate OpenEXR frames, or piped from pfstools. The HDR video is stored in a Matroska container, for increased flexibility and compatibility.

For further information on how to use the applications, please see the manual pages provided with each application. After installation these should be available on the system as:

$ man lumaenc
$ man lumadec
$ man lumaplay

Depending on what is available on the build system (see compilation and installation section), the Luma HDRv package is built with different executables. In a full build, the following parts are included:

• libluma_encoder -- Luma HDRv encoding library, providing functionalities for encoding and writing of HDR videos.
• libluma_decoder -- Luma HDRv decoding library, providing functionalities for decoding and reading of HDR videos.
• lumaenc -- HDR video encoding application, for encoding HDR frames into a HDR video.
• lumadec -- HDR video decoding application, for decoding of HDR video into separate frames.
• lumaplay -- Simple playback of encoded HDR videos.
• test_simple_enc -- Minimal encoding test example, to demonstrate how to use the luma_encoder library.
• test_simple_dec -- Minimal decoding test example, to demonstrate how to use the luma_decoder library.

Compilation is provided through CMake, and should be able to detect which applications to build depending on existing dependencies.

For a minimal build, only providing the Luma HDRv libraries (libluma_encoder and libluma_decoder), there are no external dependencies. The required dependencies for these are included in the build tree and compiled together with the Luma HDRv libraries.

The provided applications are compiled if their dependencies are found. The dependencies are as follows:

• libluma_encoder and libluma_decoder:

  • libvpx [provided]
  • libmatroska [provided]
  • libebml [provided]

• lumaenc and lumadec:

  • openEXR
  • pfstools [optional]

• lumaplay:

  • openGL
  • glut
  • glew

• test_simple_enc and test_simple_dec:

  • openEXR

For an out-of-tree build (recommended) and install, do the following:

$ cd <path_to_luma_hdrv>
$ mkdir build
$ cd build
$ cmake ../
$ make
$ make install

Since libvpx requires Cygwin to be built, this must be done before compilation of Luma HDRv. A quick guide for installation of libvpx for linking with Luma HDRv follows (please refer to instructions on the WebM webpage for more information on Windows compilation of libvpx):

1. Extract the provided libvpx archive (lib/libvpx.tar.gz) in place, or download libvpx and put under lib/libvpx.

2. In Cygwin, go to the build directory of libvpx and build a Visual Studio solution:

   $ cd /cygdrive/<path_to_luma_hdrv>/lib/libvpx/build
   $ ../configure --enable-vp9-highbitdepth --enable-vp9 --enable-multithread
       --as=yasm --disable-avx2 --disable-libyuv --disable-webm_io
       --disable-unit_tests --disable-install-docs --disable-install-bins
       --disable-install-srcs --disable-examples --disable-docs --disable-vp8
       --target=x86-win32-vs10 --enable-static-msvcrt
   $ make
   

   The --target option should be replaced with the appropriate platform and Visual Studio version.

3. Download the Yasm assembler executable (yasm-x.x.x-win32.exe or yasm-x.x.x-win64.exe), rename it to yasm.exe and place it in the build directory (lib/libvpx/build/), or any directory known by Visual Studio.

4. Build the VPX Visual Studio solution, and place the compiled library (vpxmt.lib) either in the build directory of Luma HDRv or in the lib folder in the build directory.

5. Run CMake for Luma HDRv. It should be able to detect VPX library that has been created, and the include files in lib/libvpx/.

6. Build Luma HDRv Visual Studio solution, and then run the INSTALL project in the solution to install Luma HDRv.

Minimal dependencies are included as is in ./lib, and with no alterations. These can easily be replaced by other versions of the libraries, simply by replacing the source files and recompiling Luma HDRv. The included libraries are:

• libvpx uses a BSD license.
• libmatroska uses the LGPL license.
• libebml uses the LGPL license.

Please see the respective source directories in ./lib for license information.

Copyright (c) 2015, The LumaHDRv authors. All rights reserved.

Luma HDRv is distributed under a BSD license. See LICENSE for information.