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.

1 files changed, 0 insertions, 112 deletions

diff --git a/src/jogl/classes/jogamp/graph/curve/text/GlyphShape.java b/src/jogl/classes/jogamp/graph/curve/text/GlyphShape.java
deleted file mode 100644
index 8c214dd0b..000000000
--- a/src/jogl/classes/jogamp/graph/curve/text/GlyphShape.java
+++ /dev/null
@@ -1,112 +0,0 @@
-/**
- * Copyright 2010 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 jogamp.graph.curve.text;
-
-import java.util.ArrayList;
-
-import com.jogamp.graph.font.Font.Glyph;
-import com.jogamp.graph.geom.Vertex;
-import com.jogamp.graph.geom.Triangle;
-import com.jogamp.graph.geom.Vertex.Factory;
-import com.jogamp.graph.curve.OutlineShape;
-// import com.jogamp.opengl.math.Quaternion;
-
-public class GlyphShape {
-
-    // private Quaternion quat= null;
-    private Glyph glyph;
-    private OutlineShape shape;
-
-    /** Create a new Glyph shape
-     * based on Parametric curve control polyline
-     */
-    public GlyphShape(Vertex.Factory<? extends Vertex> factory){
-        this.shape = new OutlineShape(factory);
-        this.glyph = null;
-    }
-
-    /** Create a new GlyphShape from a {@link OutlineShape}
-     * @param factory vertex impl factory {@link Factory}
-     * @param shape {@link OutlineShape} representation of the Glyph
-     */
-    public GlyphShape(Vertex.Factory<? extends Vertex> factory, Glyph glyph, OutlineShape shape){
-        this(factory);
-        this.shape = shape;
-        this.shape.transformOutlines(OutlineShape.VerticesState.QUADRATIC_NURBS);
-        this.glyph = glyph;
-    }
-
-    public final void destroy() {
-        shape.clear();
-        shape = null;
-        glyph = null;
-    }
-
-    public final Vertex.Factory<? extends Vertex> vertexFactory() { return shape.vertexFactory(); }
-
-    public final Glyph getGlyph() {
-        return glyph;
-    }
-
-    public final OutlineShape getShape() {
-        return shape;
-    }
-
-    public final int getNumVertices() {
-        return shape.getVertices().size();
-    }
-
-    /** Get the rotational quaternion attached to this Shape.
-     * @return the Quaternion Object
-    public final Quaternion getQuat() {
-        return quat;
-    }
-
-    /**
-     * Set the Quaternion that shall define the rotation
-     * of this shape.
-     * @param quat
-    public final void setQuat(Quaternion quat) {
-        this.quat = quat;
-    }
-    */
-
-    /** Triangluate the glyph shape
-     * @return ArrayList of triangles which define this shape
-     */
-    public final ArrayList<Triangle> triangulate(){
-        return shape.triangulate();
-    }
-
-    /** Get the list of Vertices of this Object
-     * @return arrayList of Vertices
-     */
-    public final ArrayList<Vertex> getVertices(){
-        return shape.getVertices();
-    }
-}