Changes

Produce duplicate natives in the build, in preparation for removing
support for aliasing in native library loading.

Specifically, produce:

  jogl-all-noawt-natives-${os_and_arch}.jar
  jogl-all-mobile-natives-${os_and_arch}.jar
  jogl-all-android-natives-${os_and_arch}.jar

Attempt to remove aliasing from native libraries.

Renamed:

  jogl-core.jar         → jogl.jar
  nativewindow-core.jar → nativewindow.jar

The build scripts have been edited to produce sets of natives for
each "module" (as opposed to producing one set of natives and then
have each module point to them via aliasing).

Bug: 1023
Bug: 1024

Depends on 46faa59d439ef235d7691fc64d56eedc600ffa1a from gluegen.

Bug 1021: Add GenericStereoDevice* Supporting custom configurations; Hook-in oculusvr-sdk java distortion-mesh calculation if available

StereoDeviceFactory support new GenericStereoDeviceFactory, with it's GenericStereoDevice and GenericStereoDeviceRenderer.

GenericStereoDevice maintains different configurations, triggered either by passing a GenericStereoDevice.Config
instance directly or by the device-index parameter:

  - 0: monoscopi device: No post-processing

  - 1: stereoscopic device SBS: No post-processing

  - 2: stereoscopic device SBS + Lenses: Distortion post-processing
       (only available w/ oculusvr-sdk sub-module)

Producing a 'GenericStereoDevice.Config' instance is self containing
and may extend if supporting more device types like top-bottom, interlaced etc.

StereoDemo01 handles all use-cases and may be used as a test-bed
to add and experiment with stereoscopy, devices and settings.

Findbugs.minor: Fix 'array -> string', missing argument

Findbugs.normal: Adding safeguard hashCode() implementation throwing InternalError("hashCode not designed")

As long we don't use Object.hashCode() to idenitify the memory address, we can safeguard the code.

Findbugs.synchronization: Fix double-check w/o volatile; Remove redundant synchronized from setter

Findbugs.not-written.null: Fix referencing non-written fields (never written or due branching)

- AWT TextRenderer: Add throw new InternalError("fontRenderContext never initialized!"); FIXME!
- GLContextImpl.hasFBOImpl(): Fix serious NPE issue if extCache is null
- GLDrawableFactoryImpl.createOffscreenDrawableImpl(..):
  - Fix NPE issue w/ null drawable
  - Fix resetting GammaRamp by ensuring originalGammaRamp will be set at 1st setGammaRamp(..)

- AndroidGLMediaPlayerAPI14: Fix NPE: Use already resolved local referenced
- EGLDrawableFactory: Fix NPE: Only operate on non null surface!
- ALAudioSink.dequeueBuffer(..): Only resolve releasedBuffer elements if not null
-

Findbugs.switch-case: GLBuffers.bytesPerPixel(..) throw GLException for type BITMAP && format !COLOR_INDEX || !STENCIL_INDEX

Findbugs.increment_volatile: Use AtomicInteger or add comment that operation is safe!

GenericStereoDevice: Cast to float before operating division, requesting float. Base aspect-ratio on eyeTextureSize

Findbugs.static_final_immutable: Use final qualifier for static immutable instances.

Findbugs: Remove redundant instanceof checks

Findbugs: Use Integer.parseInt(string) for int values to avoid boxing and unboxing

Findbugs: Add FIXME comment regarding float comparison (consider using FloatUtil.isEqual(ax, bx, epsilon), FloatUtil.isZero(bx, epsilon), ..)

Findbugs: Fix WindowImpl.getReconfigureFlags(..): Remove sloppy useless assignment-or, replace by plain or

Findbugs: Add comment about intended setting of static field by instance method.

Fix regression of commit 96d530e7127c89db9991080e6268c6e8430d0619: EGLDisplayUtil.eglCreateEGLGraphicsDevice(..) call w/ uninitialized 'surface'

Findbugs: Use <NumberType>.valueOf(..) instead of 'new <NumberType>(..)'

Findbugs: Remove branches where reference cannot be null

Findbugs: Remove dead-code / unused [temp] storage and it's assignment

Findbugs: Add comments that FB warnings are of no concern ..

Findbugs: Misc minor issues (see below)

- remove duplicate code in branch
- Use Type.valueOf(primitive)
- Don't use array.toString() directly
- remove dead code

AnimatorBase: Use cached synchronized value instead of unsynchronized (sloppy left-over code)

Findbugs: Use AtomicInteger for synchronized increment access

Findbugs: Use 'float' division instead of integer for float results

Findbugs: Misc issues (Use private accessors of static fields; Use boolean operator; Avoid NPE

Findbugs: Use inner static class where possible

Findbugs: Use static fields where possible

Findbugs: Comment on some issues (OK, they are) ; Remove dead branches

StereoDevice: Don't make inner class's method private due to wrapper generation (still, findbugs didn't report this)

Bug 801: Add Graph pass-2 shader for VBAA 'odd' sample count

Bug 1031: Remove Deprecated Classes and Methods (JOGL)

Removed Deprecated Class:
  - com/jogamp/opengl/util/TGAWriter.java
    - Use TextureIO w/ .tga suffix

  - com/jogamp/opengl/util/awt/Screenshot.java
    - Use:
      - com.jogamp.opengl.util.GLReadBufferUtil, or
      - com.jogamp.opengl.util.awt.AWTGLReadBufferUtil
      The latter for reading into AWT BufferedImage

      See: TestBug461FBOSupersamplingSwingAWT, TestBug605FlippedImageAWT

  - javax/media/opengl/GLPbuffer.java
    - Use:
      caps.setPBuffer(true);
      final GLAutoDrawable pbuffer = GLDrawableFactory.getFactory( caps.getGLProfile() ).createOffscreenAutoDrawable(null, caps, null, 512, 512);
    - See: TestPBufferDeadlockAWT, ..

Removed Deprecated Methods:
  - Constructor of AWT-GLCanvas, SWT-GLCanvas, AWT-GLJPanel
    with argument 'final GLContext shareWith'
    See GLSharedContextSetter, i.e. glCanvas.setSharedContext(..) !

  - GLDrawableFactory.createOffscreenAutoDrawable(..)
    with argument 'final GLContext shareWith'
    See GLSharedContextSetter, i.e. offscreenAutoDrawable.setSharedContext(..) !

  - GLDrawableFactory.createGLPbuffer(..),
    see above!

  - com.jogamp.opengl.util.av.AudioSink 'enqueueData(AudioDataFrame audioDataFrame)',
    use 'enqueueData(int, ByteBuffer, int)'

  - GLSharedContextSetter.areAllGLEventListenerInitialized(),
    migrated to GLAutoDrawable !

  - GLBase's
    - glGetBoundBuffer(int), use getBoundBuffer(int)
    - glGetBufferSize(int), use getBufferStorage(int).getSize()
    - glIsVBOArrayBound(), use isVBOArrayBound()
    - glIsVBOElementArrayBound(), use isVBOElementArrayBound()

  - NEWT MouseEvent.BUTTON_NUMBER, use BUTTON_COUNT

Bug 982: Adding test TGA file for confirmation - No bug

StereoDeviceRenderer/ClientRenderer: Add note about 'Correct Asymmetric FOV Rendering', using FovHVHalves - incl. references

Refine JOGL's LICENSE.txt: Distinguish between 'New BSD 2-Clause License' compatible and not-compatible materials! OculusVR RIFT SDK license is not compatible, but usable and optional!

.. also refine A.7) Oculus VR Rift SDK Software License

Refine commit ec2d94ca26ddab8ec67135ebc5f2d0a43f6a4c25: Call 'areAllGLEventListenerInitialized()' directly from GLAutoDrawable

Refine 'GLSharedContextSetter' test cases: Use 'setSharedAutoDrawable(sharedAutoDrawable)' where possible; Fix/Refine API doc.

StereoClientRenderer: Fix API doc anchor link

Refine commit 808d95cd692ab666271a83c70e8509859586de72 LICENSE.txt: Add optional removal of oculusvr artifacts from official builds, if user dislikes.