Package org.opentrafficsim.core.animation.gtu.colorer

Class SwitchableGTUColorer

java.lang.Object

org.opentrafficsim.core.animation.gtu.colorer.SwitchableGTUColorer

All Implemented Interfaces:

java.io.Serializable, Colorer<GTU>, GTUColorer

Direct Known Subclasses:

DefaultSwitchableGTUColorer, LmrsSwitchableColorer

public class SwitchableGTUColorer
extends java.lang.Object
implements GTUColorer, java.io.Serializable

GTU colorer that uses a coloring method that can be switched by the user of the program.

Copyright (c) 2013-2020 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

Version:

$Revision: 4742 $, $LastChangedDate: 2018-11-18 20:48:30 +0100 (Sun, 18 Nov 2018) $, by $Author: averbraeck $, initial version 28 mei 2015

Author:

Alexander Verbraeck, Peter Knoppers

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SwitchableGTUColorer.Builder	Builder for SwitchableGTUColorer.

Nested classes/interfaces inherited from interface org.opentrafficsim.core.animation.gtu.colorer.GTUColorer

GTUColorer.LegendEntry

Constructor Summary

Constructors

Constructor	Description
SwitchableGTUColorer(int activeIndex, GTUColorer... colorers)	Construct a new Switchable GTUColorer based on a list of colorers.

Method Summary

Modifier and Type	Method	Description
static SwitchableGTUColorer.Builder	builder()	Returns a builder for SwitchableGTUColorer.
java.awt.Color	getColor(GTU gtu)	Get the color, based on the Drawable object.
java.util.List<GTUColorer>	getColorers()
java.util.List<GTUColorer.LegendEntry>	getLegend()	Return a list of legend entries (useful to make a legend of the colors used to render the GTUs).
void	setGTUColorer(int activeIndex)	Replace the currently active GTUColorer.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SwitchableGTUColorer

public SwitchableGTUColorer(int activeIndex,
                            GTUColorer... colorers)
                     throws java.lang.IndexOutOfBoundsException

Construct a new Switchable GTUColorer based on a list of colorers.

Parameters:

activeIndex - int; the index of the initially active colorer in the list (0-based).

colorers - GTUColorer...; the list of GTUColorer. List cannot be empty.

Throws:

java.lang.IndexOutOfBoundsException - when activeIndex < 0 or larger than or equal to the number of colorers.

Method Detail

setGTUColorer

public final void setGTUColorer(int activeIndex)
                         throws java.lang.IndexOutOfBoundsException

Replace the currently active GTUColorer.

Parameters:

activeIndex - int; the index of the new active colorer in the list (0-based).

Throws:

java.lang.IndexOutOfBoundsException - when activeIndex < 0 or larger than or equal to the number of colorers.

getColor

public final java.awt.Color getColor(GTU gtu)

Get the color, based on the Drawable object.

Specified by:

getColor in interface Colorer<GTU>

Parameters:

gtu - D; the object to determine the color for

Returns:

the (fill, line) color of the drawable object

getLegend

public final java.util.List<GTUColorer.LegendEntry> getLegend()

Return a list of legend entries (useful to make a legend of the colors used to render the GTUs).

Specified by:

getLegend in interface GTUColorer

Returns:

List<LegendEntry>; the list of legend entries; the caller should not (try to) modify this List

toString

public final java.lang.String toString()

Overrides:

toString in class java.lang.Object

getColorers

public final java.util.List<GTUColorer> getColorers()

Returns:

the list of colorers.

builder

public static final SwitchableGTUColorer.Builder builder()

Returns a builder for SwitchableGTUColorer.

Returns:

Builder; builder for SwitchableGTUColorer