emericg/libcineform

CineForm decoding and encoding library. Fully compatible, but easier to build and integrate than the CineForm SDK.

libcineform

libcineform introduction

CineForm decoding and encoding library, forked from the CineForm SDK. But why?!

• Fully compatible API with the original CineForm SDK.
• Easier to build, on all platforms and compilers, while allowing a clean integration into third party projects.
• Remove a lot of unused and undocumented stuff, to keep both the code repository and library sizes contained.
• Continuous Integration bots, why not...

CineForm introduction (from CineForm SDK)

GoPro CineForm® is a 12-bit, full-frame wavelet compression video codec. It is designed for speed and quality, at the expense of a very high compression size. Image compression is a balance of size, speed and quality, and you can only choose two. CineForm was the first of its type to focus on speed, while supporting higher bit depths for image quality. More recent examples would be Avid DNxHD® and Apple ProRES®, although both divide the image into blocks using DCT. The full frame wavelet as a subject quality advantage over DCTs, so you can compression more without classic ringing or block artifact issues.

Pixel formats supported:

• 8/10/16-bit YUV 4:2:2 compressed as 10-bit, progressive or interlaced
• 8/10/16-bit RGB 4:4:4 compressed at 12-bit progressive
• 8/16-bit RGBA 4:4:4:4 compressed at 12-bit progressive
• 12/16-bit CFA Bayer RAW, log encoded and compressed at 12-bit progressive
• Dual channel stereoscopic/3D in any of the above

Compression ratio: between 10:1 and 4:1 are typical, greater ranges are possible. CineForm is a constant quality design, bit-rates will vary as needed for the scene. Whereas most other intermediate video codecs are a constant bit-rate design, quality varies depending on the scene.

Building libcineform

$ cd libcineform/build/
$ cmake ..
$ make

You choose to build shared and/or static library:

$ cmake [-DBUILD_STATIC_LIBS:BOOL=ON] [-DBUILD_SHARED_LIBS:BOOL=ON] ..

You can install the library into your system: (except on Windows)

$ cmake [-DCMAKE_INSTALL_PREFIX=/usr/local] ..
# make install

License Terms

Same as the CineForm SDK, available under either:

• Apache License, Version 2.0, (read provided LICENSE-APACHE or visit https://www.apache.org/licenses/LICENSE-2.0)
• MIT license (read provided LICENSE-MIT or visit https://opensource.org/licenses/MIT)

libcineform's Issues

[wish] make a new release

There is a lot of code cleaning in the 9 commits since the first release made on 2018-05-16.