Recipe for new Scala-users to retune their synthesizer.
For soundcards and synthesizers without tuning table, see below.

- Connect the midi-input of the synthesizer to the midi-output of the computer.
- Allow the synthesizer to be retuned (i.e. set microtuning on, set
  memory protection off, or things like that).
- Set the midi receive channel on 1 or omni.
- Unzip the file gsplay1.zip. (Can be done in the same directory where
  Scala resides. If it is not, the directory must be added to the path.)
- You may want to read the extracted file gsplay.doc and/or adapt the file
  gsplay.cfg if you have a nonstandard midi-interface or PC.
- Run Scala by typing "scala".
- Type "show synth".
- Look which is the number for your synthesizer. If it's not listed, you
  are out of luck unless it supports the midi tuning standard, or unless you
  are able to add the proper system exclusive codes to the file synth.par.
- Type "set synth <number>" where <number> is the above number.
- We are going to create the so called Bohlen-Pierce scale, type: 
  "equal 13 3". This means divide the interval 3 (or 3/1 or 1902 cents which 
  is a perfect twelfth) into 13 equal sized steps.
- We can look at the pitch values in cents of the scale notes, type:
  "show", or "sh" is enough. Commands can be abbreviated.
- Type "@send". It may take a few seconds to transfer the scale to the
  synthesizer.
- Play the synthesizer to check if the scale was successfully transferred.


What if it didn't work?

- Scala said "Current synthesizer type undefined".
You forgot to do the "set synth" command.

- Scala said "Command file not found".
There needs to be a file send.cmd in the current directory. Either Scala
was not invoked from the working directory, or the file is missing.
It may be extracted from the zip-file with "pkunzip scala.zip send.cmd".

- There was a message on the screen that went away quickly. It may
  have been something like "Bad command or file name".
Then program gsplay.exe was not installed (properly) or it could not be
found in the working directory or along the directory path.

- The screen of gsplay.exe showed, but something went wrong.
Check if the configuration file gsplay.cfg contains the right settings.

- The screen of gsplay.exe showed and it said that file xxx.mid was
  transferred, but the synthesizer didn't respond.
Check if the right type was chosen by doing "show synth". Check the input 
channel on the synthesizer and the midi-cable. 

- The synthesizer indicates a buffer overflow.
Edit the file send.cmd and change the line
spawn gsplay xxx.mid
into:
spawn gsplay tempo 50 xxx.mid
This sets the midi transfer rate to 50%. Take a lower value if the problem
persists.


With a PC soundcard:

- First determine if the soundcard supports the midi tuning standard. The
  Turtle Beach Tropez for instance does but the SoundBlaster does not.
  If it's supported, do the following:
  - Run Scala by typing "scala".
  - Type "set synth 107".
  - We are going to create the so called Bohlen-Pierce scale, type: 
    "equal 13 3". This means divide the interval 3 (or 3/1 or 1902 cents which 
    is a perfect twelfth) into 13 equal sized steps.
  - We can look at the pitch values in cents of the scale notes, type:
    "show", or "sh" is enough. Commands can be abbreviated.
  - Type "send/file bohlen.mid".
  - Type "exit".
  - Leave DOS (type "exit" or start up Windows).
  - Play the file bohlen.mid with a sequencer (Cubase for instance) or a
    midi-file player.
  - Now play music via the soundcard.


For soundcards and synthesizers without a tuning table:

- The option that remains is to use midi pitch bend commands in the same
  midi file or sequencer song as the midi note commands. To produce such a 
  midi file from a text file, read the instructions in the help file. 
  Enter scala and type "help example". Then use the command "example".
  Another possibility is to retune an existing midi file. For this to be
  possible, the midi file should not use too many different voices 
  (program numbers) at one time. Exactly how much also depends on the number
  of simultaneous notes. Enter scala and type "help example". Then use 
  the command "example/midi". 
