Java- Play Tetris

edu/vt/cs5044/tetris/Board.html

• Package
• Class
• Use
• Deprecated
• Index
• Help

• Prev Class
• Next Class

• Frames
• No Frames

• All Classes

• Summary: 
• Nested | 
• Field | 
• Constr | 
• Method

• Detail: 
• Field | 
• Constr | 
• Method

Class Board

• Object
• • Board

• public class Board
  extends Object

  Represents a tetris game board, including all fixed blocks. This class is effectively immutable, because there are no public mutators.

• • Field Summary

    Fields 

    Modifier and Type	Field and Description
    static int	HEIGHT Height of the game board, in blocks.
    static int	HEIGHT_LIMIT Height limit of the game board, in blocks.
    static int	WIDTH Width of the game board, in blocks.

  • Constructor Summary

    Constructors 

    Constructor and Description
    Board() Construct a new empty board.
    Board(String... initialBlocks) Construct a new board with the specified initial blocks.

  • Method Summary

    All Methods  Instance Methods  Concrete Methods 

    Modifier and Type	Method and Description
    boolean	equals(Object obj) Test for equivalence with another Board.
    boolean[][]	getFixedBlocks() Fetch a two-dimensional boolean array representing the fixed blocks of the board.
    Board	getResultBoard( Shape shape, Placement place) Generate a new board that is the result of placing a new shape in this board.
    int	hashCode() Hash code for this Board.
    String	toString() Generate a multi-line ASCII art visualization of this board.

    • Methods inherited from class Object

      clone, finalize, getClass, notify, notifyAll, wait, wait, wait

• • Field Detail

    • WIDTH

      public static final int WIDTH

      Width of the game board, in blocks.

      See Also:

      Constant Field Values

    • HEIGHT

      public static final int HEIGHT

      Height of the game board, in blocks.

      See Also:

      Constant Field Values

    • HEIGHT_LIMIT

      public static final int HEIGHT_LIMIT

      Height limit of the game board, in blocks. If any block becomes fixed at or above this row index during normal play, the game ends.

      See Also:

      Constant Field Values

  • Constructor Detail

    • Board

      public Board()

      Construct a new empty board. The constructed Board object will contain no fixed blocks.

    • Board

      public Board(String... initialBlocks)

      Construct a new board with the specified initial blocks. Specify a variable number of String values as arguments. Each String represents one row of the board.

      The last row specified is placed at the bottom (row index 0) of the board. No more than HEIGHT rows may be specified. If fewer rows are specified, the unspecified rows will be empty.

      Each row must have exactly WIDTH characters. The first character represents the left edge of the board. Each character must be either a space ' ' or a hash '#'. A hash means a single fixed block exists at that position. A space means no fixed block exists at that position.

      Parameters:

      initialBlocks - blocks to include in the board

  • Method Detail

    • getFixedBlocks

      public boolean[][] getFixedBlocks()

      Fetch a two-dimensional boolean array representing the fixed blocks of the board. The array is arranged such that the first index selects the column, and the second index selects the row. The left-most column is index 0, and the bottom-most row is index 0. The right-most column index is WIDTH - 1, and the top-most row index is HEIGHT - 1.

      A boolean value of true within the array indicates the presence of a fixed block at that location within the board; a false value within the array indicates there is no block present at that location

      As an example of using the returned value, array[3][1] will be true if there is a block present at the intersection of column index 3 (the fourth column, counting from the left) with row index 1 (the second row, counting from the bottom), or false if there is no block.

      NOTE: The returned array is mutable, but mutating it will not affect the Board object.

      Returns:

      a 2D boolean array representing the fixed columns of the board.

    • getResultBoard

      public 
                                              Board getResultBoard(
                                              Shape shape,
                                  
                                              Placement place)
                                          

      Generate a new board that is the result of placing a new shape in this board. First a copy of this board is created. The Shape is placed at the top of this copy, rotated according to the Placement rotation, then moved horizontally such that the left-most block is in the Placement column. The block is then dropped until it locks into place, then all completely full rows (if any) are cleared as in normal play. The copy, after this activity has been performed on it, is returned.

      Note: This method is NOT a mutator. It does not change the original Board object in any way.

      Parameters:

      shape - the Shape to place.

      place - a Placement containing the rotation and horizontal location for the shape.

      Returns:

      a new Board representing the result of the placement.

    • toString

      public String toString()

      Generate a multi-line ASCII art visualization of this board. The walls of the board are represented as '*' characters above the HEIGHT_LIMIT, and as '|' characters otherwise. The bottom of the board is represented by a row of '-' characters. Fixed blocks are represented by '#' characters; empty locations are represented by spaces. ACADEMIC NOTE: This is for troubleshooting purposes ONLY. This is NOT meant to be used for testing via JUnit, nor for the optional challenge.

      Overrides:

      toString in class Object

      Returns:

      a rudimentary ASCII art depiction of the board.

    • equals

      public boolean equals(Object obj)

      Test for equivalence with another Board. Two boards are equivalent if and only if they contain the same arrangement of fixed blocks. This method is consistent with the hashCode() implementation, and so is suitable for use within a HashSet or HashMap.

      Overrides:

      equals in class Object

      Parameters:

      obj - the other board object.

      Returns:

      true if the boards are equivalent; false otherwise.

    • hashCode

      public int hashCode()

      Hash code for this Board. The result is consistent with equals() and so Board objects are suitable for use within a HashSet or HashMap.

      Overrides:

      hashCode in class Object

      Returns:

      hash code for this Board object.

• Package
• Class
• Use
• Deprecated
• Index
• Help

• Prev Class
• Next Class

• Frames
• No Frames

• All Classes

• Summary: 
• Nested | 
• Field | 
• Constr | 
• Method

• Detail: 
• Field | 
• Constr | 
• Method