Implementation utilizes Libav or FFmpeg which are ubiquitous available and usually pre-installed on Unix platforms.

Due to legal reasons we cannot deploy binaries of it, which contains patented codecs.

Besides the default BSD/Linux/.. repositories and installations, precompiled binaries can be found at the listed location below.

Implementation specifics

The decoded video frame is written directly into an OpenGL texture on the GPU in it's native format. A custom fragment shader converts the native pixelformat to a usable RGB format if required. Hence only 1 copy is required before bloating the picture from YUV* to RGB, for example.

Implements pixel format conversion to RGB via fragment shader texture-lookup functions:

• VideoPixelFormat#YUV420P
• VideoPixelFormat#YUVJ420P
• VideoPixelFormat#YUV422P
• VideoPixelFormat#YUVJ422P
• VideoPixelFormat#YUYV422
• VideoPixelFormat#BGR24

Libav Specifics

Utilizes a slim dynamic and native binding to the Lib_av libraries:

• libavcodec
• libavformat
• libavutil
• libavresample (opt)
• libavdevice (opt)

LibAV Compatibility

Currently we are binary compatible w/:

libav / ffmpeg	lavc	lavf	lavu	lavr/lswr	FFMPEG* class
0.8	53	53	51		FFMPEGv08
9.0 / 1.2	54	54	52	01/00	FFMPEGv09
10 / 2.[0-3]	55	55	53/52	01/00	FFMPEGv10
11 / 2.[4-8]	56	56	54	02/01	FFMPEGv11
12 / 2.[9-x]	57	57	55	02/01	TODO

See FFmpeg:

• http://ffmpeg.org/documentation.html
• http://git.videolan.org/?p=ffmpeg.git;a=blob;f=doc/APIchanges;hb=HEAD

See libav:

• https://libav.org/documentation.html
• http://upstream-tracker.org/versions/libav.html

Check tag 'FIXME: Add more planar formats !' here and in the corresponding native code jogl/src/jogl/native/libav/ffmpeg_impl_template.c

TODO:

• better audio synchronization handling? (video is synchronized)

FFMPEG / LibAV Availability

• GNU/Linux: ffmpeg or libav are deployed in most distributions.
• Windows:
  • https://ffmpeg.org/download.html#build-windows
  • http://ffmpeg.zeranoe.com/builds/ (ffmpeg) recommended, works w/ dshow
  • http://win32.libav.org/releases/ (libav)
• MacOSX
  • Builds
    • https://ffmpeg.org/download.html#build-mac
  • Building using Homebrew *
    • https://github.com/Homebrew/homebrew/wiki/Installation
    • https://trac.ffmpeg.org/wiki/CompilationGuide/MacOSX
• OpenIndiana/Solaris:

        pkg set-publisher -p http://pkg.openindiana.org/sfe-encumbered.
        pkt install pkg:/video/ffmpeg
        

  vec4 funcName(in getTextureSampler2DType() image, in vec2 texCoord) {
     vec4 texColor = do_something_with(image, texCoord);
     return texColor;
  }

  vec4 funcName(in getTextureSampler2DType() image, in vec2 texCoord) {
     vec4 texColor = do_something_with(image, texCoord);
     return texColor;
  }