CSC111 Lab 3

You are going to use the computers in Windows mode today. Be sure to reboot them if they are in Mac mode, please!

Software Setup (to be performed before the lab)

Before you can use the JES programming environment, you need to install it first.

• Login to your Novell account.

• Open your H: drive in Windows Explorer.

• Open Windows Explorer a second time, so that you have two windows open.

• In the second window, enter this address in the Address bar: \\rescent\pc\COURSES\CSC\CSC111

This is the place on the Novell network where you will find JES-related files.

• Drag the folder named jes-3-1-1windows from the CSC111 window to your H: drive.
  

• You will see another folder in CSC111 folder called Sound Files. Drag it as well from the CSC111 window to your H: drive.

• You can now close the windows showing the CSC111 folder. You won't need it for the rest of this lab.

• In the window showing your H: drive, open the JES folder and click on the JES icon (snake face with glasses :-)

• After a few (long) seconds, you should get the JES programming environment.

If you want to install JES on your personal Windows computer

If you want to install JES on your Windows laptop or computer, you can get Jes from the Google code web site. Grab the 3.2.1 version for Windows and install it on your Windows machine.

If you want to install JES on your personal Mac

Jes for the Mac is available on Google code. Get Jes 3.2.1 for the Mac, open the zip file, and move the JES 3.2.1.app to your Applications folder.

Additional Notes for Mac Users

If you want to download the Sound Files to your MacBook or MacPro, Follow these steps (you must be on campus for this to work):

• Click on the desktop to bring up the Finder menu
• Click on Go
• Click on Connect to Server
• Click on aft://rescent.smith.edu
• Click on RESCENT.PC

This will create a new Drive called RESCENT.PC on your Desktop.

• Open the new drive
• Select Courses
• Select CSC
• Select CSC111
• Drag the Sound Files folder to your Desktop.

Part 1 (Official Start of the Lab): Your First JES Program

Open JES by double-clicking on the icon or navigating through the start menu (on pcs)

• In the window that opens, the top portion is program area, and the bottom portion is command area (the interactive window we have already seen on beowulf).

• In the Program area, type in the following lines, being careful to follow the format exactly (including all punctuation and indenting)

.

def main():
    name = raw_input( "what is your name? " )
    print "hello there, " + name + "!"
 
.

• Save the file by typing Control-S.
• A popup window opens up. Save the file as hello.py in your H: drive
• Click on Load Program button to load the file just stored in JES.
• In the command area (black window), type

  main()

to call the function.

• Make sure you see the pop-up window asking for your name, and the response of the program in the interactive area.

Part 2: Playing Sound Files

• In the JES program area, type in the following main() function:

.

def main():
  file = pickAFile()
  sound = makeSound( file )
  blockingPlay( sound )

.

• Save the file as sound1.py
• Click on Load Program
• In the interactive area, type

 main()

• When prompted for a sound file, select thisisatest.wav in the Sound Files folder.
• Make sure the speakers are on, but not too loud and listen to the sentence being played.
• Try one or two other sound files.

Part 3: Altering the sound file

• You will reduce the intensity of the sound by dividing all the samples by half
• Copy/Paste the program below in JES
• Read it to make sure you understand it.

.

def main():
  # select  a sound file
  file = pickAFile()
  sound = makeSound( file )

  # play it
  blockingPlay( sound )

  # lower its intensity by half
  for i in range( 1, getLength( sound )+1 ):
     value = getSampleValueAt( sound, i )    # get the value of the i-th sample
     setSample( sample, value / 2 )  # set the sample to half its original value

  # play new waveform back
  blockingPlay( sound )

.

JES Sound Functions

This is just reference material taken from Depaw U. that you may want to play with.

A sound is treated as a collection of sample values, much as a picture is a collection of pixels. Here are the functions on sounds:

makeSound(file)	Return a sound loaded from a WAV, AU, or AIFF file
makeEmptySound(sec)	Return a blank sound (all samples 0) of length sec seconds
writeSoundTo(s, file)	Save s in the given file; uses the same format as when loaded (makeEmptySound creates a sound in WAV format)
openSoundTool(s)	Open the sound exploration window for s
play(s)	Play sound s in the background
playAtRate(s, r)	Play s at speed r--1.0 is normal, 2.0 is twice as fast, etc.
playInRange(s, b, e)	Play s from sample number b to e
playAtRateInRange(s, r, b, e)	Play s from b to e at speed r
blockingPlay(s)	Play s and wait for it to finish (also, blockingPlayInRange and blockingPlayAtRateInRange)
getSamples(s)	Return the collection of samples in s (not quite a list, but indexable and usable in a for loop)
getLength(s)	Return the number of samples in s
getSamplingRate(s)	Return the number of samples per second in s

There are also some useful methods on sound and sample objects:

s.getSampleValue(i)	Return the (left channel, if stereo) value of the ith sample in s (the first sample is at index 1)
s.getLeftSampleValue(i)	Return the left channel value at index i
s.getRightSampleValue(i)	Return the right channel value at index i
s.setSampleValue(i, v)	Set the (left) value of sample i to v; the range of sample values is -32,768 to +32,767
s.setLeftSampleValue(i, v)	Same
s.setRightSampleValue(i, v)	Guess what?
s.getSampleObjectAt(i)	Extracts the sample object at index i, without creating a whole collection of samples
samp.value	Return the value of sample samp; change the value by assigning to this
samp.left	Return or change the left channel value of samp
samp.right	Return or change the right channel value of samp

Finally, JES provides a simple function to play a MIDI note:

playNote(n, dur, vol)

plays note number n (middle C is 60, C-sharp is 61, etc.; the range is 0-127) for dur milliseconds at volume vol (maximum is 127).

The function pauses execution until the note is finished. For much more complete support of MIDI music, see the next section.