README.txt for GlassHand

DRAFT VERSION - DO NOT DISTRIBUTE test

The GlassHand was composed by John Bischoff for the Hub,
a pioneering computer music network band. This implementation
is by Phil Burk, and uses the JSyn - Java synthesis API, for
sound generation. It also uses JMIDI by Robert Marsanyi for
its network communication.

Each Performer -----------------------

1. Each performer should provide 8 monophonic samples,
roughly 0.5 to 3 seconds in length (whatever sounds good),
in AIFF or WAV format. Files must be 16 bit, 44100 Hz.

2. Edit the file glasshand\GlassHandSamples.java and
put in the names of your samples.

3. Place the samples in the classes directory, right above the
"glasshand\*.class" files.

To Compile ---------------------------

1. Install JMIDI and JSynV12 or later as documented.

2. Make sure that the package directories "jmidi" and "com\softsynth\jsyn"
are in the same directory as the "glasshand" directory.

3. CD to the classes directory, right above the
"glasshand\*.class" files.

4. Enter:   javac  glasshand\*.java

To Run -------------------------------

1. Connect N>1 computers together in a MIDI ring network, "out-to-in".

2. Enter:  java glasshand.GlassHand

During the performance, change the Amplitude fader to increase your amplitude.
Doing so will send a message to the next computer increasing its glide rate.

Change current sample using the radio buttons.

Change presets using the row of numbered radio buttons.

Use the "Glide", "Frequency", and "Range" faders only for testing the sound,
not during the performance!

References:

JSyn  at http://www.softsynth.com/jsyn
JMIDI at http://www.softsynth.com/javamidi
Phil Burk at philburk@softsynth.com
