/** * 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 com.jogamp.graph.curve; import java.util.ArrayList; import java.util.List; import jogamp.graph.geom.plane.AffineTransform; import jogamp.opengl.Debug; import com.jogamp.graph.geom.Triangle; import com.jogamp.graph.geom.Vertex; import com.jogamp.opengl.math.geom.AABBox; import com.jogamp.opengl.math.geom.Frustum; import com.jogamp.opengl.util.texture.TextureSequence; /** * Abstract Outline shape representation define the method an OutlineShape(s) * is bound and rendered. * * @see com.jogamp.graph.curve.opengl.GLRegion */ public abstract class Region { /** Debug flag for region impl (graph.curve) */ public static final boolean DEBUG = Debug.debug("graph.curve"); public static final boolean DEBUG_INSTANCE = Debug.debug("graph.curve.Instance"); /** * Rendering-Mode bit for {@link #getRenderModes() Region} *
* MSAA based Anti-Aliasing, a two pass region rendering, slower and more * resource hungry (FBO), but providing fast MSAA in case * the whole scene is not rendered with MSAA. *
*/ public static final int MSAA_RENDERING_BIT = 1 << 0; /** * Rendering-Mode bit for {@link #getRenderModes() Region} ** View based Anti-Aliasing, a two pass region rendering, slower and more * resource hungry (FBO), but AA is perfect. Otherwise the default fast one * pass MSAA region rendering is being used. *
*/ public static final int VBAA_RENDERING_BIT = 1 << 1; /** * Rendering-Mode bit for {@link #getRenderModes() Region} ** Use non uniform weights [0.0 .. 1.9] for curve region rendering. * Otherwise the default weight 1.0 for uniform curve region rendering is * being applied. *
*/ public static final int VARWEIGHT_RENDERING_BIT = 1 << 8; /** * Rendering-Mode bit for {@link #getRenderModes() Region} ** If set, a color channel attribute per vertex is added to the stream, * otherwise only the * {@link com.jogamp.graph.curve.opengl.RegionRenderer#setColorStatic(javax.media.opengl.GL2ES2, float, float, float, float) static color} * is being used. *
*/ public static final int COLORCHANNEL_RENDERING_BIT = 1 << 9; /** * Rendering-Mode bit for {@link #getRenderModes() Region} ** If set, a color texture is used to determine the color. *
*/ public static final int COLORTEXTURE_RENDERING_BIT = 1 << 10; /** Default maximum {@link #getQuality() quality}, {@value}. */ public static final int MAX_QUALITY = 1; public static final int DEFAULT_TWO_PASS_TEXTURE_UNIT = 0; protected static final int DIRTY_SHAPE = 1 << 0 ; protected static final int DIRTY_STATE = 1 << 1 ; private final int renderModes; private int quality; private int dirty = DIRTY_SHAPE | DIRTY_STATE; private int numVertices = 0; protected final AABBox box = new AABBox(); protected Frustum frustum = null; public static boolean isVBAA(final int renderModes) { return 0 != (renderModes & Region.VBAA_RENDERING_BIT); } public static boolean isMSAA(final int renderModes) { return 0 != (renderModes & Region.MSAA_RENDERING_BIT); } public static boolean isTwoPass(final int renderModes) { return 0 != ( renderModes & ( Region.VBAA_RENDERING_BIT | Region.MSAA_RENDERING_BIT) ); } /** * Returns true if render mode capable of variable weights, * i.e. the bit {@link #VARWEIGHT_RENDERING_BIT} is set, * otherwise false. */ public static boolean hasVariableWeight(final int renderModes) { return 0 != (renderModes & Region.VARWEIGHT_RENDERING_BIT); } /** * Returns true if render mode has a color channel, * i.e. the bit {@link #COLORCHANNEL_RENDERING_BIT} is set, * otherwise false. */ public static boolean hasColorChannel(final int renderModes) { return 0 != (renderModes & Region.COLORCHANNEL_RENDERING_BIT); } /** * Returns true if render mode has a color texture, * i.e. the bit {@link #COLORTEXTURE_RENDERING_BIT} is set, * otherwise false. */ public static boolean hasColorTexture(final int renderModes) { return 0 != (renderModes & Region.COLORTEXTURE_RENDERING_BIT); } public static String getRenderModeString(final int renderModes) { final String curveS = hasVariableWeight(renderModes) ? "-curve" : ""; final String cChanS = hasColorChannel(renderModes) ? "-cols" : ""; final String cTexS = hasColorTexture(renderModes) ? "-ctex" : ""; if( Region.isVBAA(renderModes) ) { return "vbaa"+curveS+cChanS+cTexS; } else if( Region.isMSAA(renderModes) ) { return "msaa"+curveS+cChanS+cTexS; } else { return "norm"+curveS+cChanS+cTexS; } } protected Region(final int regionRenderModes) { this.renderModes = regionRenderModes; this.quality = MAX_QUALITY; } // FIXME: Better handling of impl. buffer growth .. ! // protected abstract void setupInitialComponentCount(int attributeCount, int indexCount); protected abstract void pushVertex(final float[] coords, final float[] texParams, float[] rgba); protected abstract void pushIndex(int idx); /** * Return bit-field of render modes, see {@link com.jogamp.graph.curve.opengl.GLRegion#create(int, TextureSequence)}. */ public final int getRenderModes() { return renderModes; } /** See {@link #MAX_QUALITY} */ public final int getQuality() { return quality; } /** See {@link #MAX_QUALITY} */ public final void setQuality(final int q) { quality=q; } protected void clearImpl() { dirty = DIRTY_SHAPE | DIRTY_STATE; numVertices = 0; box.reset(); } /** * Returns true if capable of two pass rendering - VBAA, otherwise false. */ public final boolean isVBAA() { return Region.isVBAA(renderModes); } /** * Returns true if capable of two pass rendering - MSAA, otherwise false. */ public final boolean isMSAA() { return Region.isMSAA(renderModes); } /** * Returns true if capable of variable weights, otherwise false. */ public final boolean hasVariableWeight() { return Region.hasVariableWeight(renderModes); } /** * Returns true if render mode has a color channel, * i.e. the bit {@link #COLORCHANNEL_RENDERING_BIT} is set, * otherwise false. */ public boolean hasColorChannel() { return Region.hasColorChannel(renderModes); } /** * Returns true if render mode has a color texture, * i.e. the bit {@link #COLORTEXTURE_RENDERING_BIT} is set, * otherwise false. */ public boolean hasColorTexture() { return Region.hasColorTexture(renderModes); } /** See {@link #setFrustum(Frustum)} */ public final Frustum getFrustum() { return frustum; } /** * Set {@link Frustum} culling for {@link #addOutlineShape(OutlineShape, AffineTransform, float[])}. */ public final void setFrustum(final Frustum frustum) { this.frustum = frustum; } final float[] coordsEx = new float[3]; private void pushNewVertexImpl(final Vertex vertIn, final AffineTransform transform, final float[] rgba) { if( null != transform ) { final float[] coordsIn = vertIn.getCoord(); transform.transform(coordsIn, coordsEx); coordsEx[2] = coordsIn[2]; box.resize(coordsEx[0], coordsEx[1], coordsEx[2]); pushVertex(coordsEx, vertIn.getTexCoord(), rgba); } else { box.resize(vertIn.getX(), vertIn.getY(), vertIn.getZ()); pushVertex(vertIn.getCoord(), vertIn.getTexCoord(), rgba); } numVertices++; } private void pushNewVertexIdxImpl(final Vertex vertIn, final AffineTransform transform, final float[] rgba) { pushIndex(numVertices); pushNewVertexImpl(vertIn, transform, rgba); } private final AABBox tmpBox = new AABBox(); /** * Add the given {@link OutlineShape} to this region with the given optional {@link AffineTransform}. ** In case {@link #setFrustum(Frustum) frustum culling is set}, the {@link OutlineShape} * is dropped if it's {@link OutlineShape#getBounds() bounding-box} is fully outside of the frustum. * The optional {@link AffineTransform} is applied to the bounding-box beforehand. *
* @param rgbaColor TODO */ public final void addOutlineShape(final OutlineShape shape, final AffineTransform t, final float[] rgbaColor) { if( null != frustum ) { final AABBox shapeBox = shape.getBounds(); final AABBox shapeBoxT; if( null != t ) { t.transform(shapeBox, tmpBox); shapeBoxT = tmpBox; } else { shapeBoxT = shapeBox; } if( frustum.isAABBoxOutside(shapeBoxT) ) { if(DEBUG_INSTANCE) { System.err.println("Region.addOutlineShape(): Dropping outside shapeBoxT: "+shapeBoxT); } return; } } final List