/* SpeechToy.c  Original by Dave Lucas, Enhancements by Rob Peck.
 *
 * o  Can now read and write its own icon to get the defaults you set.
 * o  New menu item added to save current speech settings.
 * o  Can be started from WBENCH or CLI; if from CLI, can still
 *    read the icon file to get the default values.
 *
 * In the toolstrings, the data takes the form:
 *
 * SEX=1
 * SEX=0
 * for female (1) or male (0) voice.
 *
 * MODE=0
 * MODE=1
 * for expressive (0) or robotic (1) voice.
 *
 * FREQUENCY=20000
 * numeric range from sampling frequency MIN to 
 * frequency MAX (see the audio.h file)
 * 
 * RATE=150
 * words per minute rate, see audio.h for range.
 *
 * VOLUME=64
 * volume range from 0 to 64 (max).
 *
 * PITCH=224
 * pitch value for speech, range see audio.h
 *
 * These values can be saved in the icon by using the save menu item
 * --------------------------------------------------------------------
 *
 * WORDS=This is Amiga Speaking
 * anything you want it to insert in the English Phrase area.
 *
 * TRANS=1
 * means: Translate whatever words there are in the english.
 *
 * SPEAK=1
 * means: Say it.  When this is in the icon, it opens up talking.
 *
 * PHON=DHIHS IHZ AHMIY3GAH SPIY4KIHNX.
 * This is the way you insert your own custom pronunciation.
 * Note that it MUST be legal phonetics per the Speech docs.
 */

/* AREXX support:
 *
 * AREXX port is named SPEECHTOY, so that AREXX, which capitalizes
 * things automatically, doesn't need quotes on the name to
 * prevent it from capitalizing and not finding the port.
 *
 * To change any parameter, do EXACTLY as the toolstrings description
 * shows... I use the SAME routines to parse the command that AREXX
 * sends as are used to decode the icon's toolstrings.
 *
 * To send a command directly from a CLI interface, using AREXX
 * support function, do this:
 *
 * rx "address speechtoy 'WORDS=Say this you turkey'"
 * rx "address speechtoy 'TRANS=1'"
 * rx "address speechtoy 'SPEAK=1'"
 */

/* CLI startup:
 *
 * To allow speechtoy to read its own icon, either CD to the
 * directory where speechtoy is located, then:  run speechtoy
 * OR CD anywhere, then:
 *
 * 	run speechtoy <dir-where-icon-is-located>
 *
 * example:
 *
 * CD DF0:
 * RUN df1:speechtoy df1:
 */

/* COMPILING:  Lattice - compiles cleanly under Lattice 3.03 and 4.0
 *             if stack is set to 20000
 *
 *             Manx 3.4b compiles cleanly, used for this object file.
 *	       Use "cc +L toywork9.c" and "ln toywork9.o c32.lib"
 *             (have not tried to adjust it for 16 bit integers).
 *
 * Original LUCAS comments (for most part) removed, see the FISH
 * disk with original speechtoy to see what was there before.
 * File got up over 65k source when I was through with it.
 *
 * Enhancements needed:  Add capability to input PHONETIC strings.
 *                       Strip it down into just a speech server
 *                       with no windowing interface, but still read
 *                       the icon file for the defaults.
 */

/* Written by David M Lucas. */
/* Enhanced by Rob Peck */