Changes

Fix Bug 810: Adding Julien Gouesse's fix while moved the new 'addNativeJarLibsJoglCfg(..)' to GlueGen, commit c0ead6fa10280f8076704726d59f482b183fd77e

GL*, GLContext: Expose isGL2ES3() and getGL2ES3() for convenience.

GLBuffers: Align comment

GLPixelStorageModes: Fix API doc references, Add set[Pack|Unpack]RowLength(GL2ES3 gl, ..)

GLReadBufferUtil.readPixels(..): Use plain int values for inWidth/inHeight, instead int[] - no return value desired.

Gears: Make rotation optional

Cleaned up TiledRenderer capable to be used w/ GL2ES3 and TiledRenderer2 to be used w/ GLAutoDrawable.

- Remove GL2 dependencies
  - Only requires PixelStorage ROW_LENGTH -> GL2ES3

  - Position target buffer position according to skip [pixels, rows]

  - Use an interface PMVMatrixCallback, allowing user to reshape
    the custom 'PMV Matrix' according to the current rendered tile

- Properly adjust tile/image buffer to written position and flip for read operation

Test scripts ..

GLPixelBuffer*: Add componentCount==1 (ALPHA/RED), 'allowRowStride' utilization AWTGLPixelBuffer* -> GLPixelBuffer*

GLPixelBufferProvider:
  - Default*.getAttributes(): Add componentCount==1 (ALPHA/RED), validate values, throw exception if n/a or not supported
  - Add 'allowRowStride' (as for AWTGLPixelBufferProvider)
    - Add default for true and false

GLPixelBuffer:
  - Add 'allowRowStride' (as for AWTGLPixelBuffer)
  - Fix requiresNewBuffer(..):
    - aquire minByteSize if passed one is <= 0
    - validate minByteSize w/ currentByteSize according to allowRowStride.

AWTGLPixelBuffer: 'allowRowStride' impl. moved to GLPixelBuffer.

PNGImage: Bounds check in getPixelRGBA8(..) and setPixelRGBA8(..)

TileRenderer: Unify TileRenderer, add RandomTileRenderer (both utilizing GLPixelBuffer, and pre/post GLEventListener)

TileRenderer*: Align impl. to common abstract superclass TileRendererBase (cleanup / API doc)

TileRenderer*: Enhance API Doc; Cleanup OO; Remove PMVMatrixCallback, use GLEventListener reshape(..) or manual reshape after beginTile(..) method.

GLEventListener reshape(..) method should be aware of TileRenderer usage
and get the missing tile position and image size from it (-> see Gears example).

TestRandomTiledRendering3GL2AWT demos AWT GLCanvas onscreen
being used for random tile rendering to produce a PNG file.

TestTiledRendering1GL2 is now GLAutoDrawable/GLEventListener agnostic,
hence demos plain GLDrawable tile rendering usage.

TileRendererBase: Add toString(), Proper tile unit test names, i.e. add NEWT for UI agnostic (no-awt tests).

TileRendererBase: Add interface TileRendererNotify, to notify implementing GLEventListener about attached/detached TileRenderer

.. since GLEventListener's reshape(..) method must query certain tile renderer attributes (tile pos and image size),
they have to be aware of the TileRendererBase.

To simplify such awareness and hence automate this attachement and passing over the tile renderer reference,
they should implement this new interface.

Gears example implements the new interface,
which caches the TR reference and pauses rotation.

TileRendererBase: API-doc cleanup; Fix GLCanvas, WIP printing ..

GLCanvas Printing WIP - Add TestTiledPrintingGearsAWT

GLVBOArrayHandler: Remove unused imports

Test scripts ..

TestTiledPrintingGearsAWT: Fix margin translate for high dpi, i.e. other than 72dpi

Add TestGLContextDrawableSwitch02AWT: Test AWT GLCanvas <-> GLOffscreenAutoDrawable switch, forth & back

GLDrawableUtil.swapGLContextAndAllGLEventListener: Fix comment - Add remark about GLAnimatorControl's which association gets swapped as well.

TileRenderer*: TileRenderer adds setTileOffset(..), getParam(pname) shall always return last result, no overloading of attachToAutoDrawable(..); Fix comments

TileRenderer:
 - adds setTileOffset(..)
   A tile offset might be required, i.e. via a given rectangular clip bounds

 - getParam(pname) shall always return last result
   Even when finished tiling, the last value shall be returned,
   otherwise a post endTile() is unable to retrieve the value.

 - No overloading of attachToAutoDrawable(..)
   No reason to complicate usage by mutating semantics,
   call setTileSize(..) manually

TileRendererBase:
  - Fix API doc: TR_CURRENT_TILE_X_POS, TR_CURRENT_TILE_Y_POS

TileRendering / Gears: Clarify PMV math, if tiling use white background (-> print)

GLCanvas Printing WIP: Swap to offscreen at setupPrint(); Use TileRenderer @ print(..); Test: Add auto-print w/o UI 72dpi and 300dpi

NOTE: Tile raster is added at print plus lots of debug output - WIP!

- Swap to offscreen at setupPrint()
  - Swap GLEventListener (GLEL) and GLContext to fixed size offscreen GLAutoDrawable (GLAD)
  - Destroy onscreen drawable/context
  - Setup TileRenderer w/ offscreen GLAD
  - @ releasePrint() restore onscreen ..

  This shall ensure we don't hog the GPU resources when
  resizing the AWT component (upscaling).

- Use TileRenderer @ print(..)

  The clip-rect will be used as the TileRenderer's image-size
  and we perform a whole tile-rendering loop.

  This helps to limit resources, see above.

- Test: Add auto-print w/o UI 72dpi and 300dpi