Brain.java

/**
 * The interface for Tetris brains.
 * See Tetris-Architecture.html for an overview.
 * 
 * @author Nick Parlante
 * @version 1.0, Mar 1, 2001
 */

public interface Brain
{
 /**
 * Given a piece and a board, returns a move object that represents the best
 * play for that piece, or returns null if no play is possible.
 * The board should be in the committed state when this is called.
 * "limitHeight" is the bottom section of the board that where pieces must
 * come to rest -- typically 20.
 * If the passed in move is non-null, it is used to hold the result
 * (just to save the memory allocation).
 * 
 * @param board the board in which to calculate the best move
 * @param piece the piece to place in the optimal location on the board
 * @param limitHeight the piece must be placed below this height
 * @return the best move for the specified piece
 */
 public Move bestMove(Board board, Piece piece, int limitHeight);
}