Changes

Graph minor linear optimization: Passing array storage (reduce temp array) and use array ref access.

Graph minor linear optimization: use vertexInTriangle3(..) reduces redundant computations

graph test: TestTextRendererNEWT10 cleanup

Bug 801: Graph TextRenderer Cleanup Part-1a (unclean)

Remark: This commit is unclean and requires 'Part-1b' due to
        merging this commit after more than 2 years!

Graph:
  - Use List<OutlineShape> instead of array
    allowing more flexible memory managment.

  - GLRegion -> Region promotion:
    - Region create(List<OutlineShape> outlineShapes, int renderModes)
    - Region create(OutlineShape outlineShape, int renderModes)

  - Region additions
    - void addOutlineShape(OutlineShape shape)
    - void addOutlineShapes(List<OutlineShape> shapes)

  - RegionRenderer
    - draw(..) remove 'position', redundant
    -

  - Deprecate 'TextRenderer' and 'GlyphString'
    Use Region.create(Font.getOutlineShapes(...)) + RegionRenderer instead.

  - FontInt -> Font promotion (make public)
    - getOutlineShape and getOutlineShapes

  - Font.Glyph additions
    - 'getID(), hashCode()'
    - 'float getScale(float pixelSize)'

  - GlyphShape
    - Add reference to Glyph allowing GlyphString
      to access the font metrics for translation and scaling

    - Experimental pre-scale/translation in GlyphString
      using default font size and it's metrics

Bug 801: Graph TextRenderer Cleanup Part-1b (clean)

Concludes commit f51933f0ebe9ae030c26c066e59a728ce08b8559
w/ final fixes on merge commit 3352601e0860584509adf2b76f993d03893ded4b.

Bug 802: Graph TextRenderer Performance Part-1 (incomplete, rendering artifacts)

Strategy Change:
  - Font.Glyph itself holds it's OutlineShape
    with it's default scaling.
    Triangulation is done only once per glyph!

  - A CharSequence produces a Region
    by translating and scaling each Glyphs's OutlineShape.
    This removes the need for re-triangulate - see above.
    See: TextRendererUtil

  - The indices of re-added Triangles are
    offset to the new vertices (FIXME, seems not be be accurate yet).

  - OutlineShape's vertices and triangles are reused if 'clean'.

  - Simplified code

  - Reduced copies

API Changes:
  - OutlineShape, Region, ...: See above

  - Removed TextRenderer, GlyphShape and GlyphString: Redundant

  - Added TextRendererUtil to produce the Region from CharSequence

Result:
  - Over 600 fps while changing text for each frame.
    Previously only ~60fps max.

TODO:
  - Region shall not hold the triangles itself,
    but the indices instead.
    This will remove the need to swizzle w/ vertices in the Region Renderer impl
    and easies reusage of OutlineShapes.

Bug 802: Graph TextRenderer Performance Part-2 (fix artifacts, cleanup, incomplete)

- OutlineShape
  - Add DIRTY_VERTICES bit in triangulation,
    which in turn solves the rendering artifact issue.

  - transformOutlines(..) -> protected

  - Note: Always pick triangles first, then vertices.
    The former renders vertices dirty.

- Region
  - Make triangles / vertices accessible

  - Add 'validateIndices()' to add indices for triangles,
    code moved from the GLRegion* impl.
    Shall be refined later!

- GLRegion
  - Passing 'RegionRenderer' instead of RenderState ..
    reducing argument numbers and aligning all related
    'render' methods while giving association to the RegionRenderer.

- Renderer -> RegionRenderer,
  dropping 'intermediate' RegionRenderer

  - Dropping draw() in RegionRenderer, should be issued simply
    by GLRegion in a unique fashion.

- Dropping RegionFactory
  Too simple code as-is, simply invoke in Region.create(..)

- Overall:
  - Add 'final' qualifier

  - Remove overloaded methods
    where rither default args can be used
    or a followup method call completes the 'intention'.

Bug 801: Graph TextRenderer Cleanup Part-2: Remove Path2D from Glyph/Typecast* ; Misc Cleanup

Commit c3621221b9a563495b4f54fe60e18e8db8cc57fb introduced
create an OutlineShape per Glyph from it's data w/o going through Path2D.

Misc Cleanup: Remove unused code/fields, use private/final where possible.

Bug 801: Graph TextRenderer Cleanup Part-3: Region.addOutlineShape(..) Push GL data directly incl. all index validations

Region:
  - Remove redundant methods to make
    OutlineShape the unique source.
    - addVertex(..)
    - addTriangles(..)

  - Perform all index validations in addOutlineShape(..)

  - Push OutlineShape's vertex data
    and it's triangle indices directly to VBO.

GLRegion: Add clear(..) method, allowing to clear the region
          for new data, i.e. OutlineShapes

Bug 801: Graph TextRenderer Cleanup Part-4: Text[Render->Region]Util API: Better separation of cached and uncached regions

Bug 801: Graph TextRenderer Cleanup Part-5: *Region API Cleanup (protected impl. part)

Bug 802: Graph TextRenderer Performance Part-3: Reuse 'float[] coordsEx' storage, ease on GC

Bug 801: Graph TextRenderer Cleanup Part-6: Fix TypecastRenderer; Minor Editing

Fix TypecastRenderer:
  - Ensure quad shapes are closed!
  - Revalidate point -> shape interpretation using orig. Typcast code
  - Fix 'midPoint(..)' use float values

Bug 801: Outline.setClosed(boolean [closed->closeTail]): Always close, but allow to either close-tail or head; OutlineShape/Triangulator: Pass 'sharpness' (very little effect though)

Bug 801: TextRegionUtil add 'special' for cache-key; Minor edits

Minor edits:
  - Add some docs to curve-shader and remove FIXME remark about gcu_Alpha, which will be used < 1.0.
  - Font: Add more TTF references

Bug 801: Fix TypecastRenderer End-Of-Contour and Shape-Closing; add cubic path

- Fix TypecastRenderer End-Of-Contour (EOC)
  - Iterate through contour block up-until EOC-1,
    not trying to create a new 'path' from EOC.

- Add cubic path
  - Detect a cubic path and use it, i.e. on-off-off-on

- Fix Shape-Closing
  - Close shape at head, not tail, since we add vertices from the head.

- Misc
  - addShape*(..) uses Point parameter 'onCurve' field
    reflecting proper handling.

Status:
  Ubuntu Font: No artifacts

  Lucida: Removed all artifacts, but for character 'M' !?
    - No odd MID point
    - Maybe inside-outside (inner) detection is buggy ?

Bug 801: TypecastRenderer: Disable DEBUG ; Performance Note: ~800-1200 fps on uncached text line

Performance Note: ~800-1200 fps on uncached text line

Compared to c3621221b9a563495b4f54fe60e18e8db8cc57fb: ~600 fps
and previous impl. ~60fps.

Bug 801: TypecastRenderer: Rename local point vars for better review

Bug 801: Enhance API doc of FontSet and FontFactory

Bug 801: TextRenderUtil/TextRendererGLELBase - Pass Font and fontSize to all methods ; TestTextRendererNEWT00 make font/fontSize configurable, animate fontSize

Bug 801: Drop TypecastRenderer's CUBIC mode if p3 is 'looped'

NEWT MonitorDevice: Add convenient getPixelsPerMM(..) method to retrieve the pixels-per-millimeter (Requires manual Conversion to dpi)

Bug 801: VBAA Render-Mode Based on SampleCount (not a user-based texWidth) ; Proper FontSize -> PixelSize

VBAA Render-Mode Based on SampleCount (not a user-based texWidth)
  - All Region based APIs now use 'sampleCount' instead of 'texWidth'

  - VBORegion2PES2 calculates perspective FBO width/height considering the sampleCount

Proper FontSize -> PixelSize
  - Font: Add getPixelSize(fontSize, dpi)

  - Text* Demos/Classes: Use proper fontSize -> PixelSize

Bug 801: TypecastRenderer: Don't use Cubic, but 'double quad' / GlyfCompositeDescript: Fix NPE

AudioSink: Fix API doc (minor edit)

Bug 801: Cleanup CDTriangulator2D

- CDTriangulator2D.getContainerLoop(..) can exit at first 'inside' loop
- Make loops field 'final' and clear at reset.
- Add more 'final' qualifier

TestRulerNEWT01: Use new MonitorDevice.getPixelsPerMM(store)

Bug 801: Add MSAA_RENDERING_BIT ; VBAA: Uses GL_NEAREST (good result) ; Demos: Use local GLRegion for uncached text (perf.) ..

Bug 801: Fix VBAA Distortions (VBO-size fractional delta) and AA (Sample fragment position and count)

Inflating the FBO pixel-size of the region using a 'samples count'
multiplier to the projected window bounding box
allows controlling the AA distortion as well as defining the
fragment position due to it's grid-fitting nature, see below.

- Fix VBAA Distortions (FBO-size fractional delta)
  Inflated framebuffer exceeds 'box-size * sampleCount'
  since it must be the ceiling of the latter due to it's integer number nature.
  This difference either must reflect the texture-coords -or- the
  texture bounding vertices-box in the 2nd pass, otherwise a distorion will appear
  which is quite visible explicit w/ text.
  Using texture-coords is not suitable, due to floating point accuracy,
  hence this patch extends the texture bounding vertices-box about the ceiling delta.

  A comparible distortion existed with the previous implementation as well,
  since it used an arbitrary FBO-size and hence the magnification was not grid-fitting.

  Current implementation is grid-fitting, or at least matches the non-inflated grid,
  since it inflates the original window-size of the region about samples-count.

- AA (Sample fragment position and count)
  Using a sample-count w/ a multiple of 2 (currently 2, 4 and 8 are properly implemented),
  based on the projected window bounding box will give the 2nd-pass fragment shader (AA)
  a fragment-postion in center of the sample pixels exposing one AA pixel.
  Hence we need to use the diagonal coords (NW, SW, ..) off by half a pixel
  to reach the 1st sample-pixel .. and 1.5 pixels to reach the 2nd .. and so forth.

Bug 801: Refine 'blend' usage and modes (API-doc and demo-code)

- RegionRenderer: Make 'blend' setup pluggable via new GLCallbacks
  - 'GLCallback's for enable/disable, passed via 'create' method.
    Add 'defaultBlendEnable' and 'defaultBlendDisable',
    replacing previos fixed calls.

- GLRegion.draw(..) added API-doc notes about:
  - Decorating call with RegionRenderer.enable(..)
  - glClearColor impact and blending

- VBORegion2P*: Remove fixed glClearColor(..) call

Bug 801: VectorUtil: Pass result vector, allowing caller to manage memory (performance, reduce temp objects)

Bug 801: Fix 183e1bc1868699b99eb9f9c8bf18d646d1120a48 'window box' Calculation

Commit 183e1bc1868699b99eb9f9c8bf18d646d1120a48 only mapped object's bbox max/min points
to window space, which is wrong due to possible rotation in 3d space.

This commit adds AABBox.mapToWindow(..) method,
which correctly either uses 4 points of the bbox in 3d space (using center-z)
or all 8-points and creating a new bounding box.

The resulting width and height of this window bbox gives the
maximum amount of rectangular pixels for AA.

Bug 801: Fix UI-Graph Demo (Part-1) ; TextRegionUtil: Add Generic processString(..) using ShapeVisitor interface (visitor pattern)

Bug 801: AffineTransform: Remove Serializable, make methods final; FloatUtil: Add DEBUG and description about Row-Major and Column-Major Order. AABBOX: Use FloatUtil.DEBUG for mapToWindow(..)

Doc NEWT-Overview: Add notion about Window Parenting

Math and PMVMatrix: Cleanup and Refine

- Added final qualifier where possible

- Refined API doc

- FloatUtil:
  - Add machine EPSILON
    - fixed value and runtime computed (real machEps)
    - incl. isZero(..), isEqual(..)

  - Add makeRotationAxis(..)
    - Moved from PMVMatrix for reusage

  - Add makeRotationEuler(..)
    - New, not recommended due to Gimbal-Lock

  - Add copyMatrix[Column|Row](..)

  - Add more PI variations and trigo-func float mappings

  - Removed cross and normalize, use VectorUtil!

VectorUtil:
  - Add copyVec*
  - Add equals and isZero w/ and w/o EPSILON
  - Add distance[Square]
  - Add length[Square]

PMVMatrix:
  - Removed 'destroy' method in favor of making most fields 'final'.

AffineTransform:
  - Added AABBox transform
  - Public multiply

Quaternion: Fix and enhance class incl. Extensive Unit Tests (all passed)

- Add documentation incl references (Matrix-FAQ, Euclideanspace, ..)

- Compared w/ other impl., i.e. WildMagic, Ardor3D, ..
  and added missing functionality incl unit tests.

- PMVMatrix: Added convenient Quaternion 'hooks'
  - glRotate(Quaternion)
  - glLoadMatrix(Quaternion)

Bug 801: Add Frustum support to Region; Misc ..

Region: Add Frustum support, to drop 'out of sight' shapes

RenderState: Add hints, e.g. BITHINT_BLENDING_ENABLED,
             allowing user code to toggle background color etc

Demos: Incomplete - WIP
  - Reuse mapped object to window coords computed at reshape
  - TODO: Use minimal Scenegraph for Graph-UI ..

PMVMatrix.glLoadMatrix(Quaternion): Load Quaternion's directly w/o intermediate matrix

Bug 801: Outline/OutlineShape tranform and sort fixes ; Quaternion: Reduce muls in rotateVector

Quaternion:
  - rotateVector(..): Reduce multiplication count by 17

Graph:
  - Outline
    - add: transform
    - fix compareTo .. use EPSILON

  - OutlineShape
    - add transform
    - fix compareTo .. use EPSILON
    - use Comparator<Outline> in sortOutlines
      to avoid reversal of list

  - Extract OutlineShapeXForm, pairing { OutlineShape, AffineTransform }

Bug 801: Remove Vertex.Factory from AffineTransform ; Add AABBox tranformed resize.

Quaternion: User EPSILON for all tests against zero and one (identity .. ) and document the same. ; Minor edits ..

Bug 801: Fix GPUUISceneGLListener0A (GraphUI Demo) .. Transformations .. etc

FloatUtil/VectorUtil: Enhance isEqual/compare w/ and w/o epsilon, add unit tests - Cleanup VectorUtil (vec2/3 naming, remove dedundant functions)

NEWT: Minor edits

Add generic support for picking via raycast intersection and AABBox (or similar)

- New simple type Ray, denominating a .. ray

- Added PMVMatrix.gluUnProjectRay(..) similar to gluUnproject(..)
  however, result is a Ray.

- Added AABBox.intersectsRay(Ray) ..

Bug 801: Revisit UIShape/SceneController (Ray-Picking, Full Object/Model driven, ..) TODO: Transformations

SceneUIController handles shapes generic: Rendering, selecting and event traversing.
All data (transforms ..) are provided by UIShape.

UIShape:
  - Dispatching NEWT MouseEvent's on MouseEventListener
  - Separates the 2d-transforms for shape/region
    and 3d transform, scale and rotation

GPUUISceneGLListener0A Demo code merely
aggregates the shapes and attaches listener, hence includes
the 'application logic'.

Working:
  - picking any shape
  - dragging, zooming, actions

TODO:
  - Fix transformations, actually the rotations (button) look odd
    probably due to 'unlucky' rotation center and axis.

+++

RegionRenderer: Removed Matrix ops, which shall be applied on PMVMatrix

Quaternion: Add rotateByEuler(..); AABBox: Add translate(..); Minor edits ..

AABBox: Add rotate(..)

Bug 801: GraphUI .. Fixed transformations, cleanup - All shape-object oriented actions.

http://jogamp.org/files/screenshots/graphui/01/

Bug 801: GraphUI .. Missed 'CrossHair' Class (Commit 6382ee094953fd4fef35a8e60a29b482ae1b79c3)

Fix GraphUI - Remove MSAA if in VBAA mode (double AA not so good) - Adding NApplet for VBAA

SceneUIController: Remove unused (and not commited) Matrix reference

Graph: Fix NPE in case of double destroy call ..

Graph: Fix NPE in case of double destroy call .. (VBORegion2PMSAAES2)