Skip to content

Latest commit

 

History

History
49 lines (34 loc) · 2.94 KB

README.md

File metadata and controls

49 lines (34 loc) · 2.94 KB

libcineform

Travis AppVeyor License: Apache v2 License: MIT

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: