Scrambler  - copyright Reynald Hoskinson
November, 2001. 

1. REQUIREMENTS
---------------

Java (JRE or JDK) 1.3 or above
http://java.sun.com/j2se/?frontpage-javaplatform


2. RUNNING SCRAMBLER
--------------------

java -jar Scrambler.jar


3. INTERFACE
------------

The main screen presents six streams - intially empty. 

To load a soundfile into one of the streams, click the "Segment"
button.  Select a wav sound file.  Right now, the only  supported
format is 44.1KHz, mono, 16bit.


3.1 Segmentation Window
------------------- 

The soundfile will show up graphically in the Segmentation Window.  To
segment the sound, click "Separate".  The segments will be represented
between the red lines that appear on the screen.  To change the
granularity of the segmentation, move the "Segementation Threshold"
slider.  To play the original sound, click "Play".  The button "Random
Play" triggers the resynthesized stream.  It is possible to move the
threshold slider when the sound is playing, but notice that the threshold
is only updated when you take your mouse off of the slider.


3.2 Control Window
--------------

The control window allows you to play and manipulate more than one
soundfile at a time.  The idea is to create audio environments, where
different samples fade in and out at different times.

The first thing to do is to load a sample, which is detailed above. 
Once this is done, there are a number of controls for each. 

3.21 Per Stream Controls
------------------------

Duration /  Trigger 

  Text boxes that control how often the stream is activated (trigger),
  and how long the stream plays for (duration).  So duration is always 
  less that trigger.  Each has an associated randomizer value.  For
  instance, if I give duration as 10.0 and 4.0, it would mean avg 10,
  with a standard deviation of 4.

Segment Button
  
  Opens the Segmentation window. 


Play 

  Plays randomized stream


Pan
  Knobs for manipulating stereo sound at Start/Middle/End of Duration. 
  0 is all on the left speaker, 1 all at the right. 

  The program interpolates through these three values over the length
  of the stream.

Gain Controls amplitude in the same manner as Pan.

Walk 
  Places the sound in a continuous random walk through stereo
  space, rather than using the Pan values.

3.22 Global Controls
--------------------

Presets

  At the bottom of the control window, there is the option of saving the
  entire current configuration for later sessions. Type the file name
  into the text box, and press "save".

Play/Stop

  At the bottom right, there are buttons to turn on and off all of the
  streams currently set up.


-----------------------------------------------

If you have any other questions,  mail me at
reynald@cs.ubc.ca