Package nl.tudelft.simulation.dsol.web.animation.D2

Class HTMLAnimationPanel

java.lang.Object
nl.tudelft.simulation.dsol.web.animation.D2.HTMLGridPanel
nl.tudelft.simulation.dsol.web.animation.D2.HTMLAnimationPanel
All Implemented Interfaces:
java.awt.image.ImageObserver, java.util.EventListener, javax.naming.event.NamespaceChangeListener, javax.naming.event.NamingListener, EventListenerInterface
public class HTMLAnimationPanel
extends HTMLGridPanel
implements EventListenerInterface, javax.naming.event.NamespaceChangeListener
The AnimationPanel to display animated (Locatable) objects. Added the possibility to witch layers on and off. By default all layers will be drawn, so no changes to existing software need to be made.
copyright (c) 2002-2018 Delft University of Technology , the Netherlands.
See for project information www.simulation.tudelft.nl .

Copyright (c) 2002-2019 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See for project information https://simulation.tudelft.nl. The DSOL project is distributed under a three-clause BSD-style license, which can be found at https://simulation.tudelft.nl/dsol/3.0/license.html.

Author:
Peter Jacobs

  • Constructor Details

    • HTMLAnimationPanel

      public HTMLAnimationPanel​(java.awt.geom.Rectangle2D extent, java.awt.Dimension size, SimulatorInterface<?,​?,​?> simulator) throws java.rmi.RemoteException
      constructs a new AnimationPanel.
      Parameters:
      extent - Rectangle2D; the extent of the panel
      size - Dimension; the size of the panel.
      simulator - SimulatorInterface<?,?,?>; the simulator of which we want to know the events for animation
      Throws:
      java.rmi.RemoteException - on network error for one of the listeners

  • Method Details

    • paintComponent

      public void paintComponent​(HTMLGraphics2D g2)
      Draw the grid.
      Overrides:
      paintComponent in class HTMLGridPanel
      Parameters:
      g2 - HTMLGraphics2D; the virtual Graphics2D canvas to enable writing to the browser

    • isShowElement

      public boolean isShowElement​(Renderable2DInterface<? extends Locatable> element)
      Test whether the element needs to be shown on the screen or not.
      Parameters:
      element - Renderable2DInterface<? extends Locatable>; the renderable element to test
      Returns:
      whether the element needs to be shown or not

    • isShowClass

      public boolean isShowClass​(java.lang.Class<? extends Locatable> locatableClass)
      Test whether a certain class needs to be shown on the screen or not. The class needs to implement Locatable, otherwise it cannot be shown at all.
      Parameters:
      locatableClass - Class<? extends Locatable>; the class to test
      Returns:
      whether the class needs to be shown or not

    • notify

      public void notify​(EventInterface event) throws java.rmi.RemoteException
      Specified by:
      notify in interface EventListenerInterface
      Throws:
      java.rmi.RemoteException

    • objectAdded

      public void objectAdded​(javax.naming.event.NamingEvent namingEvent)
      Specified by:
      objectAdded in interface javax.naming.event.NamespaceChangeListener

    • objectRemoved

      public void objectRemoved​(javax.naming.event.NamingEvent namingEvent)
      Specified by:
      objectRemoved in interface javax.naming.event.NamespaceChangeListener

    • objectRenamed

      public void objectRenamed​(javax.naming.event.NamingEvent namingEvent)
      Specified by:
      objectRenamed in interface javax.naming.event.NamespaceChangeListener

    • namingExceptionThrown

      public void namingExceptionThrown​(javax.naming.event.NamingExceptionEvent namingEvent)
      Specified by:
      namingExceptionThrown in interface javax.naming.event.NamingListener

    • fullExtent

      public java.awt.geom.Rectangle2D fullExtent()
      Calculate the full extent based on the current positions of the objects.
      Returns:
      the full extent of the animation.

    • zoomAll

      public void zoomAll()
      resets the panel to its an extent that covers all displayed objects.

    • showClass

      public void showClass​(java.lang.Class<? extends Locatable> locatableClass)
      Set a class to be shown in the animation to true.
      Parameters:
      locatableClass - Class<? extends Locatable>; the class for which the animation has to be shown.

    • hideClass

      public void hideClass​(java.lang.Class<? extends Locatable> locatableClass)
      Set a class to be hidden in the animation to true.
      Parameters:
      locatableClass - Class<? extends Locatable>; the class for which the animation has to be hidden.

    • toggleClass

      public void toggleClass​(java.lang.Class<? extends Locatable> locatableClass)
      Toggle a class to be displayed in the animation to its reverse value.
      Parameters:
      locatableClass - Class<? extends Locatable>; the class for which a visible animation has to be turned off or vice versa.

    • getElements

      public final java.util.SortedSet<Renderable2DInterface<? extends Locatable>> getElements()
      Returns:
      the set of animation elements.

    • getDragLine

      public final javax.vecmath.Point4i getDragLine()
      Returns:
      returns the dragLine.

    • isDragLineEnabled

      public final boolean isDragLineEnabled()
      Returns:
      returns the dragLineEnabled.

    • setDragLineEnabled

      public final void setDragLineEnabled​(boolean dragLineEnabled)
      Parameters:
      dragLineEnabled - boolean; the dragLineEnabled to set.

    • addToggleAnimationButtonText

      public final void addToggleAnimationButtonText​(java.lang.String name, java.lang.Class<? extends Locatable> locatableClass, java.lang.String toolTipText, boolean initiallyVisible)
      Add a button for toggling an animatable class on or off.
      Parameters:
      name - String; the name of the button
      locatableClass - Class<? extends Locatable>; the class for which the button holds (e.g., GTU.class)
      toolTipText - String; the tool tip text to show when hovering over the button
      initiallyVisible - boolean; whether the class is initially shown or not

    • showClass

      public final void showClass​(java.lang.String name)
      Show a Locatable class based on the name.
      Parameters:
      name - the name of the class to show

    • hideClass

      public final void hideClass​(java.lang.String name)
      Hide a Locatable class based on the name.
      Parameters:
      name - the name of the class to hide

    • addToggleText

      public final void addToggleText​(java.lang.String text)
      Add a text to explain animatable classes.
      Parameters:
      text - String; the text to show

    • addAllToggleGISButtonText

      public final void addAllToggleGISButtonText​(java.lang.String header, GisRenderable2D gisMap, java.lang.String toolTipText)
      Add buttons for toggling all GIS layers on or off.
      Parameters:
      header - String; the name of the group of layers
      gisMap - GisRenderable2D; the GIS map for which the toggles have to be added
      toolTipText - String; the tool tip text to show when hovering over the button

    • addToggleGISButtonText

      public final void addToggleGISButtonText​(java.lang.String layerName, java.lang.String displayName, GisRenderable2D gisMap, java.lang.String toolTipText)
      Add a button to toggle a GIS Layer on or off.
      Parameters:
      layerName - String; the name of the layer
      displayName - String; the name to display next to the tick box
      gisMap - GisRenderable2D; the map
      toolTipText - String; the tool tip text

    • showGISLayer

      public final void showGISLayer​(java.lang.String layerName)
      Set a GIS layer to be shown in the animation to true.
      Parameters:
      layerName - String; the name of the GIS-layer that has to be shown.

    • hideGISLayer

      public final void hideGISLayer​(java.lang.String layerName)
      Set a GIS layer to be hidden in the animation to true.
      Parameters:
      layerName - String; the name of the GIS-layer that has to be hidden.

    • toggleGISLayer

      public final void toggleGISLayer​(java.lang.String layerName)
      Toggle a GIS layer to be displayed in the animation to its reverse value.
      Parameters:
      layerName - String; the name of the GIS-layer that has to be turned off or vice versa.

    • getToggleButtons

      public final java.util.List<ToggleButtonInfo> getToggleButtons()
      Returns:
      toggleButtons