All Packages Class Hierarchy This Package Previous Next Index
java.lang.Object | +----gerken.vehicles.VehicleScenario
The VehicleScenario class implements the behavior that manages a vehicle simulation. It contains all simulation participants and maintains the general simulation parameters.
This software is provided on an as-is basis and is copyright Chris Gerken. The only rights granted to you are to enjoy and learn from this software.
VehicleScenario(int, int, boolean)
Return a vehicle scenario that covers an area w pixels wide and h pixels high.
addParticipant(SimulationParticipant)
Register a participant in the scenario.
getBackground()
Return the Color used to paint the SimulationWindow's background.
getCenterX()
Return the x coordinate of the center of the scenario's simulation area
getCenterY()
Return the y coordinate of the center of the scenario's simulation area
getClosestTo(Location)
Return the participant closest to the given Location.
getDisplayCoordinates(DisplayCoordinates)
Perform transformations on a DisplayCoordinates to get the corresponding Location.
getDisplayCoordinates(Location)
Perform transformations on a Location to get the DisplayCoordinates that correctly represent that point in a SimulatorWindow.
getHeight()
Return the height in pixels of the simulation area
getMargin()
Return the width in pixels of the space between the simulaiton border and the edge of the screen.
getParticipants()
Return a vector containing all of the registered participants for the scenario.
getRandomDirection()
Return a random direction
getRandomX()
Return a random x coordinate between 0.0 and the scenario's width inclusive
getRandomY()
Return a random y coordinate between 0.0 and the scenario's height inclusive
getSimulationParticipantsColored(Color)
Return a Vector containing all of the registered simulation participants with color c.
getWidth()
Return the width of the scenario simulation area.
getWrapsAround()
Return whether or not vehicles can "see" and "travel" over borders to the other side of the scenario simulation area.
go()
Begin continuous simulation.
halt()
Stop continuous simulation.
removeParticipant(SimulationParticipant)
Remove (unregister) a participant from the simulation.
run()
Begin simulation of this scenario on a new thread.
setColor(Color)
Set the current foreground color on the SimulationWIndows's Canvas.
setColorToBackground()
Convenience method to set the current forground color for the SimulationWindow's Canvas to that Canvas' background color.
start()
Put up a SimulationWindow for the scenario and display the initial positions of the scenario's registered participants.
step()
Perform a single step in the scenario's simulation.
verifyLocation(SimulationParticipant)
Check to see if the participant sits outside of the ScenarioBoundary.
VehicleScenario
public VehicleScenario(int w,
int h,
boolean a)
Return a vehicle scenario that covers an area w pixels wide and h pixels high. Boolean value a indicates whether participants can see and move across borders (by wraping around to the opposite border).
addParticipant
public void addParticipant(SimulationParticipant participant)
Register a participant in the scenario.
getBackground
public Color getBackground()
Return the Color used to paint the SimulationWindow's background. This is useful for "erasing" a vehicle at its old positin before it is drawn in its new position.
getCenterX
public double getCenterX()
Return the x coordinate of the center of the scenario's simulation area
getCenterY
public double getCenterY()
Return the y coordinate of the center of the scenario's simulation area
getClosestTo
public SimulationParticipant getClosestTo(Location l)
Return the participant closest to the given Location.
getDisplayCoordinates
public Location getDisplayCoordinates(DisplayCoordinates dc)
Perform transformations on a DisplayCoordinates to get the corresponding Location.
getDisplayCoordinates
public DisplayCoordinates getDisplayCoordinates(Location l)
Perform transformations on a Location to get the DisplayCoordinates that correctly represent that point in a SimulatorWindow.
getHeight
public double getHeight()
Return the height in pixels of the simulation area
getMargin
public int getMargin()
Return the width in pixels of the space between the simulaiton border and the edge of the screen.
getParticipants
public Vector getParticipants()
Return a vector containing all of the registered participants for the scenario.
getRandomDirection
public double getRandomDirection()
Return a random direction
getRandomX
public double getRandomX()
Return a random x coordinate between 0.0 and the scenario's width inclusive
getRandomY
public double getRandomY()
Return a random y coordinate between 0.0 and the scenario's height inclusive
getSimulationParticipantsColored
public Vector getSimulationParticipantsColored(Color c)
Return a Vector containing all of the registered simulation participants with color c.
getWidth
public double getWidth()
Return the width of the scenario simulation area.
getWrapsAround
public boolean getWrapsAround()
Return whether or not vehicles can "see" and "travel" over borders to the other side of the scenario simulation area.
go
public void go()
Begin continuous simulation.
halt
public void halt()
Stop continuous simulation.
removeParticipant
public void removeParticipant(SimulationParticipant participant)
Remove (unregister) a participant from the simulation. This is usually done when a participant has been rendered inactive.
run
public void run()
Begin simulation of this scenario on a new thread.
setColor
public void setColor(Color value)
Set the current foreground color on the SimulationWIndows's Canvas.
setColorToBackground
public void setColorToBackground()
Convenience method to set the current forground color for the SimulationWindow's Canvas to that Canvas' background color. This is usually used to "erase" a vehicle before drawing it in its new position.
start
public void start()
Put up a SimulationWindow for the scenario and display the initial positions of the scenario's registered participants. It is expected that the scenario is ready to begin imulation when this method is called.
step
public void step()
Perform a single step in the scenario's simulation.
verifyLocation
public void verifyLocation(SimulationParticipant participant)
Check to see if the participant sits outside of the ScenarioBoundary. If so, take appropriate action for the setting of the wrapsAround property.
All Packages Class Hierarchy This Package Previous Next Index