cse1030.games.tetris

Class BlockGrid

java.lang.Object

cse1030.games.tetris.BlockGrid

public class BlockGrid
extends Object

A grid used to represent a Tetris block shape. The grid size is n-by-n where n >= 1. Each grid location is accessed using integer indices for the row and column (where the indices are zero based). The following image shows a 3-by- 3 grid with its indices:

Each grid location is either set (true) or clear ( false). Use the set method to set a grid position. Use the clear method to clear a grid position. The following image shows the S-block shape where the green grid positions are set and the white grid positions are clear.

Author:

CSE1030_F13_14

Constructor Summary

Constructors

Constructor and Description
BlockGrid(int n) Create a grid of size n-by-n.

Method Summary

Methods

Modifier and Type	Method and Description
void	clear(int row, int col) Clears a grid location.
void	clearAll() Clears all of the grid locations.
boolean	get(int row, int col) Gets the state of a grid location using zero-based row and column indices.
void	set(int row, int col) Sets a grid location.
int	size() Get the grid size.

Methods inherited from class java.lang.Object

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

Constructor Detail

BlockGrid

public BlockGrid(int n)

Create a grid of size n-by-n. All of the grid positions are set to false.

Throws:

IllegalArgumentException - if n < 1

Parameters:

n - the size of the grid

Method Detail

clearAll

public final void clearAll()

Clears all of the grid locations.

size

public int size()

Get the grid size.

Returns:

the grid size

get

public boolean get(int row,
          int col)

Gets the state of a grid location using zero-based row and column indices.

Throws:

IndexOutOfBoundsException - if row < 0, row >= size(), col < 0, or col >= size()

Parameters:

row - the row index of the desired grid location

col - the column index of the desired grid location

Returns:

true if the grid location is set, false otherwise

set

public void set(int row,
       int col)

Sets a grid location.

Throws:

IndexOutOfBoundsException - if row < 0, row >= size(), col < 0, or col >= size()

Parameters:

row - the row index of the desired grid location

col - the column index of the desired grid location

clear

public void clear(int row,
         int col)

Clears a grid location.

Throws:

IndexOutOfBoundsException - if row < 0, row >= size(), col < 0, or col >= size()

Parameters:

row - the row index of the desired grid location

col - the column index of the desired grid location