/** * Copyright 2023 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.ui; import java.util.Arrays; import java.util.Collection; import java.util.Comparator; import java.util.List; import java.util.concurrent.CopyOnWriteArrayList; import com.jogamp.graph.curve.Region; import com.jogamp.graph.curve.opengl.RegionRenderer; import com.jogamp.graph.ui.layout.Padding; import com.jogamp.graph.ui.shapes.Rectangle; import com.jogamp.math.Vec3f; import com.jogamp.math.Vec4f; import com.jogamp.math.geom.AABBox; import com.jogamp.math.util.PMVMatrix4f; import com.jogamp.opengl.GL2ES2; import com.jogamp.opengl.GLProfile; import jogamp.graph.ui.TreeTool; /** * Group of {@link Shape}s, optionally utilizing a {@link Group.Layout}. * @see Scene * @see Shape * @see Group.Layout */ public class Group extends Shape implements Container { /** Layout for the GraphUI {@link Group}, called @ {@link Shape#validate(GL2ES2)} or {@link Shape#validate(GLProfile)}. */ public static interface Layout { /** Prepare given {@link Shape} before {@link Shape#validate(GL2ES2) validation}, e.g. {@link Shape#setPaddding(Padding)}. */ void preValidate(final Shape s); /** * Performing the layout of {@link Group#getShapes()}, called @ {@link Shape#validate(GL2ES2)} or {@link Shape#validate(GLProfile)}. *
* According to the implemented layout, method * - may scale the {@Link Shape}s * - may move the {@Link Shape}s * - may reuse the given {@link PMVMatrix4f} `pmv` * - must update the given {@link AABBox} `box` *
* @param g the {@link Group} to layout * @param box the bounding box of {@link Group} to be updated by this method. * @param pmv a {@link PMVMatrix4f} which can be reused. */ void layout(final Group g, final AABBox box, final PMVMatrix4f pmv); } private final List* Default is non-interactive, see {@link #setInteractive(boolean)}. *
*/ public Group() { this(null); } /** * Create a group of {@link Shape}s w/ given {@link Group.Layout}. ** Default is non-interactive, see {@link #setInteractive(boolean)}. *
* @param l optional {@link Layout}, maybe {@code null} */ public Group(final Layout l) { super(); this.layouter = l; this.setInteractive(false); } @Override public final boolean isGroup() { return true; } /** Return current {@link Group.Layout}. */ public Layout getLayout() { return layouter; } /** Set {@link Group.Layout}. */ public Group setLayout(final Layout l) { layouter = l; return this; } @Override public int getShapeCount() { return shapes.size(); } @Override public List* This method modifies all elements of this group for enabled or disabled widget behavior. *
* @param v enable or disable * @return this group for chaining */ public final Group setWidgetMode(final boolean v) { widgetMode = v; if( v ) { enableUniActivationImpl(true, forwardActivation); } else { enableUniActivationImpl(false, null); } return this; } protected final void enableUniActivationImpl(final boolean v, final Listener activationListener) { for(final Shape s : shapes ) { if( s.isGroup() ) { final Group sg = (Group)s; sg.setWidgetMode(v); } s.onActivation(activationListener); } } /** Returns whether {@link #setWidgetMode(boolean)} is enabled or disabled. */ public final boolean getWidgetMode() { return widgetMode; } @Override public boolean isActive() { return super.isActive() || ( widgetMode && forAll((final Shape gs) -> { return gs.isActive(); } ) ); } @Override public float getAdjustedZ() { final float[] v = { getAdjustedZImpl() }; if( widgetMode && !super.isActive() ) { forAll((final Shape gs) -> { if( gs.isActive() ) { v[0] = gs.getAdjustedZImpl(); return true; } else { return false; } } ); } return v[0]; } @Override protected boolean isShapeDirty() { if( relayoutOnDirtyShapes ) { // Deep dirty state update: // - Ensure all group member's dirty state is updated // - Allowing all group member's validate to function for(final Shape s : shapes) { if( s.isShapeDirty() ) { markShapeDirty(); } } } return super.isShapeDirty(); } @Override protected void validateImpl(final GLProfile glp, final GL2ES2 gl) { if( isShapeDirty() ) { final boolean needsRMs = hasBorder() && null == border; GraphShape firstGS = null; // box has been reset final PMVMatrix4f pmv = new PMVMatrix4f(); if( null != layouter ) { for(final Shape s : shapes) { if( needsRMs && null == firstGS && s instanceof GraphShape ) { firstGS = (GraphShape)s; } layouter.preValidate(s); if( null != gl ) { s.validate(gl); } else { s.validate(glp); } } layouter.layout(this, box, pmv); } else { final AABBox tsbox = new AABBox(); for(final Shape s : shapes) { if( needsRMs && null == firstGS && s instanceof GraphShape ) { firstGS = (GraphShape)s; } if( null != gl ) { s.validate(gl); } else { s.validate(glp); } pmv.pushMv(); s.setTransformMv(pmv); s.getBounds().transform(pmv.getMv(), tsbox); pmv.popMv(); box.resize(tsbox); } } if( hasPadding() ) { final Padding p = getPadding(); final Vec3f l = box.getLow(); final Vec3f h = box.getHigh(); box.resize(l.x() - p.left, l.y() - p.bottom, l.z()); box.resize(h.x() + p.right, h.y() + p.top, l.z()); setRotationPivot( box.getCenter() ); } if( hasBorder() ) { if( null == border ) { final int firstRMs = null != firstGS ? firstGS.getRenderModes() : 0; final int myRMs = Region.isVBAA(firstRMs) ? Region.VBAA_RENDERING_BIT : 0; border = new Rectangle(myRMs, box, getBorderThickness()); } else { border.setVisible(true); border.setBounds(box, getBorderThickness()); } border.setColor(getBorderColor()); } else if( null != border ) { border.setVisible(false); } } } @Override public boolean contains(final Shape s) { if( shapes.contains(s) ) { return true; } for(final Shape shape : shapes) { if( shape instanceof Container ) { if( ((Container)shape).contains(s) ) { return true; } } } return false; } @Override public Shape getShapeByIdx(final int id) { if( 0 > id ) { return null; } return shapes.get(id); } @Override public Shape getShapeByID(final int id) { for(final Shape b : shapes) { if(b.getID() == id ) { return b; } } return null; } @Override public Shape getShapeByName(final String name) { for(final Shape b : shapes) { if( b.getName().equals(name) ) { return b; } } return null; } @Override public AABBox getBounds(final PMVMatrix4f pmv, final Shape shape) { pmv.reset(); setTransformMv(pmv); final AABBox res = new AABBox(); if( null == shape ) { return res; } forOne(pmv, shape, () -> { shape.getBounds().transform(pmv.getMv(), res); }); return res; } @Override public String getSubString() { return super.getSubString()+", shapes "+shapes.size(); } @Override public boolean forOne(final PMVMatrix4f pmv, final Shape shape, final Runnable action) { return TreeTool.forOne(shapes, pmv, shape, action); } @Override public boolean forAll(final Visitor1 v) { return TreeTool.forAll(shapes, v); } @Override public boolean forAll(final PMVMatrix4f pmv, final Visitor2 v) { return TreeTool.forAll(shapes, pmv, v); } @Override public boolean forSortedAll(final Comparator