Changes

FIX: Refactor GLArrayData and all it's implementations/sub-interfaces (VBO target, comments, names)

VBO target: Allowing ELEMENT_VERTEX_ARRAY w/o corresponding GLSL/Fixed attribute

Names: Clarified method named.

Comments: Added and fixed comments

Fix FBObject: Remove double stencil RB generation; Expose data (size, ..)

Fix: Cached GlyphString handling

- Destroy removed ones
- Handle overwrite/update on same key
- Clarified names (size/limit)
- Handle cache limit unlimited (limit := -1) and no cache (limit := 0)
- Default cache limit := 256
- Comments

Use common constants for shader attributes (needs to be completed)

Use GLArrayDataServer to handle shader attributes/data using VBO

Added getBounds impl to region, returning AABBox

Fix: AABBox setLow/setHigh call resize; removes possible call error

TextRenderer - createString exposed; Renderer - added scale();

createString function is now public to be able to create a string
without initializing textRenderer. Temp change, should be cleaned up.

added missing scale transformation to renderer pmvmatrix;

added glyphstring.getBounds() so not to use font.getStringBounds.
since it Would be a redundant call.

Added demo GPU Resolution Indep UI - Button;

RIButton - resolution independent vector based button
UINewtDemo01 --> shows a testcase of a button rendered on scene.
controls: 1/2: zoom in/out
4/5: increase/decrease shape/text spacing
6/7: increase/decrease corner size
0/9: rotate.

Added headers to graph.ui classes

destroy: clear vertices/triangle arrays

resolve conflicts

Fix TAB: Replace all TAB with 4 spaces

Add com.jogamp.graph disclaimer

Add GL: glGetBufferSize(int buffer) - buffer size tracking, and add comments ..

ant all.ide target: use all debug flags (+vars)

copy all fonts and shader to build folder, allowing ide debugging

Texture: Change method signatures: Pass GL context object if required (remove GLContext.getCurrentGL() usage.

Using function signatures explicitly require the GL [current] instance clarifies
that the context must be current.

Removing GLContext.getCurrentGL() reduces TLS access of current thread
and hence possible performance hits.

The Texture class has been chosen for this conversion [not TextureIO yet],
since the enable/bind methods maybe used within a rendering loop.
User already 'complained' about lack of current GLContext clarity as well.

GLContext changes:

change:
  putAttachedObject(String) -> attachObject(String)
  putAttachedObject(int) -> attachObject(int)

new:
  validateCurrent()

  the 'int' mapped/attached objects are using the IntIntHashMap now

Fix GLProfile: Order of profiles Hi -> Low

Ensure returning the highest profile always:

all old: GL4bc, GL3bc, GL2, GL2GL3, GL4, GL3,    GL2ES2, GLES2,  GL2ES1, GLES1
all new: GL4bc, GL3bc, GL2, GL4,    GL3, GL2GL3, GLES2,  GL2ES2, GLES1,  GL2ES1

Fix/Add: Locator (Handle JarURLConnection and ..)

new: 'public static String getRelativeOf(URL baseLocation, String relativeFile)',
     capable of handling a JAR file/url.

Using File based relative locator, allowing better utilization in code:
  old public static String getRelativeOf(String absoluteFileLocation, String relativeFile)
  new public static String getRelativeOf(File baseLocation, String relativeFile)

reflect GLContext changes a5430cf16727fdc7bcfb17ef251018cc479d5f5d

simple cleanup/warnings

GLBufferSizeTracker/GLBufferStateTracker: Remove Redundancy

GLBufferStateTracker.isBoundBufferObjectKnown() is redundant, since it's 'get'
method added it if not yet known.

GLBufferSizeTracker removed above mentioned call, fallback to std GL query, no exception.

NEWT GLWindow: Remove context current check for swapBuffer() call

The spec doesn't require a current context for a swap buffer call, however,
if required .. as user shall encapsulate it by himself, or use the GLEventListener model.

Motivation: Reduce TLS GLContext.getCurrent() calls.

GLArrayData API and impl. changes

+++

Remove GL parameter for
 - createFixed(..)
 - createGLSL(..)

validation at client/server array data happens at 1st enableBuffer() call,
no current context or profile required at creation time.

Added ShaderState for createGLSL(..) clarifying dependency to the ShaderState,
passing it down to the GLSLArrayHandler, which also removes the TLS GLContext.getCurrent() call.

+++

Partially reverted ab48dac3f4419ceac51fdf059f310f0f0499c4d7 factory methods:
  removed added vboTarget parameter, since all createFixed and createGLSL are GL_ARRAY_BUFFER (VBO).

Adding createData(..) factory method in GLArrayDataServer allowing diff vbo targets,
ie GL_ELEMENT_ARRAY_BUFFER .. or none.

FBObject: Add validation / API cleanup

Added validation of FB/render buffer creation using glGetError(),
due to users trouble of determine the root cause of erroneous application behavior.

This change shall help tackling bug: 492 and 495
  https://jogamp.org/bugzilla/show_bug.cgi?id=492
  https://jogamp.org/bugzilla/show_bug.cgi?id=495

test: reflect GLArrayData changes bf8a54b502f0fcd930e12a8bbda65f9538e8a2f7

ShaderState: Validated impl./state-handling / Added comments

Capable of glBinAttribLocation(..)

Proper state check (has program, linked program, ..) for attrib/uniform methods.

Refactored graph: Reduce/remove data copy/recreation; Shader cleanup

- Pass the current GL context object where it's required

- Introduce RenderState (which has ShaderState) to acquire/change shader related data (Region)

- Shader Cleanup: User import for common stuff; use req. version

- Reduce/remove data copy/recreation in *Region implementation

- UI/RIButton: Use defaults I like :)

GLContextImpl: GLContextLock -> RecursiveLock

RecursiveLock maintains a queue of waiting Threads,
ensuring the longest waiting thread will be notified at unlock.

Delete GLContextLock.

Cleanup HashMap generics style.

New FPSCounter, impl. by GLWindow and GLAnimatorControl (fps perf related API change)

- Don't fetch System.currentTimeMillis() by default and for every frame (performance)
- Default behavior is FPSCounter switched off
- Enable by frame interval, ie measure each 60 frames.
- FPSCounterImpl is default impl. used by impl. FPSCounter class (reduce code/redundancy)

- Might be promoted to GLAutoDrawable ?!

Add unified support for GL_ARB_debug_output and GL_AMD_debug_output.

If GL_ARB_debug_output is not available, but GL_AMD_debug_output exist, fallback to the latter,
offering generic aliased methods translating the delta (AMD category <-> ARB source/type).

Generic aliased methods reside in GLContext*

Enable/Disable via GLContext and GLAutoDrawable.

To enable the GLDebugOutput feature GLContext.enableGLDebugMessage(true)
or GLContext.setContextCreationFlags(GLContext.CTX_OPTION_DEBUG)
shall be called _before_ context creation via GLContext.makeCurrent()!

In case GLAutoDrawable is being used,
GLAutoDrawable.setContextCreationFlags(GLContext.CTX_OPTION_DEBUG)
shall be issued before context creation via GLContext.makeCurrent()!.

After context creation, the GLDebugOutput feature may be enabled or disabled
at any time using this method.

Verify both unit tests for usability.

Misc cleanup, strings etc

Fixed a few GL method's String parameter (explicit gluegen String declaration)

GLDrawableHelper: listener's locking cleaned ; Fix generics (warnings) ..

GLDrawableHelper always locked access to it's listeners, hence no copy is required
for add/remove a listener.

Writeout generics (warnings)

NEWT Event Types: Use final modifier if possible

Fix junit tests: Enable FPSCounter (missing from ea819ff768d507c37a981c1ab0bdc0cad32c6a87)

Graph: Fix AMD shader complain (version) ; No Attributes in fragment program ; Disable FPS draw at start

jogl.debug.DebugGL enables new DebugMessage/Output feature

GLContextImpl.createContextARB(..): Use impl. GLProfile to determine requested context

.. this fixes the bug where [GL2ES2/GL4bc] didn't fetch GL4bc, but a GL2 old context.

test scripts

FPSCounter def to 5*60 frames (each 5s at 60Hz) ; Test: each 1s

Fix GLSL Shader tests ..

graph/glsl: AMD need vertice attrib location 0 ..

Use less updated animator fps

ShaderState: 'Update' vertexAttribMap on enable

ShaderProgram:
  - shaderCode's HashMap -> HashSet
  - adding HashSet for attached ShaderCode
  - link: allow relink, attachShader only if not yet attached
  - new add(gl, ShaderCode, ..) method, allowing compile/attach pre linkage
  - remove boxing of integer 'id', use generics style (warnings)
  - rename: glReplaceShader -> replaceShader, glUseProgram -> useProgram
  - fix: replaceShader
  - hashCode _is_ 'id'

ShaderCode:
  - remove boxing of integer 'id', use generics style (warnings)
  - hashCode _is_ 'id'

ShaderUtil: Use generics style (warnings), static names

NEWT/X11 WindowClosing: End dispatch loop since Display could be destroyed after Java callback

NativeWindow/X11: Simple cleanup/generalization ..

Newt Window: Remove 'invalidate()' method, only 'destroy()' is required (and makes sense)

- WindowImpl/GLWindow: Cleanup destroy code ..
- Tests: sync / remove FPS stderr print

ShaderState: Add 'ownUniform()/ownAttribute()'; rename glFunction -> function; switch program enh. ; Graph lifecycle

Add 'ownUniform()/ownAttribute()' allowing to reset all bound uniforms/attributes,
not just active ones plus handling the lifecycle of the owned attributes (destroy).
This simplifies the lifecycle of all shader attributes.

Rename glFunction -> function .. well, the GL attribute marks them GL related already

Switch program enhancement. If switching to new program (unlinked), issue glBindAttributeLocation ..

Graph lifecycle cleanup using the above ..

Graph Demos: Add F4 key to exit; Proper exit sequence w/ animator.stop() after window is destroyed to exit the JVM

test script

Newt Window: Missing change of f47230cb4649df13260ac56c5dae6c01dad7c1e7 (remove invalidate())