evolution
Class WorldController

public class WorldController

implements Observer

A class of world controllers. This is a facade.

public WorldController(String configFile, int width, int height)
                  throws java.io.FileNotFoundException,
                         java.io.IOException

Create a new worldcontroller (and a new world). The world will be created in the pause mode, so one needs to call startGame() to start playing.

Parameters:

width - The width of the game board

height - The height of the game board

configFile - The main configuration file on which this world should be based. From this configuration file the path is stripped and used as the resource path to load other config files and images.

public void clearSelection()

Clear the selected humans.

public void continueGame()

Resume the game.

public void createHuman()

Toggle creating a human.

protected String getActionName()

Return the name of the currently selected action.

public InfoList getActionsInfo()

All available actions.

public InfoList getConstructionInfo()

Get an infolist with info about the selected construction.

protected String getConstructionName()

Return the currently selected construction name.

protected String getConstructionShape()

Return the selected construction shape.

public List getConstructionShapes(String constructionName)

The shapes the given construction can be build in. Returns a List of Strings according to the shape spec. e.g. {"1x1:1", "2x2:1101", "3x2:111111101"}

public InfoList getConstructionsInfo()

All available constructions.

public int getHeight()

Get the height of this world.

public InfoList getHumanInfo()

Get an infolist with info about the selected human.

protected HumanSelection getHumanSelection()

Return the human selection of this human.

public String getResourcePath()

The resource path.

public InfoList getResourcesInfo()

Get an infolist with all the world resources.

protected SquareOfLand getSelectedSquare()

Return the square of land that is currently selected.

public InfoList getSquareInfo()

Get an infolist with info about the selected square.

public int getWidth()

Get the width of this world.

protected World getWorld()

return the world (= singleton !) of this worldcontroller.

protected void initState()

Return to the initial state of this worldcontroller.

public boolean isActiveSelected(Human human)

Is the given human actively selected?

protected boolean isCreateHuman()

Return whether we are going to create a human with the next square selection

public boolean isRunning()

Is the game running?

public boolean isSelected(Human human)

Is the given human selected?

public void modifyVisionRange(int value)

Modify the visionrange of this worldcontroller.

public void pauseGame()

Pause the game.

public void refresh()

Let all the squares fire a changed event.

protected void resetActionName()

Set the selected action to the default action.

public void selectActionType(String actionName)

Select an action to be performed.

Throws:

NoHumanSelectionException - If there are no humans selected to perform the given action when a square would be selected.

public void selectConstructionShape(String shape)

Specify the shape the construction should have. e.g. "1x1:1", "2x2:1101", "3x2:111111101"

public void selectConstructionType(String constructionName)

Select a construction to be constructed.

Throws:

NoHumanSelectionException - If there are no humans selected to perform the action when a square would be selected.

public void selectSquareOfLand(int x, int y)
                         throws evolution.lands.IllegalPlacementException

Select a square of land.

If there is no human on the square
if we were to create a human
=> the human is created
elseif there are humans selected
=> one or more humans will be popped of the selection and
start performing the action.
else
=> the square is selected
else
if the human is selected
=> let it perform the selected action
else
=> the human is added to the selection and the square is selected

Precondition: the x, y must denote a valid square.

Throws:

IllegalPlacementException - The popped human can not stand on the given type of land. The human will stay were ever he was and stays selected.

protected void setActionName(String actionName)

Set the selected action to the given action.

protected void setConstructionName(String constructionName)

Set the selected construction name to the given construction name.

protected void setConstructionShape(String constructionShape)

Set the selected construction shape to the given construction shape.

protected void setCreateHuman(boolean b)

Set the boolean value that determines whether we are going to create a human with the next square selection

protected void setSelectedSquare(SquareOfLand square)

Set the selected square of land to the given square of land.

protected void startAction()
                     throws evolution.lands.IllegalPlacementException

Start the selected action.

public void startGame()

Start the game. Does nothing if the game is already started.

public void update(Event evt)

Called when an event happens this observer is interested in.

Association Links

to Class evolution.HumanSelection

The human selection.

to Class evolution.lands.SquareOfLand

The selected square of land.

to Class java.lang.String

The action name which was selected.

to Class java.lang.String

The construction name which was selected.

to Class java.lang.String

The construction shape which was selected.

to Class evolution.World

Just for easy referencing, but remember: world is a singleton.