TRAN


TRAN is a text-to-speech program for the IBM-PC.  It can read ASCII text
files, translate normal English spelling to phonemes, and sound out each
phoneme through the speaker of the IBM-PC. 

    usage: tran [+/-flags] [-options] [filename]

The filename is an ASCII text file (with no word processor formatting
codes).  If no filename is given TRAN reads input from the keyboard. 
The flags and options control various features of the program.  A '+'
turns the flag on and a '-' turns the flag off.  Options can use either
'+' or '-'. 

    flags: + = on, - = off
           p   type output of phoneme translation [off]
           r   add rule no. to phoneme translation [off]
           s   say output [on]
           t   echo input to console [off]
           T   do phoneme translation [on]
           v   type other internal information [off]

    options:
           c        say the time of day [once]
           C        say the time of day [every 10 seconds]
          d1 N      use N for space rate timing [5]
          d2 N      use N for voice rate timing [1]
           R        print all pronunciation rules
           ?        type usage

The following are example of ways to use the TRAN program.  You can have
tran type out and read this file with the command:

    tran +t tran.doc

If you also want to see the phoneme translation add the +p flag:

    tran +p +t tran.doc

You can save the phoneme translation in a file by typing:

    tran -s +p tran.doc > tran.phn

and listen to the phoneme at some other time file by typing:

    tran -T tran.phn

The TRAN program will say the time once if you type:

    tran +t +c

or will continue to say the time every 10 seconds if you type:

    tran +t +C

There are two timing parameters, d1 and d2, that control the rate that
TRAN speaks.  Making d1 larger increases the pauses between words and
making d2 larger lowers the pitch of the voice phonemes.  Both d1 and d2
must have a value of 1 or greater.  On an IBM-PC/XT, good values for the
timing parameters are d1=2 and d2=1.  If these parameters are not set
explicitly, the program will try to determine acceptable values
automatically.  Setting these values, will let TRAN by-pass the
automatic setting, which save a second or two starting the program. 
These values can be set on the command line:

    tran -d1 2 -d2 1 ... 

or by using the environment variable TRAN to pass these values as
d1,d2:

    set TRAN=2,1

On a 10 MHz IBM-PC/AT the timing prarameters need to be larger, d1=4
d2=13. 

Most of the speech-to-text rules used in the tran program come from an
article in an IEEE journal:

Elovitz, H.S., Johnson, R., McHugh, A., and Shore, J.E.  (1976). 
"Letter-to-Sound Rules for Automatic Translation of English Text to
Phonetics," IEEE Transactions on Acoustics, Speech, and Signal
Processing, Vol.  ASSP-24(6), 446-458. 

The program contains a set of 35 phonemes, each encoded as a sequence of
bits controlling the position (in or out) of the PC speaker.  The
phoneme codes come from the public domain program SPEECH by Andy
McGuire. 

Send your comments and suggestions to:

                                            Stephen Neely
                                            11230 Ohio St. 
                                            Omaha, NE 68131

         ----------------end-of-author's-documentation---------------

                        Software Library Information:

                   This disk copy provided as a service of

                        The Public (Software) Library

         We are not the authors of this program, nor are we associated
         with the author in any way other than as a distributor of the
         program in accordance with the author's terms of distribution.

         Please direct shareware payments and specific questions about
         this program to the author of the program, whose name appears
         elsewhere in  this documentation. If you have trouble getting
         in touch with the author,  we will do whatever we can to help
         you with your questions. All programs have been tested and do
         run.  To report problems,  please use the form that is in the
         file PROBLEM.DOC on many of our disks or in other written for-
         mat with screen printouts, if possible.  The P(s)L cannot de-
         bug programs over the telephone.

         Disks in the P(s)L are updated monthly, so if you did not get
         this disk  directly from the P(s)L,  you should be aware that
         the files in this set may no  longer be the current versions.

         For a copy of the latest monthly software library newsletter
         and a list of the 1,400+ disks in the library, call or write

                        The Public (Software) Library
                              P.O.Box 35705 - F
                           Houston, TX 77235-5705
                               (713) 665-7017