DefaultAnimationFactory.java
package org.opentrafficsim.draw.factory;
import java.awt.Color;
import java.rmi.RemoteException;
import java.util.Collections;
import java.util.LinkedHashMap;
import java.util.Map;
import javax.naming.NamingException;
import org.djutils.event.Event;
import org.djutils.event.EventListener;
import org.djutils.logger.CategoryLogger;
import org.opentrafficsim.core.animation.gtu.colorer.GtuColorer;
import org.opentrafficsim.core.dsol.OtsSimulatorInterface;
import org.opentrafficsim.core.geometry.OtsGeometryException;
import org.opentrafficsim.core.gtu.Gtu;
import org.opentrafficsim.core.gtu.GtuGenerator.GtuGeneratorPosition;
import org.opentrafficsim.core.network.Link;
import org.opentrafficsim.core.network.Node;
import org.opentrafficsim.core.network.Network;
import org.opentrafficsim.core.object.LocatedObject;
import org.opentrafficsim.core.object.NonLocatedObject;
import org.opentrafficsim.draw.core.OtsDrawingException;
import org.opentrafficsim.draw.gtu.DefaultCarAnimation;
import org.opentrafficsim.draw.network.LinkAnimation;
import org.opentrafficsim.draw.network.NodeAnimation;
import org.opentrafficsim.draw.road.BusStopAnimation;
import org.opentrafficsim.draw.road.ConflictAnimation;
import org.opentrafficsim.draw.road.CrossSectionElementAnimation;
import org.opentrafficsim.draw.road.DetectorAnimation;
import org.opentrafficsim.draw.road.GtuGeneratorPositionAnimation;
import org.opentrafficsim.draw.road.LaneAnimation;
import org.opentrafficsim.draw.road.SpeedSignAnimation;
import org.opentrafficsim.draw.road.StripeAnimation;
import org.opentrafficsim.draw.road.TrafficLightAnimation;
import org.opentrafficsim.draw.road.TrafficLightDetectorAnimation;
import org.opentrafficsim.road.gtu.generator.LaneBasedGtuGenerator;
import org.opentrafficsim.road.gtu.lane.LaneBasedGtu;
import org.opentrafficsim.road.network.lane.CrossSectionElement;
import org.opentrafficsim.road.network.lane.CrossSectionLink;
import org.opentrafficsim.road.network.lane.Lane;
import org.opentrafficsim.road.network.lane.Stripe;
import org.opentrafficsim.road.network.lane.conflict.Conflict;
import org.opentrafficsim.road.network.lane.object.BusStop;
import org.opentrafficsim.road.network.lane.object.SpeedSign;
import org.opentrafficsim.road.network.lane.object.detector.DestinationDetector;
import org.opentrafficsim.road.network.lane.object.detector.LaneDetector;
import org.opentrafficsim.road.network.lane.object.detector.SinkDetector;
import org.opentrafficsim.road.network.lane.object.detector.TrafficLightDetector;
import org.opentrafficsim.road.network.lane.object.trafficlight.TrafficLight;
import nl.tudelft.simulation.dsol.SimRuntimeException;
import nl.tudelft.simulation.dsol.animation.Locatable;
import nl.tudelft.simulation.dsol.animation.D2.Renderable2D;
/**
* DefaultAnimationFactory.java.
* <p>
* Copyright (c) 2013-2023 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br>
* BSD-style license. See <a href="https://opentrafficsim.org/docs/license.html">OpenTrafficSim License</a>.
* </p>
* @author <a href="https://github.com/averbraeck" target="_blank">Alexander Verbraeck</a>
*/
public class DefaultAnimationFactory implements EventListener
{
/** */
private static final long serialVersionUID = 20230129L;
/** The network. */
private final Network network;
/** The simulator. */
private final OtsSimulatorInterface simulator;
/** GTU colorer. */
private final GtuColorer gtuColorer;
/** Rendered gtus. */
private Map<LaneBasedGtu, Renderable2D<LaneBasedGtu>> animatedGTUs = Collections.synchronizedMap(new LinkedHashMap<>());
/** Rendered located objects. */
private Map<Locatable, Renderable2D<?>> animatedLocatedObjects = Collections.synchronizedMap(new LinkedHashMap<>());
/** Rendered non-located objects. */
private Map<NonLocatedObject, Renderable2D<?>> animatedNonLocatedObjects =
Collections.synchronizedMap(new LinkedHashMap<>());
/**
* Creates animations for nodes, links and lanes. The class will subscribe to the network and listen to changes, so the
* adding and removing of GTUs and Objects is animated correctly.
* @param network Network; the network
* @param gtuColorer GtuColorer; GTU colorer
* @param animateNetwork boolean; whether to animate the current network objects
* @throws OtsDrawingException on drawing error
*/
protected DefaultAnimationFactory(final Network network, final GtuColorer gtuColorer, final boolean animateNetwork)
throws OtsDrawingException
{
this.network = network;
this.simulator = network.getSimulator();
this.gtuColorer = gtuColorer;
// subscribe to adding and removing events
network.addListener(this, Network.GTU_ADD_EVENT);
network.addListener(this, Network.GTU_REMOVE_EVENT);
network.addListener(this, Network.OBJECT_ADD_EVENT);
network.addListener(this, Network.OBJECT_REMOVE_EVENT);
network.addListener(this, Network.NONLOCATED_OBJECT_ADD_EVENT);
network.addListener(this, Network.NONLOCATED_OBJECT_REMOVE_EVENT);
// model the current infrastructure
try
{
if (animateNetwork)
{
for (Node node : network.getNodeMap().values())
{
new NodeAnimation(node, this.simulator);
}
for (Link link : network.getLinkMap().values())
{
new LinkAnimation(link, this.simulator, 0.5f);
if (link instanceof CrossSectionLink)
{
for (CrossSectionElement element : ((CrossSectionLink) link).getCrossSectionElementList())
{
if (element instanceof Lane)
{
new LaneAnimation((Lane) element, this.simulator, Color.GRAY.brighter());
}
else if (element instanceof Stripe)
{
new StripeAnimation((Stripe) element, this.simulator);
}
else
{
// formerly the shoulder animation
new CrossSectionElementAnimation(element, this.simulator, Color.DARK_GRAY);
}
}
}
}
}
for (Gtu gtu : network.getGTUs())
{
Renderable2D<LaneBasedGtu> gtuAnimation =
new DefaultCarAnimation((LaneBasedGtu) gtu, this.simulator, this.gtuColorer);
this.animatedGTUs.put((LaneBasedGtu) gtu, gtuAnimation);
}
for (LocatedObject object : network.getObjectMap().values())
{
animateLocatedObject(object);
}
for (NonLocatedObject object : network.getNonLocatedObjectMap().values())
{
animateNonLocatedObject(object);
}
}
catch (RemoteException | NamingException | OtsGeometryException exception)
{
throw new OtsDrawingException("Exception while creating network animation.", exception);
}
}
/**
* Creates animations for nodes, links, lanes and GTUs. This can be used if the network is not read from XML. The class will
* subscribe to the network and listen to changes, so the adding and removing of GTUs and Objects is animated correctly.
* @param network Network; the network
* @param simulator OtsSimulatorInterface; the simulator
* @param gtuColorer GtuColorer; GTU colorer
* @return the DefaultAnimationFactory
* @throws OtsDrawingException on drawing error
*/
public static DefaultAnimationFactory animateNetwork(final Network network, final OtsSimulatorInterface simulator,
final GtuColorer gtuColorer) throws OtsDrawingException
{
return new DefaultAnimationFactory(network, gtuColorer, true);
}
/**
* Creates animations for nodes, links, lanes and GTUs. This can be used if the network is read from XML. The class will
* subscribe to the network and listen to changes, so the adding and removing of GTUs and Objects is animated correctly.
* @param network Network; the network
* @param gtuColorer GtuColorer; GTU colorer
* @return the DefaultAnimationFactory
* @throws OtsDrawingException on drawing error
*/
public static DefaultAnimationFactory animateXmlNetwork(final Network network, final GtuColorer gtuColorer)
throws OtsDrawingException
{
return new DefaultAnimationFactory(network, gtuColorer, false);
}
/** {@inheritDoc} */
@Override
public void notify(final Event event) throws RemoteException
{
try
{
if (event.getType().equals(Network.GTU_ADD_EVENT))
{
// schedule the addition of the GTU to prevent it from not having an operational plan
LaneBasedGtu gtu = (LaneBasedGtu) this.network.getGTU((String) event.getContent());
this.simulator.scheduleEventNow(this, "animateGTU", new Object[] {gtu});
}
else if (event.getType().equals(Network.GTU_REMOVE_EVENT))
{
LaneBasedGtu gtu = (LaneBasedGtu) this.network.getGTU((String) event.getContent());
if (this.animatedGTUs.containsKey(gtu))
{
this.animatedGTUs.get(gtu).destroy(gtu.getSimulator());
this.animatedGTUs.remove(gtu);
}
}
else if (event.getType().equals(Network.OBJECT_ADD_EVENT))
{
LocatedObject object = this.network.getObjectMap().get((String) event.getContent());
animateLocatedObject(object);
}
else if (event.getType().equals(Network.OBJECT_REMOVE_EVENT))
{
LocatedObject object = this.network.getObjectMap().get((String) event.getContent());
// TODO: this.animatedObjects.get(object).destroy(object.getSimulator());
// XXX: this is now a memory leak; we don't expect static animation objects to be removed during the run
this.animatedLocatedObjects.remove(object);
}
else if (event.getType().equals(Network.NONLOCATED_OBJECT_ADD_EVENT))
{
NonLocatedObject object = this.network.getNonLocatedObjectMap().get((String) event.getContent());
animateNonLocatedObject(object);
}
else if (event.getType().equals(Network.NONLOCATED_OBJECT_REMOVE_EVENT))
{
NonLocatedObject object = this.network.getNonLocatedObjectMap().get((String) event.getContent());
// TODO: this.animatedObjects.get(object).destroy(object.getSimulator());
// XXX: this is now a memory leak; we don't expect static animation objects to be removed during the run
this.animatedNonLocatedObjects.remove(object);
}
}
catch (SimRuntimeException exception)
{
CategoryLogger.always().error(exception, "Exception while updating network animation.");
}
}
/**
* Draw the GTU (scheduled method).
* @param gtu LaneBasedGtu; the GTU to draw
*/
protected void animateGTU(final LaneBasedGtu gtu)
{
try
{
Renderable2D<LaneBasedGtu> gtuAnimation = new DefaultCarAnimation(gtu, this.simulator, this.gtuColorer);
this.animatedGTUs.put(gtu, gtuAnimation);
}
catch (RemoteException | NamingException exception)
{
gtu.getSimulator().getLogger().always().error(exception, "Exception while drawing GTU.");
}
}
/**
* Draw the static object.
* @param object ObjectInterface; the object to draw
*/
protected void animateLocatedObject(final LocatedObject object)
{
try
{
if (object instanceof SinkDetector)
{
SinkDetector detector = (SinkDetector) object;
// Renderable2D<SinkSensor> objectAnimation = new SinkAnimation(detector, this.simulator);
Renderable2D<LaneDetector> objectAnimation = new DetectorAnimation(detector, this.simulator, Color.ORANGE);
this.animatedLocatedObjects.put(object, objectAnimation);
}
else if (object instanceof DestinationDetector)
{
DestinationDetector detector = (DestinationDetector) object;
// Renderable2D<DestinationSensor> objectAnimation = new DestinationAnimation(detector, this.simulator);
Renderable2D<LaneDetector> objectAnimation = new DetectorAnimation(detector, this.simulator, Color.ORANGE);
this.animatedLocatedObjects.put(object, objectAnimation);
}
else if (object instanceof TrafficLightDetector)
{
TrafficLightDetector trafficLigthDetector = (TrafficLightDetector) object;
Renderable2D<TrafficLightDetector> objectAnimation =
new TrafficLightDetectorAnimation(trafficLigthDetector, this.simulator);
this.animatedLocatedObjects.put(object, objectAnimation);
}
else if (object instanceof TrafficLightDetector.StartEndDetector)
{
// we do not draw these, as we draw the TrafficLightDetector
return;
}
else if (object instanceof LaneDetector)
{
LaneDetector detector = (LaneDetector) object;
Renderable2D<LaneDetector> objectAnimation = new DetectorAnimation(detector, this.simulator, Color.BLACK);
this.animatedLocatedObjects.put(object, objectAnimation);
}
else if (object instanceof Conflict)
{
Conflict conflict = (Conflict) object;
Renderable2D<Conflict> objectAnimation = new ConflictAnimation(conflict, this.simulator);
this.animatedLocatedObjects.put(object, objectAnimation);
}
else if (object instanceof TrafficLight)
{
TrafficLight trafficLight = (TrafficLight) object;
Renderable2D<TrafficLight> objectAnimation = new TrafficLightAnimation(trafficLight, this.simulator);
this.animatedLocatedObjects.put(object, objectAnimation);
}
else if (object instanceof SpeedSign)
{
SpeedSign speedSign = (SpeedSign) object;
Renderable2D<SpeedSign> objectAnimation = new SpeedSignAnimation(speedSign, this.simulator);
this.animatedLocatedObjects.put(object, objectAnimation);
}
else if (object instanceof BusStop)
{
BusStop busStop = (BusStop) object;
Renderable2D<BusStop> objectAnimation = new BusStopAnimation(busStop, this.simulator);
this.animatedLocatedObjects.put(object, objectAnimation);
}
}
catch (RemoteException | NamingException | OtsGeometryException exception)
{
CategoryLogger.always().error(exception, "Exception while drawing Object of class LocatedObject.");
}
}
/**
* Draw non-located objects.
* @param object NonLocatedObject; the object to draw.
*/
protected void animateNonLocatedObject(final NonLocatedObject object)
{
try
{
if (object instanceof LaneBasedGtuGenerator)
{
LaneBasedGtuGenerator generator = (LaneBasedGtuGenerator) object;
for (GtuGeneratorPosition position : generator.getPositions())
{
Renderable2D<GtuGeneratorPosition> objectAnimation =
new GtuGeneratorPositionAnimation(position, this.simulator);
this.animatedLocatedObjects.put(position, objectAnimation);
}
}
}
catch (RemoteException | NamingException exception)
{
CategoryLogger.always().error(exception, "Exception while drawing Object of class NonLocatedObject.");
}
}
}