
JavaArt Chapter 5. Program Sonification

From the website:

  Killer Game Programming in Java
  http://fivedots.coe.psu.ac.th/~ad/jg

  Dr. Andrew Davison
  Dept. of Computer Engineering
  Prince of Songkla University
  Hat yai, Songkhla 90112, Thailand
  E-mail: ad@fivedots.coe.psu.ac.th


If you use this code, please mention my name, and include a link
to the website.

Thanks,
  Andrew

============================

This directory contains 2 FreeTTS applications that you
can use to test FreeTTS and the MBROLA software and voices.

   * ListVoices.java   - this list all the synthesizers and voices known to FreeTTS

   * Speaker.java      - this uses the MBROLA female US voice to say a string
                         supplied by the user

There are 2 batch files:

  * compileTTS.bat
  * runTTS.bat
     - they assume that:
          * FreeTTS is in d:\freetts-1.2\
          * MBROLA software and voices are in d:\freetts-1.2\mbrola


----------------------------
Tools Required:

   * FreeTTS (http://freetts.sourceforge.net/)
   * MBROLA software and voices (http://tcts.fpms.ac.be/synthesis/mbrola.html) 

----------------------------
FreeTTS Installation
http://freetts.sourceforge.net/

1. Download the Windows binary version of FreeTTS v.1.2.2
   (freetts-1.2.2-bin.zip; 12.3 MB), unzip it, 
   and store freetts-1.2\ in a convenient location (e.g. on my
   d: drive as d:\freetts-1.2\). 
 
2. There's initially no JSAPI JAR file in the FreeTTS lib\ directory 
   (d:\freetts-1.2\lib\); it only appears after you execute jsapi.exe 
   in that directory. 

3. Many FreeTTS programming examples will not work unless the 
   speech.properties file in d:\freetts-1.2\ is copied either to your 
   home directory or to the JRE's lib\ directory (which for me is 
   c:\Program Files\Java\jre1.6.0_03\lib). 

More details on these set-up issues can be found at: 
  http://freetts.sourceforge.net/docs/jsapi_setup.html

The easiest way of testing things is to go  to d:\freetts-1.2\bin\, 
and type:

> java -jar HelloWorld.jar

It uses an US male voice called "kevin16" to say "hello world".


----------------------------
MBrola Installation
http://tcts.fpms.ac.be/synthesis/mbrola.html

Download four things: 

   * the PC/DOS version of the MBROLA binary (in mbr301d.zip; 115 KB)
         ^^^^^^
   * the three voices 
       - us1: American English Female (6.8 MB)  Babel Technology
       - us2: American English Male (6.3 MB)    Babel Technology
       - us3: American English Male (6.1 MB)    Mike Macon

Move the unzipped mbr301d.zip executable, mbrola.exe, to d:\freetts-1.2\mbrola\, 
along with the three unzipped voice folders (us1\, us2\, and us3\).
         
----------------------------
Examples Compilation (i.e. ListVoices.java and Speaker.java):

  > compileTTS *.java


----------------------------
Examples Execution:

  > runTTS ListVoices

  > runTTS Speaker "string that will be said"

      - FreeTTS and the US MBROLA voices must be installed


---------
Last updated: 4th May 2009
