JOGL v2.6.0-rc-20250712
JOGL, High-Performance Graphics Binding for Java™ (public API).
com.jogamp.graph.ui.AnimGroup Class Reference

Group of animated Shapes including other static Shapes, optionally utilizing a Group.Layout. More...

Inheritance diagram for com.jogamp.graph.ui.AnimGroup:
Collaboration diagram for com.jogamp.graph.ui.AnimGroup:

Classes

interface  LerpFunc
 Linear interpolation (LERP) function to evaluate the next animated frame for each ShapeData of a Set. More...
 
class  ScrollLerp
 Scrolling LerpFunc, approaching ShapeData's target position over and over. More...
 
class  Set
 Animation-Set covering its ShapeData elements, LerpFunc and animation parameter. More...
 
class  ShapeData
 Animation Shapes data covering one Shape of Set. More...
 
interface  ShapeSetup
 ShapeData setup function for animation using its enclosing Set and other data points More...
 
class  SineLerp
 Sine target LerpFunc, approaching ShapeData's target position utilizing the angular value for sine amplitude towards the given normalized direction vector. More...
 
class  TargetLerp
 Default target LerpFunc, approaching ShapeData's target position inclusive angular rotation around given normalized axis. More...
 

Public Member Functions

 AnimGroup (final Layout l)
 Create a group of animated Shapes including other static Shapes w/ given Group.Layout. More...
 
Set getAnimSet (final int idx)
 Return the Set at given index or null if n/a. More...
 
final void removeAllAnimSets (final GL2ES2 gl, final RegionRenderer renderer)
 Removes all Sets and destroys them, including all ShapeData and their Shapes. More...
 
final void removeAnimSet (final GL2ES2 gl, final RegionRenderer renderer, final Set as)
 Removes the given Set and destroys it, including its ShapeData and Shape. More...
 
final void removeAnimSets (final GL2ES2 gl, final RegionRenderer renderer, final List< Set > asList)
 Removes the given Sets and destroys them, including their ShapeData and Shape. More...
 
Set addAnimSet (final float pixPerMM, final GLProfile glp, final PMVMatrix4f pmv, final Recti viewport, final float accel, final float velocity, final float ang_accel, final float ang_velo, final LerpFunc lerp, final Shape refShape)
 Add a new Set with an empty ShapeData container. More...
 
final Set addGlyphSet (final float pixPerMM, final GLProfile glp, final PMVMatrix4f pmv, final Recti viewport, final int renderModes, final Font font, final char refChar, final CharSequence text, final float fontScale, final float accel, final float velocity, final float ang_accel, final float ang_velo, final LerpFunc lerp, final ShapeSetup op)
 Add a new Set with ShapeData for each GlyphShape, moving towards its target position using a generic displacement via ShapeSetup to determine each ShapeData's starting position. More...
 
final Set addGlyphSetRandom01 (final float pixPerMM, final GLProfile glp, final PMVMatrix4f pmv, final Recti viewport, final int renderModes, final Font font, final CharSequence text, final float fontScale, final Vec4f fgCol, final float accel, final float velocity, final float ang_accel, final float ang_velo, final AABBox animBox, final boolean z_only, final Random random, final LerpFunc lerp)
 Add a new Set with ShapeData for each GlyphShape, moving towards its target position using a fixed displacement function, defining each ShapeData's starting position. More...
 
final Set addGlyphSetHorizScroll01 (final float pixPerMM, final GLProfile glp, final PMVMatrix4f pmv, final Recti viewport, final int renderModes, final Font font, final CharSequence text, final float fontScale, final Vec4f fgCol, final float velocity, final AABBox animBox, final float y_offset)
 Add a new Set with ShapeData for each GlyphShape, implementing
horizontal continuous scrolling while repeating the given text. More...
 
final void setTickOnDraw (final boolean v)
 Sets whether tick() shall be automatic issued on draw(GL2ES2, RegionRenderer), default is true. More...
 
final boolean getTickOnDraw ()
 
final void setTickPaused (final boolean v)
 Sets whether tick() shall be paused, default is false. More...
 
final boolean getTickPaused ()
 
void draw (final GL2ES2 gl, final RegionRenderer renderer)
 Renders the shape. More...
 
final void resetAnimation ()
 
final void restartAnimation ()
 
void stopAnimation ()
 
final boolean isAnimationActive ()
 
final void tick ()
 Issues an animation tick, usually done at draw(GL2ES2, RegionRenderer). More...
 
- Public Member Functions inherited from com.jogamp.graph.ui.Group
 Group ()
 Create a group of Shapes w/o Group.Layout. More...
 
 Group (final Layout l)
 Create a group of Shapes w/ given Group.Layout. More...
 
 Group (final String name, final Layout l, final Vec2f fixedSize, final Shape s)
 Create a group of Shapes w/ given Group.Layout and Shape. More...
 
final boolean isGroup ()
 Returns true if this shape denotes a Group, otherwise false. More...
 
Layout getLayout ()
 Return current Group.Layout. More...
 
Group setLayout (final Layout l)
 Set Group.Layout. More...
 
Group setFixedSize (final Vec3f v)
 Enforce size of this group for all given 3 dimensions getBounds() without adjusting 3D z-axis like setFixedSize(Vec2f). More...
 
Group setFixedSize (final Vec2f v)
 Enforce size of this group to given 2 dimensions, adjusting the 3D z-axis getBounds() giving room for potential clipping via setClipOnBounds(boolean) or setClipMvFrustum(Frustum). More...
 
Vec3f getFixedSize ()
 Returns borrowed fixed size instance, see setFixedSize(Vec3f) and setFixedSize(Vec2f). More...
 
Vec2f getFixedSize (final Vec2f out)
 Returns given Vec2f instance set with 2 dimensions, see setFixedSize(Vec2f). More...
 
Group setClipOnBounds (final boolean v)
 Enable Modelview (Mv) Frustum clipping on getBounds() for this group and its shapes as follows. More...
 
boolean getClipOnBounds ()
 Returns setClipOnBounds(boolean) value. More...
 
Group setClipMvFrustum (final Frustum v)
 Enable Modelview (Mv) Frustum clipping on explicit given pre-multiplied w/ Mv-matrix clip-box for this group and its shapes as follows. More...
 
Frustum getClipMvFrustum ()
 Returns setClipMvFrustum(Frustum) value. More...
 
int getShapeCount ()
 Returns number of Shapes, see getShapes(). More...
 
List< ShapegetShapes ()
 Returns added Shapes. More...
 
List< ShapegetRenderedShapes ()
 Returns added shapes which are rendered and sorted by z-axis in ascending order toward z-near. More...
 
void addShape (final Shape s)
 Adds a Shape. More...
 
boolean replaceShape (final Shape remove, final Shape replacement)
 Atomic replacement of the given Shape remove with Shape replacement. More...
 
Shape removeShape (final Shape s)
 Removes given shape, w/o Shape#destroy(GL2ES2, RegionRenderer). More...
 
void removeShapes (final Collection<? extends Shape > shapes)
 Removes all given shapes, w/o Shape#destroy(GL2ES2, RegionRenderer). More...
 
boolean removeShape (final GL2ES2 gl, final RegionRenderer renderer, final Shape s)
 Removes given shape with Shape#destroy(GL2ES2, RegionRenderer), if contained. More...
 
void addShapes (final Collection<? extends Shape > shapes)
 
void removeShapes (final GL2ES2 gl, final RegionRenderer renderer, final Collection<? extends Shape > shapes)
 Removes all given shapes with Shape#destroy(GL2ES2, RegionRenderer). More...
 
void removeAllShapes (final GL2ES2 gl, final RegionRenderer renderer)
 Removes all contained shapes with Shape#destroy(GL2ES2, RegionRenderer). More...
 
boolean hasColorChannel ()
 Returns true if implementation uses an extra color channel or texture which will be modulated with the passed rgba color drawImpl0(GL2ES2, RegionRenderer, float[]). More...
 
final void setPMvCullingEnabled (final boolean v)
 Enable or disable Project-Modelview (PMv) frustum culling per Shape for this container. More...
 
final boolean isPMvCullingEnabled ()
 Return whether Project-Modelview (PMv) frustum culling is enabled for this container. More...
 
final boolean isCullingEnabled ()
 Return whether Project-Modelview (PMv) frustum culling or Group's Modelview (Mv) frustum clipping is enabled for this container. More...
 
final boolean isOutside (final PMVMatrix4f pmv, final Shape shape)
 Returns whether the given Shape is completely outside of this container. More...
 
boolean isOutside2 (final Matrix4f mvCont, final Shape shape, final PMVMatrix4f pmvShape)
 Returns whether the given Shape is completely outside of this container. More...
 
void setRelayoutOnDirtyShapes (final boolean v)
 Set relayout on dirty shapes mode, defaults to true. More...
 
boolean getRelayoutOnDirtyShapes ()
 
final Group enableTopLevelWidget (final Scene scene)
 Enables top-level widget behavior for this group, default is disabled. More...
 
final Group disableTopLevelWidget ()
 Disables top-level widget behavior as potentially set via enableTopLevelWidget(Scene). More...
 
final boolean isTopLevelWidget ()
 Returns whether setTopLevelWidget(boolean) is enabled or disabled. More...
 
boolean contains (final Shape s)
 
Shape getShapeByIdx (final int id)
 
Shape getShapeByID (final int id)
 
Shape getShapeByName (final String name)
 
AABBox getBounds (final PMVMatrix4f pmv, final Shape shape)
 Returns AABBox dimension of given Shape from this container's perspective, i.e. More...
 
String getSubString ()
 
- Public Member Functions inherited from com.jogamp.graph.ui.Shape
Group getParent ()
 Returns the last parent container Group this shape has been added to or null. More...
 
final Shape setID (final int id)
 Set a symbolic ID for this shape for identification. More...
 
final int getID ()
 Return the optional symbolic ID for this shape. More...
 
Shape setName (final String name)
 Set a symbolic name for this shape for identification. More...
 
final String getName ()
 Return the optional symbolic name for this shape, defaults to noname. More...
 
boolean isGroup ()
 Returns true if this shape denotes a Group, otherwise false. More...
 
final boolean isVisible ()
 Returns true if this shape is set visible by the user, otherwise false. More...
 
final Shape setVisible (final boolean v)
 Enable (default) or disable this shape's visibility. More...
 
final Shape setPaddding (final Padding padding)
 Sets the unscaled padding for this shape, which is included in unscaled getBounds() and also includes the border. More...
 
Padding getPadding ()
 Returns unscaled Padding of this shape, which is included in unscaled getBounds() and also includes the border. More...
 
boolean hasPadding ()
 Returns true if setPaddding(Padding) added a non Padding#zeroSize() spacing to this shape. More...
 
final Shape setBorder (final float thickness)
 Sets the thickness of the border, which is included in getBounds() and is outside of getPadding(). More...
 
final boolean hasBorder ()
 Returns true if a border has been enabled via setBorder(float, Padding). More...
 
final float getBorderThickness ()
 Returns the border thickness, see setBorder(float, Padding). More...
 
final void runSynced (final Runnable action)
 Perform given Runnable action synchronized. More...
 
final void clear (final GL2ES2 gl, final RegionRenderer renderer)
 Clears all data and reset all states as if this instance was newly created. More...
 
final void destroy (final GL2ES2 gl, final RegionRenderer renderer)
 Destroys all data. More...
 
final void onDraw (final DrawListener l)
 Set a user one-shot initializer callback or custom draw(GL2ES2, RegionRenderer) hook. More...
 
final void onHover (final PointerListener l)
 Set user callback to be notified when a pointer/mouse is moving over this shape. More...
 
final void onMove (final MoveListener l)
 Set user callback to be notified when shape is move(Vec3f)'ed. More...
 
final void onToggle (final Listener l)
 Set user callback to be notified when shape toggle()'ed. More...
 
final void onClicked (final PointerListener l)
 Set user callback to be notified when shape is clicked. More...
 
final Shape addActivationListener (final Listener l)
 Add user callback to be notified when shape is activated (pointer-over and/or click) or de-activated (pointer left). More...
 
final Shape removeActivationListener (final Listener l)
 
final Shape moveTo (final float tx, final float ty, final float tz)
 Move to scaled position. More...
 
final Shape moveTo (final Vec3f t)
 Move to scaled position. More...
 
final Shape move (final float dtx, final float dty, final float dtz)
 Move about scaled distance. More...
 
final Shape move (final Vec3f dt)
 Move about scaled distance. More...
 
final Vec3f getPosition ()
 Returns position Vec3f reference, i.e. More...
 
final Quaternion getRotation ()
 Returns Quaternion for rotation. More...
 
final Shape setRotation (final Quaternion q)
 Sets the rotation Quaternion. More...
 
final Vec3f getRotationPivot ()
 Return unscaled rotation origin Vec3f reference, aka pivot. More...
 
final Shape setRotationPivot (final float px, final float py, final float pz)
 Set unscaled rotation origin, aka pivot. More...
 
final Shape setRotationPivot (final Vec3f pivot)
 Set unscaled rotation origin, aka pivot. More...
 
final Shape setScale (final Vec3f s)
 Set scale factor to given scale. More...
 
final Shape setScale (final float sx, final float sy, final float sz)
 Set scale factor to given scale. More...
 
final Shape scale (final Vec3f s)
 Multiply current scale factor by given scale. More...
 
final Shape scale (final float sx, final float sy, final float sz)
 Multiply current scale factor by given scale. More...
 
final Vec3f getScale ()
 Returns scale Vec3f reference. More...
 
final void markShapeDirty ()
 Marks the shape dirty, causing next draw() to recreate the Graph shape and reset the region. More...
 
final void markStateDirty ()
 Marks the rendering state dirty, causing next draw() to notify the Graph region to reselect shader and repaint potentially used FBOs. More...
 
final AABBox getBounds ()
 Returns the unscaled bounding AABBox for this shape, borrowing internal instance. More...
 
final float getScaledWidth ()
 Returns the scaled width of the bounding AABBox for this shape. More...
 
final float getScaledHeight ()
 Returns the scaled height of the bounding AABBox for this shape. More...
 
final float getScaledDepth ()
 
final AABBox getBounds (final GLProfile glp)
 Returns the unscaled bounding AABBox for this shape. More...
 
void drawToSelect (final GL2ES2 gl, final RegionRenderer renderer)
 Experimental selection draw command used by Scene. More...
 
void draw (final GL2ES2 gl, final RegionRenderer renderer)
 Renders the shape. More...
 
final Shape validate (final GL2ES2 gl)
 Validates the shape's underlying GLRegion. More...
 
final Shape validate (final GLProfile glp)
 Validates the shape's underlying GLRegion w/o a current GL2ES2 object. More...
 
final Shape validate (final GL2ES2 gl, final GLProfile glp)
 Validate the shape via validate(GL2ES2) if gl is not null, otherwise uses validate(GLProfile). More...
 
final void applyMatToMv (final PMVMatrix4f pmv)
 Applies the internal Matrix4f to the given modelview matrix, i.e. More...
 
final Matrix4f getMat ()
 Returns the internal Matrix4f reference. More...
 
final Matrix4f getMat (final Matrix4f out)
 Returns a copy of the internal Matrix4f to out. More...
 
final boolean isMatIdentity ()
 Returns true if getMat() has not been mutated, i.e. More...
 
final void updateMat ()
 Updates the internal Matrix4f with local position, rotation and scale. More...
 
final PMVMatrix4f setPMVMatrix (final Scene.PMVMatrixSetup pmvMatrixSetup, final Recti viewport, final PMVMatrix4f pmv)
 Setup the given PMVMatrix4f and apply this shape's transformation. More...
 
final PMVMatrix4f setPMVMatrix (final Scene scene, final PMVMatrix4f pmv)
 Setup the given PMVMatrix4f and apply this shape's transformation. More...
 
final Recti getSurfacePort (final PMVMatrix4f pmv, final Recti viewport, final Recti surfacePort)
 Retrieve surface (view) port of this shape, i.e. More...
 
final int[] getSurfaceSize (final PMVMatrix4f pmv, final Recti viewport, final int[] surfaceSize)
 Retrieve surface (view) size in pixels of this shape. More...
 
final int[] getSurfaceSize (final Scene.PMVMatrixSetup pmvMatrixSetup, final Recti viewport, final PMVMatrix4f pmv, final int[] surfaceSize)
 Retrieve surface (view) size in pixels of this shape. More...
 
final int[] getSurfaceSize (final Scene scene, final PMVMatrix4f pmv, final int[] surfaceSize)
 Retrieve surface (view) size in pixels of this shape. More...
 
final float[] getPixelPerShapeUnit (final int[] shapeSizePx, final float[] pixPerShape)
 Retrieve pixel per scaled shape-coordinate unit, i.e. More...
 
final float[] getPixelPerShapeUnit (final PMVMatrix4f pmv, final Recti viewport, final float[] pixPerShape)
 Retrieve pixel per scaled shape-coordinate unit, i.e. More...
 
final float[] getPixelPerShapeUnit (final Scene scene, final PMVMatrix4f pmv, final float[] pixPerShape)
 Retrieve pixel per scaled shape-coordinate unit, i.e. More...
 
final int[] shapeToWinCoord (final PMVMatrix4f pmv, final Recti viewport, final Vec3f objPos, final int[] glWinPos)
 Map given object coordinate relative to this shape to window coordinates. More...
 
final int[] shapeToWinCoord (final Scene.PMVMatrixSetup pmvMatrixSetup, final Recti viewport, final Vec3f objPos, final PMVMatrix4f pmv, final int[] glWinPos)
 Map given object coordinate relative to this shape to window coordinates. More...
 
final int[] shapeToWinCoord (final Scene scene, final Vec3f objPos, final PMVMatrix4f pmv, final int[] glWinPos)
 Map given object coordinate relative to this shape to window coordinates. More...
 
final Vec3f winToShapeCoord (final PMVMatrix4f pmv, final Recti viewport, final int glWinX, final int glWinY, final Vec3f objPos)
 Map given gl-window-coordinates to object coordinates relative to this shape and its z-coordinate. More...
 
final Vec3f winToShapeCoord (final Scene.PMVMatrixSetup pmvMatrixSetup, final Recti viewport, final int glWinX, final int glWinY, final PMVMatrix4f pmv, final Vec3f objPos)
 Map given gl-window-coordinates to object coordinates relative to this shape and its z-coordinate. More...
 
final Vec3f winToShapeCoord (final Scene scene, final int glWinX, final int glWinY, final PMVMatrix4f pmv, final Vec3f objPos)
 Map given gl-window-coordinates to object coordinates relative to this shape and its z-coordinate. More...
 
final Vec4f getColor ()
 Returns base-color w/o color channel, will be modulated w/ getPressedColorMod(), getToggleOnColorMod(), getToggleOffColorMod() and getActiveColorMod(). More...
 
final Vec4f getPressedColorMod ()
 Returns modulation color when isPressed(). More...
 
final Vec4f getToggleOnColorMod ()
 Returns modulation color when isToggleOn(). More...
 
final Vec4f getToggleOffColorMod ()
 Returns modulation color when not isToggleOn(). More...
 
final Vec4f getActiveColorMod ()
 Returns modulation color when isActive(). More...
 
Shape setColor (final float r, final float g, final float b, final float a)
 Set base color. More...
 
Shape setColor (final Vec4f c)
 Set base color. More...
 
Shape setPressedColorMod (final float r, final float g, final float b, final float a)
 Set pressed color, modulating getColor() if isPressed(). More...
 
final Shape setToggleOnColorMod (final float r, final float g, final float b, final float a)
 Set toggle-on color, modulating getColor() if isToggleOn() and setToggleable(boolean). More...
 
final Shape setToggleOffColorMod (final float r, final float g, final float b, final float a)
 Set toggle-off color, modulating getColor() if !isToggleOn() and setToggleable(boolean). More...
 
final Shape setActiveColorMod (final Vec4f c)
 Enable active color, modulation getColor() if isActive() with passing c != null, disable with passing c == null. More...
 
final Vec4f getBorderColor ()
 
final Shape setBorderColor (final float r, final float g, final float b, final float a)
 Set border color. More...
 
final Shape setBorderColor (final Vec4f c)
 Set border color. More...
 
final String toString ()
 
String getSubString ()
 
final Shape setPressed (final boolean b)
 
final boolean isPressed ()
 
final Shape setToggleable (final boolean toggleable)
 Set this shape toggleable, default is off. More...
 
boolean isToggleable ()
 Returns true if this shape is toggable, i.e. More...
 
final Shape setToggle (final boolean v)
 Set this shape's toggle state, default is off. More...
 
final Shape toggle ()
 
final boolean isToggleOn ()
 Returns true this shape's toggle state. More...
 
final boolean isActive ()
 Returns true of this shape is active. More...
 
final float getAdjustedZ ()
 
Tooltip setToolTip (final Tooltip newTooltip)
 Set's a new Tooltip for this shape. More...
 
void removeToolTip ()
 
Tooltip getTooltip ()
 
final Shape setInteractive (final boolean v)
 Set whether this shape is interactive in general, i.e. More...
 
final boolean isInteractive ()
 Returns if this shape allows user interaction in general, see setInteractive(boolean). More...
 
final Shape setActivable (final boolean v)
 Set whether this shape is allowed to be activated, i.e become isActive(). More...
 
final boolean isActivable ()
 Returns if this shape is allowed to be activated, i.e become isActive(). More...
 
final Shape setDiscarded (final boolean v)
 Set whether this shape is discarded in last draw(GL2ES2, RegionRenderer), i.e. More...
 
final boolean isDiscarded ()
 Returns whether this shape is discarded in last draw(GL2ES2, RegionRenderer), i.e. More...
 
final Shape setDraggable (final boolean draggable)
 Set whether this shape is draggable, i.e. More...
 
final boolean isDraggable ()
 Returns if this shape is draggable, a user interaction. More...
 
final Shape setResizable (final boolean resizable)
 Set whether this shape is resizable, i.e. More...
 
final boolean isResizable ()
 Returns if this shape is resizable, a user interaction. More...
 
final boolean isFixedARatioResize ()
 Returns if aspect-ratio shall be kept at resize, if isResizable(). More...
 
final Shape setFixedARatioResize (final boolean v)
 Sets whether aspect-ratio shall be kept at resize, if isResizable(). More...
 
final Shape setDragAndResizable (final boolean v)
 Set whether this shape is draggable and resizable. More...
 
final Shape addMouseListener (final MouseGestureListener l)
 
final Shape removeMouseListener (final MouseGestureListener l)
 
void receiveMouseEvents (final Shape source)
 Forward MouseGestureListener events to this Shape from source using a ForwardMouseListener. More...
 
final Shape addKeyListener (final KeyListener l)
 
final Shape removeKeyListener (final KeyListener l)
 
void receiveKeyEvents (final Shape source)
 Forward KeyListener events to this Shape from source using a ForwardKeyListener. More...
 
abstract boolean hasColorChannel ()
 Returns true if implementation uses an extra color channel or texture which will be modulated with the passed rgba color drawImpl0(GL2ES2, RegionRenderer, float[]). More...
 
int getShapeCount ()
 Returns number of Shapes, see getShapes(). More...
 
List< ShapegetShapes ()
 Returns added Shapes. More...
 
List< ShapegetRenderedShapes ()
 Returns added shapes which are rendered and sorted by z-axis in ascending order toward z-near. More...
 
void addShape (Shape s)
 Adds a Shape. More...
 
Shape removeShape (final Shape s)
 Removes given shape, w/o Shape#destroy(GL2ES2, RegionRenderer). More...
 
void removeShapes (Collection<? extends Shape > shapes)
 Removes all given shapes, w/o Shape#destroy(GL2ES2, RegionRenderer). More...
 
boolean removeShape (final GL2ES2 gl, final RegionRenderer renderer, final Shape s)
 Removes given shape with Shape#destroy(GL2ES2, RegionRenderer), if contained. More...
 
void addShapes (Collection<? extends Shape > shapes)
 
void removeShapes (final GL2ES2 gl, final RegionRenderer renderer, final Collection<? extends Shape > shapes)
 Removes all given shapes with Shape#destroy(GL2ES2, RegionRenderer). More...
 
void removeAllShapes (final GL2ES2 gl, final RegionRenderer renderer)
 Removes all contained shapes with Shape#destroy(GL2ES2, RegionRenderer). More...
 
boolean contains (Shape s)
 
Shape getShapeByIdx (final int id)
 
Shape getShapeByID (final int id)
 
Shape getShapeByName (final String name)
 
AABBox getBounds (final PMVMatrix4f pmv, Shape shape)
 Returns AABBox dimension of given Shape from this container's perspective, i.e. More...
 
void setPMvCullingEnabled (final boolean v)
 Enable or disable Project-Modelview (PMv) frustum culling per Shape for this container. More...
 
boolean isPMvCullingEnabled ()
 Return whether Project-Modelview (PMv) frustum culling is enabled for this container. More...
 
boolean isCullingEnabled ()
 Return whether Project-Modelview (PMv) frustum culling or Group's Modelview (Mv) frustum clipping is enabled for this container. More...
 
boolean isOutside (final PMVMatrix4f pmv, final Shape shape)
 Returns whether the given Shape is completely outside of this container. More...
 
boolean isOutside2 (final Matrix4f mvCont, final Shape shape, final PMVMatrix4f pmvShape)
 Returns whether the given Shape is completely outside of this container. More...
 

Static Public Attributes

static final float POS_EPS = FloatUtil.EPSILON * 5000
 Epsilon of position, 5000 x FloatUtil#EPSILON. More...
 
static final float ROT_EPS = FloatUtil.adegToRad(0.5f)
 Epsilon of rotation [radian], 0.5 degrees or 0.008726646 radians. More...
 
- Static Public Attributes inherited from com.jogamp.graph.ui.Shape
static Comparator< ShapeZAscendingComparator
 
static Comparator< ShapeZDescendingComparator
 

Additional Inherited Members

- Protected Member Functions inherited from com.jogamp.graph.ui.Group
void clearImpl0 (final GL2ES2 gl, final RegionRenderer renderer)
 Custom clear(GL2ES2, RegionRenderer) task, called 1st. More...
 
void destroyImpl0 (final GL2ES2 gl, final RegionRenderer renderer)
 Custom destroy(GL2ES2, RegionRenderer) task, called 1st. More...
 
void drawImpl0 (final GL2ES2 gl, final RegionRenderer renderer, final Vec4f rgba)
 Actual draw implementation, called by draw(GL2ES2, RegionRenderer). More...
 
final void drawToSelectImpl0 (final GL2ES2 gl, final RegionRenderer renderer)
 Actual draw implementation, called by drawToSelect(GL2ES2, RegionRenderer). More...
 
boolean isShapeDirty ()
 Returns the shape's dirty state, see markShapeDirty(). More...
 
void validateImpl (final GL2ES2 gl, final GLProfile glp)
 
- Protected Member Functions inherited from com.jogamp.graph.ui.Shape
 Shape ()
 Create a generic UI Shape. More...
 
void setParent (final Group c)
 
final void dispatchActivationEvent (final Shape s)
 Dispatch activation event event to this shape. More...
 
boolean isShapeDirty ()
 Returns the shape's dirty state, see markShapeDirty(). More...
 
final boolean isStateDirty ()
 Returns the rendering dirty state, see markStateDirty(). More...
 
final String getDirtyString ()
 
void toggleNotify (final boolean on)
 
final boolean setActive (final boolean v, final float zOffset)
 
abstract void validateImpl (final GL2ES2 gl, final GLProfile glp)
 
abstract void drawImpl0 (final GL2ES2 gl, final RegionRenderer renderer, final Vec4f rgba)
 Actual draw implementation, called by draw(GL2ES2, RegionRenderer). More...
 
abstract void drawToSelectImpl0 (final GL2ES2 gl, final RegionRenderer renderer)
 Actual draw implementation, called by drawToSelect(GL2ES2, RegionRenderer). More...
 
abstract void clearImpl0 (final GL2ES2 gl, final RegionRenderer renderer)
 Custom clear(GL2ES2, RegionRenderer) task, called 1st. More...
 
abstract void destroyImpl0 (final GL2ES2 gl, final RegionRenderer renderer)
 Custom destroy(GL2ES2, RegionRenderer) task, called 1st. More...
 
- Protected Attributes inherited from com.jogamp.graph.ui.Shape
final AABBox box = new AABBox()
 
final Vec4f rgbaColor = new Vec4f(0.60f, 0.60f, 0.60f, 1.0f)
 Default base-color w/o color channel, will be modulated w/ pressed- and toggle color. More...
 
final Vec4f pressedRGBAModulate = new Vec4f(0.70f, 0.70f, 0.70f, 0.8f)
 Default pressed color-factor (darker and slightly transparent), modulates base-color. More...
 
final Vec4f toggleOnRGBAModulate = new Vec4f(0.83f, 0.83f, 0.83f, 1.0f)
 Default toggle color-factor (darker), modulates base-color. More...
 
final Vec4f toggleOffRGBAModulate = new Vec4f(1.00f, 1.00f, 1.00f, 1.0f)
 Default toggle color-factor (original), modulates base-color. More...
 
final Vec4f activeRGBAModulate = new Vec4f(0.25f, 0.25f, 0.25f, 1.0f)
 Default active color-factor (dark), modulates base-color. More...
 
boolean activeRGBAModulateOn = false
 
- Static Protected Attributes inherited from com.jogamp.graph.ui.Shape
static final boolean DEBUG_DRAW = false
 

Detailed Description

Group of animated Shapes including other static Shapes, optionally utilizing a Group.Layout.

See also
Scene
Shape
Group.Layout

Definition at line 60 of file AnimGroup.java.

Constructor & Destructor Documentation

◆ AnimGroup()

com.jogamp.graph.ui.AnimGroup.AnimGroup ( final Layout  l)

Create a group of animated Shapes including other static Shapes w/ given Group.Layout.

Default is non-interactive, see setInteractive(boolean).

Parameters
loptional Layout, maybe null

Definition at line 232 of file AnimGroup.java.

Member Function Documentation

◆ addAnimSet()

Set com.jogamp.graph.ui.AnimGroup.addAnimSet ( final float  pixPerMM,
final GLProfile  glp,
final PMVMatrix4f  pmv,
final Recti  viewport,
final float  accel,
final float  velocity,
final float  ang_accel,
final float  ang_velo,
final LerpFunc  lerp,
final Shape  refShape 
)

Add a new Set with an empty ShapeData container.

The given PMVMatrix4f has to be setup properly for this object, i.e. its GLMatrixFunc#GL_PROJECTION and GLMatrixFunc#GL_MODELVIEW for the surrounding scene only, without a shape's applyMatToMv(PMVMatrix4f). See Scene.PMVMatrixSetup#set(PMVMatrix4f, Recti).

Parameters
pixPerMMmonitor pixel per millimeter for accurate animation
glpused GLProfile
pmvwell formed PMVMatrix4f, e.g. could have been setup via Scene.PMVMatrixSetup#set(PMVMatrix4f, Recti).
viewportthe int[4] viewport
acceltranslation acceleration in [m]/[s*s]
velocitytranslation velocity in [m]/[s]
ang_accelangular acceleration in [radians]/[s*s], usable for rotation etc
ang_veloangular velocity in [radians]/[s], usable for rotation etc
lerpLerpFunc function, see AnimGroup.TargetLerp
refShapereference Shape giving reference size, see refShape
opShapeData setup function for ShapeData#startPos and ShapeData#targetPos
Returns
a new Set instance

Definition at line 324 of file AnimGroup.java.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ addGlyphSet()

final Set com.jogamp.graph.ui.AnimGroup.addGlyphSet ( final float  pixPerMM,
final GLProfile  glp,
final PMVMatrix4f  pmv,
final Recti  viewport,
final int  renderModes,
final Font  font,
final char  refChar,
final CharSequence  text,
final float  fontScale,
final float  accel,
final float  velocity,
final float  ang_accel,
final float  ang_velo,
final LerpFunc  lerp,
final ShapeSetup  op 
)

Add a new Set with ShapeData for each GlyphShape, moving towards its target position using a generic displacement via ShapeSetup to determine each ShapeData's starting position.

The given PMVMatrix4f has to be setup properly for this object, i.e. its GLMatrixFunc#GL_PROJECTION and GLMatrixFunc#GL_MODELVIEW for the surrounding scene only, without a shape's applyMatToMv(PMVMatrix4f). See Scene.PMVMatrixSetup#set(PMVMatrix4f, Recti).

Parameters
pixPerMMmonitor pixel per millimeter for accurate animation
glpused GLProfile
pmvwell formed PMVMatrix4f, e.g. could have been setup via Scene.PMVMatrixSetup#set(PMVMatrix4f, Recti).
viewportthe int[4] viewport
renderModesused region render-modes
fontFont to be used for resulting GlyphShapes
refCharreference character to calculate the reference GlyphShape
textthe text for resulting GlyphShapes
fontScalefont scale factor for resulting GlyphShapes
acceltranslation acceleration in [m]/[s*s]
velocitytranslation velocity in [m]/[s]
ang_accelangular acceleration in [radians]/[s*s], usable for rotation etc
ang_veloangular velocity in [radians]/[s], usable for rotation etc
lerpLerpFunc function, see AnimGroup.TargetLerp
opShapeData setup function for ShapeData#startPos and ShapeData#targetPos
Returns
newly created and added Set

Definition at line 369 of file AnimGroup.java.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ addGlyphSetHorizScroll01()

final Set com.jogamp.graph.ui.AnimGroup.addGlyphSetHorizScroll01 ( final float  pixPerMM,
final GLProfile  glp,
final PMVMatrix4f  pmv,
final Recti  viewport,
final int  renderModes,
final Font  font,
final CharSequence  text,
final float  fontScale,
final Vec4f  fgCol,
final float  velocity,
final AABBox  animBox,
final float  y_offset 
)

Add a new Set with ShapeData for each GlyphShape, implementing
horizontal continuous scrolling while repeating the given text.

The given PMVMatrix4f has to be setup properly for this object, i.e. its GLMatrixFunc#GL_PROJECTION and GLMatrixFunc#GL_MODELVIEW for the surrounding scene only, without a shape's applyMatToMv(PMVMatrix4f). See Scene.PMVMatrixSetup#set(PMVMatrix4f, Recti).

Parameters
pixPerMMmonitor pixel per millimeter for accurate animation
glpused GLProfile
pmvwell formed PMVMatrix4f, e.g. could have been setup via Scene.PMVMatrixSetup#set(PMVMatrix4f, Recti).
viewportthe int[4] viewport
renderModesused region render-modes
fontFont to be used for resulting GlyphShapes
textthe text for resulting GlyphShapes
fontScalefont scale factor for resulting GlyphShapes
fgColforeground color for resulting GlyphShapes
velocitytranslation velocity in [m]/[s]
animBoxAABBox denoting the maximum extend of ShapeDatas start-position, also used for their x-offset
Returns
newly created and added Set

Definition at line 493 of file AnimGroup.java.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ addGlyphSetRandom01()

final Set com.jogamp.graph.ui.AnimGroup.addGlyphSetRandom01 ( final float  pixPerMM,
final GLProfile  glp,
final PMVMatrix4f  pmv,
final Recti  viewport,
final int  renderModes,
final Font  font,
final CharSequence  text,
final float  fontScale,
final Vec4f  fgCol,
final float  accel,
final float  velocity,
final float  ang_accel,
final float  ang_velo,
final AABBox  animBox,
final boolean  z_only,
final Random  random,
final LerpFunc  lerp 
)

Add a new Set with ShapeData for each GlyphShape, moving towards its target position using a fixed displacement function, defining each ShapeData's starting position.

The start-position is randomly chosen within given AABBox glyphBox.

The given PMVMatrix4f has to be setup properly for this object, i.e. its GLMatrixFunc#GL_PROJECTION and GLMatrixFunc#GL_MODELVIEW for the surrounding scene only, without a shape's applyMatToMv(PMVMatrix4f). See Scene.PMVMatrixSetup#set(PMVMatrix4f, Recti).

Parameters
pixPerMMmonitor pixel per millimeter for accurate animation
glpused GLProfile
pmvwell formed PMVMatrix4f, e.g. could have been setup via Scene.PMVMatrixSetup#set(PMVMatrix4f, Recti).
viewportthe int[4] viewport
renderModesused region render-modes
fontFont to be used for resulting GlyphShapes
textthe text for resulting GlyphShapes
fontScalefont scale factor for resulting GlyphShapes
fgColforeground color for resulting GlyphShapes
acceltranslation acceleration in [m]/[s*s]
velocitytranslation velocity in [m]/[s]
ang_accelangular acceleration in [radians]/[s*s], usable for rotation etc
ang_veloangular velocity in [radians]/[s], usable for rotation etc
animBoxAABBox denoting the maximum extend of ShapeDatas start-position, also used for their x-offset
z_onlyPass true for z-only distance
randomthe random float generator
lerpLerpFunc function, see AnimGroup.TargetLerp
Returns
newly created and added Set

Definition at line 450 of file AnimGroup.java.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ draw()

void com.jogamp.graph.ui.AnimGroup.draw ( final GL2ES2  gl,
final RegionRenderer  renderer 
)

Renders the shape.

applyMatToMv(PMVMatrix4f) is expected to be completed beforehand.

Parameters
glthe current GL object
rendererRegionRenderer which might be used for Graph Curve Rendering, also source of RegionRenderer#getMatrix() and RegionRenderer#getViewport().

Reimplemented from com.jogamp.graph.ui.Shape.

Definition at line 542 of file AnimGroup.java.

◆ getAnimSet()

Set com.jogamp.graph.ui.AnimGroup.getAnimSet ( final int  idx)

Return the Set at given index or null if n/a.

Definition at line 237 of file AnimGroup.java.

◆ getTickOnDraw()

final boolean com.jogamp.graph.ui.AnimGroup.getTickOnDraw ( )

Definition at line 515 of file AnimGroup.java.

◆ getTickPaused()

final boolean com.jogamp.graph.ui.AnimGroup.getTickPaused ( )

Definition at line 539 of file AnimGroup.java.

Here is the caller graph for this function:

◆ isAnimationActive()

final boolean com.jogamp.graph.ui.AnimGroup.isAnimationActive ( )

Definition at line 570 of file AnimGroup.java.

◆ removeAllAnimSets()

final void com.jogamp.graph.ui.AnimGroup.removeAllAnimSets ( final GL2ES2  gl,
final RegionRenderer  renderer 
)

Removes all Sets and destroys them, including all ShapeData and their Shapes.

Definition at line 245 of file AnimGroup.java.

◆ removeAnimSet()

final void com.jogamp.graph.ui.AnimGroup.removeAnimSet ( final GL2ES2  gl,
final RegionRenderer  renderer,
final Set  as 
)

Removes the given Set and destroys it, including its ShapeData and Shape.

Definition at line 253 of file AnimGroup.java.

◆ removeAnimSets()

final void com.jogamp.graph.ui.AnimGroup.removeAnimSets ( final GL2ES2  gl,
final RegionRenderer  renderer,
final List< Set asList 
)

Removes the given Sets and destroys them, including their ShapeData and Shape.

Definition at line 261 of file AnimGroup.java.

Here is the caller graph for this function:

◆ resetAnimation()

final void com.jogamp.graph.ui.AnimGroup.resetAnimation ( )

Definition at line 549 of file AnimGroup.java.

Here is the caller graph for this function:

◆ restartAnimation()

final void com.jogamp.graph.ui.AnimGroup.restartAnimation ( )

Definition at line 555 of file AnimGroup.java.

Here is the call graph for this function:

◆ setTickOnDraw()

final void com.jogamp.graph.ui.AnimGroup.setTickOnDraw ( final boolean  v)

Sets whether tick() shall be automatic issued on draw(GL2ES2, RegionRenderer), default is true.

Definition at line 514 of file AnimGroup.java.

◆ setTickPaused()

final void com.jogamp.graph.ui.AnimGroup.setTickPaused ( final boolean  v)

Sets whether tick() shall be paused, default is false.

Unpausing tick() will also forward animation start-time about paused duration, as well as set last-tick timestamp to now. This prevents animation artifacts and resumes where left off.

Definition at line 524 of file AnimGroup.java.

◆ stopAnimation()

void com.jogamp.graph.ui.AnimGroup.stopAnimation ( )

Definition at line 563 of file AnimGroup.java.

◆ tick()

final void com.jogamp.graph.ui.AnimGroup.tick ( )

Issues an animation tick, usually done at draw(GL2ES2, RegionRenderer).

See also
setTickOnDraw(boolean)
setTickPaused(boolean)

Definition at line 582 of file AnimGroup.java.

Member Data Documentation

◆ POS_EPS

final float com.jogamp.graph.ui.AnimGroup.POS_EPS = FloatUtil.EPSILON * 5000
static

Epsilon of position, 5000 x FloatUtil#EPSILON.

Definition at line 63 of file AnimGroup.java.

◆ ROT_EPS

final float com.jogamp.graph.ui.AnimGroup.ROT_EPS = FloatUtil.adegToRad(0.5f)
static

Epsilon of rotation [radian], 0.5 degrees or 0.008726646 radians.

Definition at line 65 of file AnimGroup.java.


The documentation for this class was generated from the following file: