CS 160, Fall 2013
Programming Assignment P8
Virtual Guitar Hero

Programming due Monday, Dec. 9 at noon; late deadline Dec. 9 at 10 p.m.

1. Having fun with music on a computer

Description

Instructions

Part One

1. Copy the code from P8.java.
2. Remove the acknowledgements section and put in your own name, date, etc.
3. Import GuitarHero.jar into the P8 project.
4. Use "Build Path"->"Add External Archives", to do the previous step.
5. Copy the data file music.txt, and put it in your project (not in src or bin).
6. Copy the data file scale.txt, and put it in your project (not in src or bin).

Part Two

1. In the area for class instance variables:
   
   
   • - Declare an integer variable to hold the number of notes, set it to 13.
   • - Declare and allocate an array of GuitarString objects, of size 13.
     Note: Make sure you remove the original instance variables (stringA and stringC).
   • - Declare an array of notes of type String, of size 13.
   • - Initialize the notes array with the following 13 values:

   "C","C#","D","D#","E","F","F#","G","G#","A","A#","B","H"
   

2. In the main method:
   
   
   • Initialize the array of GuitarString in main for the entire octave.
   • You must use a loop, not thirteen separate statements.
   • Remember to allocate each GuitarString with new.
   • Use the following formula to calculate the frequency of each string:

     double frequency = 440.0 * Math.pow(1.05956, index - 9);
     p8.strings[index] = new GuitarString(frequency);
     

   • Here is the mapping for the index shown above:

           0 - middle C ("C")
           1 - C# above middle C ("C#")
           2 - D above middle C ("D")
           3 - D# above middle C ("D#")
           4 - E above middle C ("E")
           5 - F above middle C ("F")
           6 - F# above middle C ("F#")
           7 - G above middle C ("G")
           8 - G# above middle C ("G#")
           9 - A above middle C ("A")
           10 - A# above middle C ("A#")
           11 - B above middle C ("B")
           12 - high C ("H")
       
   The above notes represent one octave of a piano from middle C to high C.
   

3. Add code to pluckGuitar to handle all 13 notes.
4. There are at least three ways to do this:
   • A switch statement on the strings (Java 1.7 only).
   • An if/else if/else statement with thirteen conditions.
   • A loop that searches for the strings in the notes array.
5. The next two items require a loop:
6. Modify the code in playGuitar to combine the samples for all guitar strings in the array.
7. Modify the code in playGuitar to advance the simulation for all guitar strings in the array.
8. The methods for GuitarString that you call (do not write these!) are as follows:

   public GuitarString (double frequency); // Constructor
   public void pluck();                    // Pluck string
   public void tic();                      // Advance simulation
   public double sample();                 // Get next sample
   

Part Three

1. Write the following code in the playFile method.
2. In a try/catch block, create a scanner for the file passed in.
3. Create a loop to read tokens one at a time.
4. Each token should be a single note matching the strings in the note array.
5. Call pluckGuitar with each token that you read from the file.
6. Call playGuitar 11,025 times, which plays the note for ~0.25 seconds.
7. Add the command line argument "music.txt" to Run Configuration

Part Four

1. Declare the following string in playKeyboard:

       String keyboard = "Q2W3ER5T6Y7UI";
       

2. This string corresponds to the notes on a piano, as shown below:

               Q maps to "C"
               2 maps to "C#"
               W maps to "D"
               3 maps to "D#"
               E maps to "E"
               R maps to "F"
               5 maps to "F#"
               T maps to "G"
               6 maps to "G#"
               Y maps to "A"
               7 maps to "A#"
               U maps to "B"
               I maps to "H"
           

3. Translate the key pressed to the index within the keyboard string (1 line of java).
4. Use the index to lookup the string in the notes array (1 line of java).
5. Call pluckGuitar with the note corresponding to the key pressed.
6. No other changes are necessary

Part Five

1. Add a parameter to the playKeyboard method for the output filename.
2. Call playKeyboard with args[1].
3. Modify the Run Configurations to add the output file name as an argument, e.g. "output.txt".
4. At the top of playKeyboard, open a PrintWriter for the file, in a try/catch.
5. Each time you call pluckGuitar to play a note, also write the String to the file.
6. Write the notes to the file, not the keyboard characters, i.e. "A", "A#", "B", etc., not "Q", "2", "W", etc.
7. Don't forget to catch exceptions and close the PrintWriter.

Testing

Grading Rules

• Work on your own.
• The name of the source code file must be exactly P8.java
• Comments at the top with your name, e-Name, date and course.
• Submit the P8.java source file, not the P8.class file.
• We expect programming assignments to be implemented in Eclipse using Java 1.5 or 1.6 or 1.7 (1.4 or less will NOT work).
• We will be testing the code on the machines in the CS computer lab, so make sure your code runs on those machines.
• We will be checking programs for plagiarism, so please don't copy from anyone else.

Grading Criteria

• 100 points for perfect submission.
• 0 points for no submission, will not compile, submitted class file, etc.
• Preliminary Tests
  • compileTest: checks that program compiles. (0 points)
  • test0: checks that the guitar strings are initialized correctly. (15 points)
  • test1: checks that your program can read and playback "scale.txt". (15 points)
  • test2: checks that your program can read and playback "music.txt". (15 points)
  • test3: checks playback of an arbitrary music file. (15 points)
• Final Tests
  • test4: checks correct implementation of writing an output file. (20 points)
  • test5: checks correct implementation of the advanced keyboard playback. (20 points)
  • Final grading includes the preliminary tests.

Submission

ACKNOWLEDGEMENTS: