Bug 1021: Refine Stereo Rendering API and OculusVR implementing renderer

Refine API in regards to proper package names, interface
and high-level access to eye specific constant parameter
and variable eye movement.

+++

Commit 36327e24cf586b50bf18e87d7d13d53eb41cf1d9 introduced 'GLEventListener2'

Move javax.media.opengl.GLEventListener2
  -> com.jogamp.opengl.util.CustomRendererListener
    -> com.jogamp.opengl.util.stereo.StereoRendererListener

StereoRendererListener adds stereoscopic specific:

  public void reshapeEye(final GLAutoDrawable drawable, final int x, final int y, final int width, final int height,
                         final EyeParameter eyeParam, final EyePose eyePose);

.. see below.

++

Add com.jogamp.opengl.util.stereo:
  - EyeParameter (Constant eye parameters, like IPD and FOV)
  - EyePose (Current eye position and orientation)

+++

Add com.jogamp.opengl.math.FovHVHalves to support
non-centered bi-directional FOV for lenses.

Add respective FloatUtil.makePerspective(.. FovHVHalves fovhv ) variant.

+++

1 files changed, 0 insertions, 74 deletions

diff --git a/src/jogl/classes/javax/media/opengl/GLEventListener2.java b/src/jogl/classes/javax/media/opengl/GLEventListener2.java
deleted file mode 100644
index d4e8e84a4..000000000
--- a/src/jogl/classes/javax/media/opengl/GLEventListener2.java
+++ /dev/null
@@ -1,74 +0,0 @@
-/**
- * Copyright 2014 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 javax.media.opengl;
-
-/**
- * Extended {@link GLEventListener} interface
- * supporting more fine grained control over the implementation.
- */
-public interface GLEventListener2 extends GLEventListener {
-    /**
-     * {@link #display(GLAutoDrawable, int) display flag}: Repeat last produced image.
-     * <p>
-     * While a repeated frame shall produce the same artifacts as the last <code>display</code> call,
-     * e.g. not change animated objects, it shall reflect the {@link #setProjectionModelview(GLAutoDrawable, float[], float[]) current matrix}.
-     * </p>
-     */
-    public static final int DISPLAY_REPEAT    = 1 << 0;
-
-    /**
-     * {@link #display(GLAutoDrawable, int) display flag}: Do not clear any target buffer, e.g. color-, depth- or stencil-buffers.
-     */
-    public static final int DISPLAY_DONTCLEAR = 1 << 1;
-
-    /**
-     * Extended {@link #display(GLAutoDrawable) display} method,
-     * allowing to pass a display flag, e.g. {@link #DISPLAY_REPEAT} or {@link #DISPLAY_DONTCLEAR}.
-     * <p>
-     * Method is usually called by a custom rendering loop,
-     * e.g. for manual stereo rendering or the like.
-     * </p>
-     * @param drawable
-     * @param flags
-     */
-    public void display(final GLAutoDrawable drawable, final int flags);
-
-    /**
-     * Might be called instead of {@link #reshape(GLAutoDrawable, int, int, int, int) reshape}
-     * to specify a custom projection and modelview matrix determined by the caller.
-     * <p>
-     * Method is usually called by a custom rendering loop,
-     * e.g. for manual stereo rendering or the like.
-     * </p>
-     *
-     * @param drawable the triggering {@link GLAutoDrawable}
-     * @param mat4Projection float[16] projection matrix
-     * @param mat4Modelview float[16] modelview matrix
-     */
-    public void setProjectionModelview(final GLAutoDrawable drawable, final float[] mat4Projection, final float[] mat4Modelview);
-}