CMSC132 Summer 2018

Project: Teris Game

Overview

For this project you will implement code for a game named Teris game. Tetris is a tile-matching puzzle game. There are seven tetrominos as shown in the table

Tetromino/ Piece	Shape	Color
I		Cyan
J		Blue
L		Orange
O		Yellow
S		Green
T		Purple
Z		Red

A random sequence of Tetrominos fall down the playing field (a rectangular vertical shaft, called the "well" or "matrix"). The goal of the game is to manipulate these Tetrominos, by moving each one sideways by pressing the left/right arrow keys and rotating it to left by 90 degree units by pressing the z key, with the aim of filling the gaps horizontally. When a tetromino is moved, the destination cells must be all clear. When a line is filled, it gets destroyed, and any block above the deleted line will fall. The game ends when the stack of Tetrominos reaches the top of the playing field and no new Tetrominos are able to enter. Read Tetris Game for more details.

Size of the well: 22 rows and 10 columns. Your program should work with different wells size.

Rotation Rules:

Tetromino will rotate 90 degree to left when you press the letter z on your keyboard. Here is the rotation diagram.

Name	Initial (Up)	Rotate Left (Left)	Rotate Left (Down)	Rotate Left (Right)	Rotate Left (Up Again)
I
T
O
L
J
S
Z

We will provide the graphical user interface (GUI) and you need to develop the code that implements the rules of the game. A video illustrating the game can be found at Game Video. Keep in mind that you should not debug your code using the GUI (student tests are preferable).

Objectives

This project will allow you practice two-dimensional arrays, abstract classes, inheritance, and test development.

Grading

• (50%) Public Tests
• (40%) Release Tests
• (10%) Style

Code Distribution

The project's code distribution is available by checking out the project named TetrisGame. The code distribution provides you with the following:

• gui package → Represents the graphical user interface for the game. Executing the main method of this class will allow you to play the game.
• model package → Includes the classes you need to implement.
• tests package → Includes the public test model.

Specifications

You are expected to implement methods for the Tetromino and I, J, L, O, S, Z, T classes. The other classes have been provided and you should not modify them. You should familiarize yourself with the Tetris class.

Notice you are not required to write student tests for credit, however, if you need assistance during office hours you need to bring student tests that illustrates the problem you are experiencing. Also, keep in mind the percentage associated with release tests is high, so you need to test your project thoroughly.

Requirements

• While moving a tetromino, you should verify whether all destination cells are legal and clear.
• You may not add any classes, but feel free to add any instance variables and private methods you understand are necessary.
• You will not be graded in terms of code coverage information provided by the submit server, although having a high code coverage is highly recommended (and encouraged).
• IMPORTANT → If you have a problem with your code and need assistance during office hours, you need to have a student test(s) that illustrates the problem you are experiencing.
• See Style Guidelines for information regarding style.
• We cannot provide any information regarding release nor secret tests. Once your project has been graded, you can see a TA if you would like to find out why you failed a release or secret test.

Suggestions on How To Start the Project

• Start with the simplest tetromino O or I.
• Procesing the movememnt are same for all tetrominos. Therefore, they can be implemented in the Tetromino class.
• Layout of a tetromino reprsents its shape. When a tetromino rotates, its layout changes. Each tetromino has 4 layouts. Each layout can be represented as the top-left cell position (0,0) and relative locations of other cells.
• Location is the location of the teromino on the game board.
• X is vertical axis and the Y axis is the horizontal axis.
• Successful left or right move updates the location.
• Successful rotation updates the layout and location
• For example:

Name	Initial (Up)	Rotate Left (Left)	Rotate Left (Down)	Rotate Left (Right)	Rotate Left (Up Again)
I
Layouts	(0,0),(1,0),(2,0),(3,0)	(0,0),(0,1),(0,2),(0,3)	(0,0),(1,0),(2,0),(3,0)	(0,0),(0,1),(0,2),(0,3)	(0,0),(1,0),(2,0),(3,0)
Locations	(0,5),(1,5),(2,5),(3,5)	(1,3),(1,4),(1,5),(1,6)	(0,4),(1,4),(2,4),(3,4)	(1,3),(1,4),(1,5),(1,6)	(0,4),(1,4),(2,4),(3,4)

Submission

Submit your project using the "Submit Project" option (available by right clicking on the project folder).

Academic Integrity

Please make sure you read the academic integrity section of the syllabus so you understand what is permissible in our programming projects. We want to remind you that we check your project against other students' projects and any case of academic dishonesty will be referred to the Office of Student Conduct.