model

Class ClearCellGame

java.lang.Object

model.Game

model.ClearCellGame

public class ClearCellGame
extends Game

This class extends GameModel and implements the logic of the clear cell game. We define an empty cell as BoardCell.EMPTY. An empty row is defined as one where every cell corresponds to BoardCell.EMPTY.

Author:

Dept of Computer Science, UMCP

Constructor Summary

Constructors

Constructor and Description
ClearCellGame(int maxRows, int maxCols, java.util.Random random, int strategy) Defines a board with empty cells.

Method Summary

Methods

Modifier and Type	Method and Description
int	getScore()
boolean	isGameOver() The game is over when the last board row (row with index board.length -1) is different from empty row.
void	nextAnimationStep() This method will attempt to insert a row of random BoardCell objects if the last board row (row with index board.length -1) corresponds to the empty row; otherwise no operation will take place.
void	processCell(int rowIndex, int colIndex) This method will turn to BoardCell.EMPTY the cell selected and any adjacent surrounding cells in the vertical, horizontal, and diagonal directions that have the same color.

Methods inherited from class model.Game

getBoardCell, getMaxCols, getMaxRows, setBoardCell, setBoardWithColor, setColWithColor, setRowWithColor

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ClearCellGame

public ClearCellGame(int maxRows,
             int maxCols,
             java.util.Random random,
             int strategy)

Defines a board with empty cells. It relies on the super class constructor to define the board. The random parameter is used for the generation of random cells. The strategy parameter defines which clearing cell strategy to use (for this project it will be 1). For fun, you can add your own strategy by using a value different that one.

Parameters:

maxRows -

maxCols -

random -

strategy -

Method Detail

isGameOver

public boolean isGameOver()

The game is over when the last board row (row with index board.length -1) is different from empty row.

Specified by:

isGameOver in class Game

getScore

public int getScore()

Specified by:

getScore in class Game

nextAnimationStep

public void nextAnimationStep()

This method will attempt to insert a row of random BoardCell objects if the last board row (row with index board.length -1) corresponds to the empty row; otherwise no operation will take place.

Specified by:

nextAnimationStep in class Game

processCell

public void processCell(int rowIndex,
               int colIndex)

This method will turn to BoardCell.EMPTY the cell selected and any adjacent surrounding cells in the vertical, horizontal, and diagonal directions that have the same color. The clearing of adjacent cells will continue as long as cells have a color that corresponds to the selected cell. Notice that the clearing process does not clear every single cell that surrounds a cell selected (only those found in the vertical, horizontal or diagonal directions). IMPORTANT: Clearing a cell adds one point to the game's score.

If after processing cells, any rows in the board are empty,those rows will collapse, moving non-empty rows upward. For example, if we have the following board (an * represents an empty cell):

RRR
GGG
YYY
* * *

then processing each cell of the second row will generate the following board

RRR
YYY
* * *
* * *

IMPORTANT: If the game has ended no action will take place.

Specified by:

processCell in class Game