Assignment 12: Spampede!
Due Wednesday December 11th at 5:30 pm

Please read the following carefully. There is a lot here!

1. Pair programming is permitted on all parts of this week's assignment.  


2. You will be submitting several files for this assignment. Please zip all of your files into a single zip file named hw12files.zip and then submit that zip file for your assignment. That way, we know we'll be able to run your applet!


3. This week, we ask that you also submit a file that is typically submitted in any large software project: A text file called README. We have provided a basic README file on the main assignment page. You should edit this file and submit it. The README file will constitute part of your score on this assignment. We ask that you to list the features, possible missing features, and any additions to the game that you've created.
4. Previous students have identified some common mistakes that we think might be helpful to you!
   • Check your x/y consistency! Make sure that you're using the same conventions for storing x and y in each of your classes!
   • Remember to reset your Pede!

Overview

• Maze.java: Responsible for storing the walls and spam in the maze  You extended the Maze class to incorporate more of the game's functionality.
• SpamMaze.java: A subclass of Maze that does everything a Maze does AND keeps track of the spam that populates the board and location of the centepede.  This is the class that has all of the functionality for playing the game including moving the pede, populating the board with spam, determining whether the pede has hit a wall, etc.
• Spampede.java: A class that controls the functionality of the Applet.  This class is responsible for displaying the board to the user, handling the user's key strokes, and controlling the timesteps that move the pede forward.It accomplishes some of these tasks by extending the class SpampedeBase

SpamMaze.java

The overview

In this part of the assignment you will create a derived class named SpamMaze that handles the model for the applet. A derived class is simply an extension of the data and capabilities (methods) available in the base class. Thus, by starting the code as in the provided SpamMaze.java file:

import java.lang.Math;
import java.util.LinkedList;

class SpamMaze extends Maze
{
  // your code goes here...
}

The data

Because a SpamMaze object represents the model for the Spampede applet, it needs to keep track of (1) the maze, (2), the centipede, and (3) the spam in the environment. Remember that (1) is already taken care of because your SpamMaze is a derived class of Maze. To keep track of (2) and (3), you should use lists of MazeCells. In particular, you will declare two data members:

  // The data members representing the spam and the centipede
  private LinkedList<MazeCell> spamCells;
  private LinkedList<MazeCell> pedeCells;

How should we represent the head of the snake?    One way to do this is simply to decide that the first element of the pedeCells data member will always be the head of the snake. Equivalently, you could use the last element. Either way, it will be up to your code to make sure the head of the snake contains the 'S' character, that the other cells in the snake contain the 'P' character, and that the snake is updated appropriately.

Overview of Spampede.java

The Spampede applet gives a user control over a spam-seeking centipede. Key presses from the keyboard change the direction of the centipede's movement in order to intersect snacks (spam) that appear at random places on the screen. For each snack consumed, the centipede grows by one segment (a segment is simply one MazeCell). Variations are welcome (see the extra credit section below)!

Setting up

The "starter" applet Spampede.java and its html file Spampede.html are provided for you on the top-level assignments page.  There are some other files you'll need so you should download the full hw12 directory.

Finally, we have also provided the following files which you may wish to use (but they are totally optional):

• Spam.au, an audio file
• crunch.au an audio file
• spam.gif, an image of a can of Spam

Order of Tasks

Additional tips for various methods

• Be sure to create, in init and/or in reset, a SpamMaze and make sure it is in a suitable starting configuration. There is already a data member named this.themaze to hold the created object.


• Draw the contents of the SpamMaze within the drawEnvironment method already provided. This will require writing a nested loop to create the 2d array of 10x10 pixel squares that represent the maze. This drawEnvironment method will be called every so often by the cycle method to show the latest state of the maze. You should use different colors of your choice representing walls, empty space, the head of the centipede and the body of the centipede. You will want to use the fillRect command to accomplish this.


• Update the spam within the SpamMaze named themaze. Within updateSpam you can add (and/or remove) spam every so often -- though doing so every cycle will probably be too fast!. You can also add spam as needed (e.g., when one is eaten). But, you should make sure to have at least one spam on the board at all times.


• Keep track of the centipede (i.e., the "spampede"). The updatePede method is provided as a placeholder for where you would do this. You might want a data member that keeps track of the centipede's current direction so that advancePede can be called appropriately -- the provided code has a data member private char dir that you might use for this. In this case, key presses would simply change this internally-stored dir.
  
  Keep in mind that no MazeCells are moving as the centipede crawls through the maze! Rather, it's the data member named pedeCells of type LinkedList that's snaking its way through the 2d array of MazeCellss by changing the cells to which it refers.


• Handle key presses. You will see a method that prints out certain characters when track of the centipede (i.e., the "spampede"). When the user presses the following keys, the centipede should change direction as indicated:
  • r : reverse, switching its head's position to its tail
  • i : turn north
  • j : turn west
  • l : turn east
  • k : turn south
  • a : go into autonomous, spam-seeking mode ("AI")
  If the centipede is already heading in the direction that the user chooses, nothing changes. If the user changes the centipede's direction so that it is moving back on itself (from South to North, say, or West to East), you may reverse direction, ignore the command, or "terminate" the centipede.



• When you run Spampede.java in Eclipse, you will first get a very small window!

  To get the regular size window, you must go to the Run Configurations dialog box. You can do this by opening up the Spampede.java file and clicking Run->Run Configurations. In the Run Configuration menu (shown below), click on the "Parameter" tab and modify "Width" and "Height" to both be 600.

  

  Now if you run Spampede.java you should see this:

  

A Reminder On What to Submit