IHMC Java Video Codecs

This library provides Java support for the following video formats

MP4 (Based on JCodec)
MJPEG (libJPEG-Turbo)
H264 (OpenH264)

Native code is used for the actual encoding and decoding of the video formats. Only video support is provided for now.

H264 support is provided using OpenH264. A downloader for the OpenH264 library is included, and will prompt the user to accept the license. This means all royalities for the H264 codec are taken care off by Cisco.

Philosophy

All code is released under a permissive Apache 2.0 license. This library tries to avoid problems with licensing patents, for example trough the use of the OpenH264 module.

Simple, well defined classes to support the functionality needed are written in C++. SWIG is used to bridge our C++ classes to Java. Only basic features are supported, keeping the API simple and maintainable.

Only video is supported.

Features

Video tracks only
Supports RGB <-> YUV conversion using libyuv (BSD license)
Supports JPEG encoding/decoding using libjpeg-turbo (BSD/IJG license)
Bridge to OpenH264 (BSD License)
- Automatic downloading of Cisco licensed binary
MP4 support based on JCodec (BSD License)
- Mux: H264, MJPEG
- Demux: H264, MJPEG
Fast screenshot support using native code
- Linux only
- Fallback using AWT Robot for Mac/Windows

Usage

A pre-compiled version is avaiable on https://bintray.com/ihmcrobotics/maven-release/IHMCVideoCodecs. You can either use Gradle or Maven to add IHMC Video codecs to your project.

Gradle

Add the IHMC Video Codecs library as dependency

repositories {
    maven {
        url  "https://dl.bintray.com/ihmcrobotics/maven-release"
    }
}
	
dependencies {
	compile group: 'us.ihmc', name: 'IHMCVideoCodecs', version: '2.1'
}

Examples

See the examples directory

Headless systems

To accept the license on a system without console input, add "-Dopenh264.license=accept" to your Java command line arguments.

Contributions

Contributions are welcome. We are a robot lab, supporting video codecs is not our main focus. Please provide pull requests. If you or your organization is interested in taking over maintainance, please contact us.

Compile native code

For your convenience compiled libraries are placed in the resources directory. Compiled libraries are available for

Windows (64 bit) (You might need to install Microsoft Visual C++ Redistributable for Visual Studio 2017
Mac OS X (64 bit)
Linux (64 bit)

If you want to use this library on another platform, you have to compile it yourself. Follow the instructions most appropriatly for your platform.

Dependencies

LibYUV git #d0ed025447622c570a76bcf2ac88c30209c780a0
OpenH264 v1.7
Swig 3.0.3 or higher

Linux

Install OpenJDK (>=8)
Compile LibYUV following https://chromium.googlesource.com/libyuv/libyuv/+/master/docs/getting_started.md
- 64 Bit release build
Download and compile the openH264 sources (version 1.7) from https://github.com/cisco/openh264
- git clone https://github.com/cisco/openh264.git
- cd openh264
- git checkout openh264v1.7
- make
Install swig 3.0.3 or higher
Go to IHMCVideoCodecs directory
- mkdir build
- cd build
- ccmake ..
  - Set CMAKE_BUILD_TYPE to Release
  - Set LIBYUV_HOME to the libyuv trunk directory
  - Set OPENH264_HOME to the openh264 source directory
- make
- make install

Mac

Install the JDK for Mac (>=8)
Install homebrew
- brew install nasm automake pcre cmake swig
Download and compile the openH264 sources (version 1.7) from https://github.com/cisco/openh264
- git clone https://github.com/cisco/openh264.git
- cd openh264
- git checkout openh264v1.7
- make
Compile LibYUV following https://chromium.googlesource.com/libyuv/libyuv/+/master/docs/getting_started.md
- 64Bit release build
Go to IHMCVideoCodecs directory
- mkdir build
- cd build
- ccmake ..
  - Set CMAKE_BUILD_TYPE to Release
  - Set LIBYUV_HOME to the libyuv trunk directory
  - Set OPENH264_HOME to the openh264 source directory
- make
- make install

Windows

Install Visual Studio Community 2017
- Continue while this is downloading and get some coffee
Install Windows SDK for WIndows 10
- https://developer.microsoft.com/en-us/windows/hardware/windows-driver-kit
- You only need the "Debugging tools for windows"
Install the 64 bit JDK for Windows (>=8)
Install CMake using the installer http://www.cmake.org/download/
Download and unpack swigwin 3.0.3 or higher
- http://sourceforge.net/projects/swig/files/swigwin/swigwin-3.0.3/
Install Libyuv
- Follow instructions on https://chromium.googlesource.com/libyuv/libyuv/+/master/docs/getting_started.md
  - Use the Windows Release build for x64
  - Before running "gclient sync" set the following env variables
    - set GYP_MSVS_VERSION=2017
    - set DEPOT_TOOLS_WIN_TOOLCHAIN=0
Install MinGW (you only need to select msys-base)
- Use mingw-get-setup.exe from http://sourceforge.net/projects/mingw/files/Installer/
Install nasm for windows 64 bit from http://www.nasm.us/
Setup %Path% variables, add the following directories
- C:\MinGW\msys\1.0\bin
- C:\Program Files\NASM
Download the openh264 sources, tag v1.7
- Use git
  - git clone https://github.com/cisco/openh264.git
  - cd openh264
  - git checkout openh264v1.7
- Read the instructions in the openh264 README.md
- Start the 64 Native Tools Command Prompt for VS 2017 (Start -> Visual Studio 2017 -> Visual Studio Tools)
- cd to the openh264 dir
- make OS=msvc ENABLE64BIT=Yes
Start the cmake-gui
- Point source directory to IHMCVideoCodecs sources
- Point build directory to [sources]/build
- Configure
  - Choose the Visual Studio 15 2017 Win64 generator
  - Choose Default native toolchain
  - Set all paths (LIBYUV_HOME, OPENH264_HOME, SWIG_EXECUTABLE) correctly
  - Configure
- Generate
In the command prompt go to IHMCVideoCodecs/build
- Run "C:\Program Files\CMake\bin\cmake.exe" --build . --config Release --target install

Publishing

To publish to bintray run

gradle bintrayUpload

panchenko/ihmc-video-codecs