From 1152d3c3cb5d13b4e5543387bff7a73e78e27a71 Mon Sep 17 00:00:00 2001 From: Sven Gothel Date: Wed, 18 Apr 2012 10:45:41 +0200 Subject: GLMediaPlayer: Add Class / Package API doc incl. detailed info in the implementations. --- .../jogamp/opengl/util/av/NullGLMediaPlayer.java | 3 +- .../opengl/util/av/impl/FFMPEGMediaPlayer.java | 45 +++++++++++++++++++++- .../opengl/util/av/impl/OMXGLMediaPlayer.java | 32 +++++++++++++++ 3 files changed, 77 insertions(+), 3 deletions(-) (limited to 'src/jogl/classes/jogamp/opengl/util') diff --git a/src/jogl/classes/jogamp/opengl/util/av/NullGLMediaPlayer.java b/src/jogl/classes/jogamp/opengl/util/av/NullGLMediaPlayer.java index fe2aeaf19..3d740d6b2 100644 --- a/src/jogl/classes/jogamp/opengl/util/av/NullGLMediaPlayer.java +++ b/src/jogl/classes/jogamp/opengl/util/av/NullGLMediaPlayer.java @@ -44,7 +44,8 @@ import com.jogamp.opengl.util.texture.TextureIO; import com.jogamp.opengl.util.texture.TextureSequence; /*** - * A dummy null media player implementation using a static test frame (if available). + * A dummy null media player implementation using a static test frame + * available on all platforms. */ public class NullGLMediaPlayer extends GLMediaPlayerImpl { private TextureData texData = null; diff --git a/src/jogl/classes/jogamp/opengl/util/av/impl/FFMPEGMediaPlayer.java b/src/jogl/classes/jogamp/opengl/util/av/impl/FFMPEGMediaPlayer.java index d24961b68..7d10cff4d 100644 --- a/src/jogl/classes/jogamp/opengl/util/av/impl/FFMPEGMediaPlayer.java +++ b/src/jogl/classes/jogamp/opengl/util/av/impl/FFMPEGMediaPlayer.java @@ -49,15 +49,56 @@ import jogamp.opengl.gl4.GL4bcProcAddressTable; import jogamp.opengl.util.av.EGLMediaPlayerImpl; /*** - * Currently only YUV420P and the usual packed RGB formats are supported. + * Implementation utilizes Libav + * or FFmpeg which is 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. + *

+ * Implements YUV420P to RGB fragment shader conversion + * and the usual packed RGB formats. + * 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. + *

+ *

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

+ *

+ *

+ * http://libav.org/ + *

*

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

*

- * TODO: Audio Output + * TODO: + *

*

+ * Pre-compiled Libav / FFmpeg packages: + * */ public class FFMPEGMediaPlayer extends EGLMediaPlayerImpl { public static final VersionNumber avUtilVersion; diff --git a/src/jogl/classes/jogamp/opengl/util/av/impl/OMXGLMediaPlayer.java b/src/jogl/classes/jogamp/opengl/util/av/impl/OMXGLMediaPlayer.java index 7c812ce1c..aef98fcde 100644 --- a/src/jogl/classes/jogamp/opengl/util/av/impl/OMXGLMediaPlayer.java +++ b/src/jogl/classes/jogamp/opengl/util/av/impl/OMXGLMediaPlayer.java @@ -1,3 +1,30 @@ +/** + * Copyright 2012 JogAmp Community. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, are + * permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, this list of + * conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright notice, this list + * of conditions and the following disclaimer in the documentation and/or other materials + * provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY JogAmp Community ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND + * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JogAmp Community OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR + * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF + * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * The views and conclusions contained in the software and documentation are those of the + * authors and should not be interpreted as representing official policies, either expressed + * or implied, of JogAmp Community. + */ package jogamp.opengl.util.av.impl; @@ -13,6 +40,11 @@ import com.jogamp.opengl.util.texture.TextureSequence; import jogamp.opengl.egl.EGL; import jogamp.opengl.util.av.EGLMediaPlayerImpl; +/** + * OpenMAX IL implementation. This implementation is currently not tested + * due to lack of an available device or working software implementation. + * It is kept alive through all changes in the hope of a later availability though. + */ public class OMXGLMediaPlayer extends EGLMediaPlayerImpl { static final boolean available; -- cgit v1.2.3