home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / fest-141.zip / festival / mbrola.txt < prev    next >
Text File  |  1999-06-28  |  31KB  |  799 lines
  1. M     M  BBBB    RRRR      OOO    L        A
  2. MM   MM  B   B   R   R    O   O   L       A A
  3. M M M M  B   B   R   R   O     O  L      A   A
  4. M  M  M  BBBB    RRR     O     O  L     AAAAAAA
  5. M     M  B   B   R  R    O     O  L     A     A
  6. M     M  B    B  R   R    O   O   L     A     A
  7. M     M  BBBBB   R    R    OOO    LLLLL A     A
  8.  
  9. --------------------------------------------------------------
  10. Table of Contents
  11. --------------------------------------------------------------
  12.  
  13. 1.0 License
  14. 2.0 A brief description of the MBROLA software
  15. 3.0 Distribution
  16. 4.0 Installation, and Tests
  17. 5.0 Format of input and output files - Limitations
  18. 6.0 Joining the MBROLA project as a user
  19. 7.0 Joining the MBROLA project as database provider
  20. 8.0 Acknowledgments
  21. 9.0 Contacting the author
  22.  
  23. --------------------------------------------------------------
  24. 1.0 License
  25. --------------------------------------------------------------
  26.  
  27. This program and object code is being provided to "you", the licensee,
  28. by Thierry  Dutoit, the "author",  under  the following license, which
  29. applies to any  program, object code or other   work which contains  a
  30. notice placed  by  the copyright holder saying  it  may be distributed
  31. under the terms of this license.   The "program", below, refers to any
  32. such program, object code or work.
  33.  
  34. By obtaining,  using and/or copying  this program, you  agree that you
  35. have   read,  understood,  and   will  comply   with  these  terms and
  36. conditions:
  37.  
  38. Terms and conditions for the distribution of the program
  39. --------------------------------------------------------
  40.  
  41. This program may not be sold or incorporated into any product which is
  42. sold without prior permission from the author.
  43.  
  44. When no  charge is made, this  program  may be copied  and distributed
  45. freely, provided that   this notice  is  copied  and distributed  with
  46. it. Each time you redistribute  the program (or any  work based on the
  47. program), the recipient   automatically receives  a license from   the
  48. original  licensor to copy or distribute  the program subject to these
  49. terms and conditions.  You may  not impose any further restrictions on
  50. the recipients' exercise of   the rights granted  herein. You  are not
  51. responsible for enforcing compliance by third parties to this License.
  52.  
  53. If you wish to incorporate the program  into other free programs whose
  54. distribution conditions are different, write to  the author to ask for
  55. permission.
  56.  
  57. If, as   a consequence of a   court judgment  or  allegation of patent
  58. infringement or  for any other reason  (not limited to patent issues),
  59. conditions are imposed  on you (whether  by court order,  agreement or
  60. otherwise) that contradict the conditions of this license, they do not
  61. excuse   you from the   conditions  of this  license.    If you cannot
  62. distribute so as to satisfy simultaneously your obligations under this
  63. license and any other pertinent obligations, then as a consequence you
  64. may   not distribute the  program at  all.    For example, if a patent
  65. license would not permit royalty-free redistribution of the program by
  66. all those who receive copies directly or  indirectly through you, then
  67. the only way you  could satisfy both it and  this license would be  to
  68. refrain entirely from distribution of the program.
  69.  
  70. Terms and conditions on the use of the program
  71. ----------------------------------------------
  72.  
  73. Permission  is  granted   to use  this   software  for non-commercial,
  74. non-military purposes,  with and  only  with  the voice   and language
  75. databases  made available by  the author  from the  MBROLA project www
  76. homepage:
  77.  
  78.          http://tcts.fpms.ac.be/synthesis
  79.  
  80. In return, the author asks you to mention the MBROLA reference paper:
  81.  
  82. T. DUTOIT, V. PAGEL, N. PIERRET, F.  BATAILLE, O. VAN DER VRECKEN
  83. "The MBROLA Project: Towards a Set of High-Quality Speech
  84. Synthesizers Free of Use for Non-Commercial Purposes"
  85. Proc. ICSLP'96, Philadelphia, vol. 3, pp. 1393-1396.  
  86.  
  87. or,  for a more general  reference   to Text-To-Speech synthesis,  the
  88. book:
  89.  
  90. An Introduction to Text-To-Speech Synthesis,
  91. T. DUTOIT, Kluwer Academic Publishers, Dordrecht 
  92. Hardbound, ISBN 0-7923-4498-7
  93. April 1997, 312 pp. 
  94.  
  95. in any scientific publication referring to work for which this program
  96. has been used.
  97.  
  98. Disclaimer
  99. ----------
  100.  
  101. THIS  SOFTWARE CARRIES NO   WARRANTY, EXPRESSED OR IMPLIED.  THE  USER
  102. ASSUMES ALL RISKS, KNOWN OR UNKNOWN, DIRECT OR INDIRECT, WHICH INVOLVE
  103. THIS SOFTWARE IN ANY WAY. IN PARTICULAR, THE  AUTHOR DOES NOT TAKE ANY
  104. COMMITMENT IN VIEW OF ANY POSSIBLE THIRD PARTY RIGHTS.
  105.  
  106. --------------------------------------------------------------
  107. 2.0 A brief description of MBROLA
  108. --------------------------------------------------------------
  109.  
  110. MBROLA is a  speech synthesizer  based  on the concatenation  of
  111. diphones. It takes a list of phonemes as input, together with prosodic
  112. information  (duration of phonemes  and a piecewise linear description
  113. of  pitch), and produces  speech samples  on 16  bits (linear), at the
  114. sampling frequency of the diphone database. 
  115.  
  116. It is therefore NOT a Text-To-Speech  (TTS) synthesizer, since it does
  117. not accept raw text as input.  In  order to obtain  a full TTS system,
  118. you need to use this synthesizer in combination with a text processing
  119. system that produces phonetic and prosodic commands.
  120.  
  121. We maintain a web page with pointers to such freely available systems:
  122.  
  123. http://tcts.fpms.ac.be/synthesis/mbrtts.html
  124.  
  125. This software is the heart of the MBROLA project,  the aim of which is
  126. to   obtain  a set a   speech  synthesizers for as   many languages as
  127. possible, free of use for non-commercial applications.
  128.  
  129. The terms of this project can be summarized as follows :
  130.  
  131. After some official agreement between the  author of this software and
  132. the  owner of  a diphone database,   the database is  processed by the
  133. author and  adapted  to the mbrola format,  for  free.  The  resulting
  134. mbrola diphone database  is made available  for non-commercial  use as
  135. part of  the MBROLA project.  Commercial rights on the mbrola database
  136. remain with  the database provider, for exclusive  use with the mbrola
  137. software.
  138.  
  139. The ultimate goal of this project is to boost  up academic research on
  140. speech synthesis, and particularly on prosody generation, known as one
  141. of the biggest challenges taken  up by Text-To-Speech synthesizers for
  142. the years to come.  If you want to  provide  a database to  the mbrola
  143. project, write first to mbrola@tcts.fpms.ac.be
  144.  
  145. More details can be found at the MBROLA project homepage :
  146.  
  147. http://tcts.fpms.ac.be/synthesis
  148.  
  149. The synthesizer uses a synthesis method known itself as MBROLA.
  150.  
  151. --------------------------------------------------------------
  152. 3.0 Distribution
  153. --------------------------------------------------------------
  154.  
  155. This distribution of mbrola contains the following files :
  156.  
  157. mbrola.exe  or mbrola: An  executable  file of the synthesizer  itself
  158. (depends on the computer supposed to run it) 
  159. readme.txt : This file
  160.  
  161. As   such,  it  requires an  MBROLA    language/voice database  to run
  162. properly.  American English,   Arabic, Brazilian Portuguese,   Breton,
  163. British English,  Croatian,  Dutch, Estonian, French,   German, Greek,
  164. Mexican    Spanish,  Romanian, Spanish  and  Swedish   voices are made
  165. available. Additional languages and voices   will be available in  the
  166. context of the MBROLA project.
  167.  
  168. Please consult the MBROLA project homepage to get the voices:
  169.  
  170. http://tcts.fpms.ac.be/synthesis
  171.  
  172. --------------------------------------------------------------
  173. 4.0 Installation and Tests
  174. --------------------------------------------------------------
  175.  
  176. The following computers/OS are currently supported :
  177.  
  178. SUN Sparc 5/S5R4 (Solaris2.4)
  179. HPUX9.0 and HPUX10.0 
  180. VAX/VMS V6.2 (V5.5-2 won't work)
  181. DECALPHA(AXP)/VMS 6.2
  182. AlphaStation 200 4/233
  183. AlphaStation 200 4/166
  184. IBM RS6000 Aix 4.12
  185. PC486/DOS6 (but other PCs/DOSs should do, too)
  186. PC486/Windows 3.1
  187. PC486/Windows 95 
  188. PC-Pentium/Windows 98
  189. PC-Pentium/Windows NT
  190. PC/LINUX 1.2.11
  191. PCPentium120/Solaris2.4
  192. OS/2
  193. BeBox
  194. BeOs (PPC,i386)
  195. Macintosh
  196.  
  197. Please send acknowledgement when mbrola works  on a machine not listed
  198. here. A special  DLL version is  distributed for  PC/Windows to  allow
  199. direct audio output; check on the Mbrola site the Mbrolatools package.
  200.  
  201. See the MBROLA Homepage if your computer or OS is not supported yet.
  202.  
  203. Assuming you have  copied  the right .zip   file,  create a  directory
  204. mbrola (although this is not  critical), copy the mbrXXX.zip file into
  205. it (in which XXX stands for a version number), and unzip the file:
  206.  
  207. unzip mbrXXX.zip (or pkunzip on PC/DOS)
  208.  
  209. You are now ready to synthesize your first words....
  210.  
  211. First try: mbrola
  212.  
  213. to see the terms and conditions on the use of this software. 
  214.  
  215. Then try: mbrola -h 
  216.  
  217. to get some help on how to use the software:
  218.  
  219. > USAGE: ./synth [COMMAND LINE OPTIONS] database pho_file+ output_file
  220. >
  221. >A - instead of pho_file or output_file means stdin or stdout
  222. >Extension of output_file ( raw, au, wav, aiff ) tells the wanted audio format
  223. >
  224. > Options can be any of the following:
  225. > -i    = display the database information if any
  226. > -e    = IGNORE fatal errors on unkown diphone
  227. > -c CC = set COMMENT char (escape sequence in pho files)
  228. > -F FC = set FLUSH command name
  229. > -v VR = VOLUME ratio, float ratio applied to ouput samples
  230. > -f FR = FREQ ratio, float ratio applied to pitch points
  231. > -t TR = TIME ratio, float ratio applied to phone durations
  232. > -l VF = VOICE freq, target freq for voice quality
  233. > -R RL = Phoneme RENAME list of the form a A b B ...
  234. > -C CL = Phoneme CLONE list of the form a A b B ...
  235. > 
  236. > -I IF = Initialization file containing one command per line
  237. >         CLONE, RENAME, VOICE, TIME, FREQ, VOLUME, FLUSH, COMMENT,
  238. >         and IGNORE are available
  239.  
  240. Now  in order to go   further, you need to get  a version of an MBROLA
  241. language/voice database  from  the  MBROLA  project homepage.  Let  us
  242. assume  you   have  copied   the   FR1   database  and    referred  to
  243. the accompanying fr1.txt file for its installation. 
  244.  
  245. Then try: mbrola fr1/fr1 fr1/TEST/bonjour.pho bonjour.wav
  246.  
  247. it uses the format:
  248.  
  249. mbrola diphone_database command_file1 command_file2 ... output_file
  250.  
  251. and creates a sound file for the word 'bonjour' ( Hello !).
  252.  
  253. Basically the output file is composed of signed  integer numbers on 16
  254. bits, corresponding to samples at the sampling frequency of the MBROLA
  255. voice/language  database (16 kHz for  the diphone database supplied by
  256. the author of MBROLA : Fr1).  MBROLA  can produce different audio file
  257. formats:  .au, .wav, .aiff, .aif,  and   .raw files  depending  on the
  258. ouput_file extension. If the  extension is not recognized,  the format
  259. is RAW (no  header). We recommand  .wav for Windows,  and .au for Unix
  260. platforms.
  261.  
  262. To display information  about the phoneme  set  used by the  database,
  263. type:
  264.           mbrola -i fr1/fr1
  265.  
  266. It displays the phonetic  alphabet  as well as copyright   information
  267. about the database.
  268.  
  269. Option  -e makes  Mbrola  ignore  wrong or  missing  diphone sequences
  270. (replaced  by silence)  which can  be quite useful when debugging your
  271. TTS. Equivallent to "IGNORE" directive in the initialization file (N.B
  272. replace the obsolete ;;E=OFF , unsupported in .pho file).
  273.  
  274. Optional parameters let you shorten  or lengthen synthetic speech  and
  275. transpose it by providing optional time and frequency ratios:
  276.  
  277. mbrola -t 1.2 -f 0.8 fr1/fr1 TEST/bonjour.pho bonjour.wav
  278.  
  279. or its equivalent in the initialization file:
  280.  
  281. TIME 1.2
  282. FREQ 0.8
  283.  
  284. for instance,  will result in  a  RIFF Wav file  bonjour.wav 1.2 times
  285. longer than  the previous one (slower  rate), and containing speech in
  286. which all  fundamental frequency  values  have been multiplied  by 0.8
  287. (sounds lower).
  288.  
  289. You can also set  the values of these  coefficients directly in a .pho
  290. file by adding special escape sequences like : 
  291.  
  292. ;; F=0.8
  293. ;; T=1.2
  294.  
  295. You can change the voice characteristics with the -l parameter. If the
  296. sampling rate of your database   is 16000, indicating -l 18000  allows
  297. you to shorten the vocal tract by a ratio of 16/18 (children voice, or
  298. women voice  depending   on the voice you're   working  on).  With  -l
  299. 10000, you  can lengthen the vocal  tract by a  ratio of 16/10 (namely
  300. the voice  of  a Troll).  The  same command  in an initialization file
  301. becomes "VOICE 10000".
  302.  
  303. Option  "-v"  specifies a  VolumeRatio which   multiplies each  output
  304. sample. In  the example below, each sample  is multipliead by 0.7 (the
  305. loudness goes down). Warning: setting  VolumeRatio too high  generates
  306. saturation. 
  307.  
  308.          mbrola -v 0.7 fr1/fr1 TEST/bonjour.pho bonjour.wav
  309.  
  310.        or add "VOLUME 0.7" in an initialization file
  311.  
  312. The -c option lets you specify which symbol  will be used as an escape
  313. sequence for comments and commands in .pho files. The default value is
  314. the semi-colon ';', but  you may want  to change this if your phonetic
  315. alphabet uses this symbol, like in:
  316.  
  317. mbrola -c ! fr1/fr1 TEST/test1.pho test2.pho test.wav
  318.  
  319. equivalent to "COMMENT !" in an initialization file
  320.  
  321. The -F option lets you specify which symbol will be used to Flush the
  322. audio output. The default value is #, you may want to change the
  323. symbol like in:
  324.  
  325. mbrola -F FLUSH_COMMAND fr1/fr1 test.pho test.wav
  326.  
  327. equivalent to "FLUSH FLUSH_COMMAND" in the initialization file.
  328.  
  329.  
  330. Using Pipes
  331. -----------
  332.  
  333. A - instead  of command_file or  output_file means stdin or stdout. On
  334. multitasking machines, it is easy to run  the synthesizer in real time
  335. to obtain audio output from the audio device, by using pipes.
  336.  
  337. Renaming and Cloning phonemes
  338. -----------------------------
  339.  
  340. It may happen that the language  processing module connected to MBROLA
  341. doesn't use the same phonemic alphabet as the voice used. The Renaming
  342. and  Cloning mechanisms   help you  to   quickly solve  such  problems
  343. (without adding extra  CPU  load). The  only  limitation about phoneme
  344. names is that they can't contain blank characters.
  345.  
  346. If, for instance, phoneme  "a" in the mbrola voice  you use  is called
  347. "my_a"  in your alphabet,  and phoneme "b" is  called "my_b", then the
  348. following command solves the problem:
  349.  
  350. mbrola -R "a my_a   b my_b" fr1/fr1 test.pho test.wav
  351.  
  352. You can give as  many renaming pairs as  you want. Circular definition
  353. are  not a problem -> "a b  b c" will rename original [a] into [b] and
  354. original [b] into [c] independantly ([a] won't be renamed to [c]).
  355.  
  356. LIMITATION: you    can't rename a phoneme    into another that already
  357. exists.
  358.  
  359. The cloning  mechanism does  exactly the same  thing,  though the  old
  360. phoneme  still exists  after renaming. This  is usefull if  you have 2
  361. allophones in your alphabet, but the Mbrola voice only provides one.
  362.  
  363. Imagine  for  instance, that  you  make  the disctinction  between the
  364. voiced [r] and its unvoiced counterpart [r0] and that  you are using a
  365. syllabic version [r=]. If as a first approximation  using [r] for both
  366. is OK, then you may use an Mbrola voice that only provides one version
  367. of [r] by running:
  368.  
  369. mbrola -C "r r0  r r=" fr1/fr1 test.pho test.wav
  370.  
  371. which   tells  the synthesizer  that   [r0]  and [r=]   should be both
  372. synthesized as [r].  You  can write a  long  cloning list of   phoneme
  373. pairs to fit your needs. 
  374.  
  375. Renaming  and cloning eats CPU since  the  complete diphone hash table
  376. has to be rebuilt, but once the renaming or cloning has occurred there
  377. is  absolutely NO  RELATED  PERFORMANCE DROP.  So  using this  feature
  378. is more efficient   than  a  pre-processor, though   incompatibilities
  379. cannot always be solved by a simple phoneme mapping.
  380.  
  381. Before renaming anything as #, check paragraph 5.4
  382.  
  383. When you  have long cloning and  renaming lists, you  can conveniently
  384. write them into  an  initialization file  according to the   following 
  385. format:
  386.  
  387. RENAME a my_a
  388. RENAME b my_b
  389. CLONE  r r0
  390. CLONE  r r=
  391.  
  392. The obsolete ";; RENAME  a my_a" can't be  used in .pho file  anymore,
  393. but is correctly parsed in initialization files. 
  394.  
  395. Note to Festival and EN1 users: the consequence of the change above is
  396. that you must change the previous call format "mbrola en1 en1mrpa ..."  
  397. into "mbrola -I en1mrpa en1 ...".
  398.  
  399.  
  400. BELOW ARE A NUMBER OF MACHINE DEPENDANT HINTS FOR BEST USING MBROLA
  401.  
  402. On MSDOS/Windows or OS/2
  403. ------------------------
  404.  
  405. Type: mbrola fr1/fr1 TEST/bonjour.pho bonjour.wav
  406.  
  407. Then you can play the RIFF Wav file with windows sound utility On OS/2
  408. pipes may be used just like below.
  409.  
  410. REMARK: MbrolaTools provide an excellent DLL  and graphical pho player
  411. called Mbroli. We  advise you to  use them  instead of mbrola.exe  for
  412. Windows.
  413.  
  414. On modern Unix systems such as Solaris or HPUX or Linux
  415. -------------------------------------------------------
  416.  
  417. mbrola fr1/fr1 TEST/bonjour.pho -.au | audioplay
  418.  
  419. where  audioplay is your audio  file player (*  the name vary with the
  420. platform, e.g. splayer for HPUX *)
  421.  
  422. If  your audioplayer  has problems with sun .AU  files, try  with .raw
  423. Never use .wav format when you pipe the ouput (mbrola can't rewind the 
  424. file to write   the audio  size in   the header). Wav   format was not
  425. developped for Unix (on the contrary Au format let  you specify in the
  426. header "we're on a pipe, read until end of file").
  427.  
  428. NOTE FOR LINUX: you can use the GPL rawplay program provided at
  429.       ftp://tcts.fpms.ac.be/pub/mbrola/pclinux/
  430.  
  431. On Sun4 or with machines with an  old audio interface
  432. -----------------------------------------------------
  433.  
  434. Those machines are   now quite  old and  only   provide a mulaw   8Khz
  435. output. A hack is:
  436.  
  437. mbrola fr1/fr1 input.pho - | sox -t raw  -sw -r 16000  - -t raw -Ub -r 8000 - > /dev/audio
  438.  
  439. (providing you have the public domain sox utility developed by Ircam).
  440. You should  hear  'bonjour' without the   need  to create intermediate
  441. files. Note  that we strongly recommend  that you DON'T use SOX, since
  442. its resampling  method (linear interpolation) will  permanently damage
  443. the sound.
  444.  
  445. Other   solution:  The UTILITY.ZIP  file   available  from the  MBROLA
  446. homepage provides RAW2SUN which does this conversion.
  447.  
  448. On VAX or AXP workstations
  449. --------------------------
  450.  
  451. To  make it  easier for   users to find   MBROLA,  you should add  the
  452. following command to your system startup procedure:
  453.  
  454. $ DEFINE/SYSTEM/EXEC MBROLA_DIR disk:[dir]
  455.  
  456. where "disk:[dir]"  is the name  of the directory  you created for the
  457. MBROLA_DIR files.  You could also  add  the following command to  your
  458. system login command procedure:
  459.  
  460. $ MBROLA :== $MBROLA_DIR:MBROLA.EXE
  461. $ RAW2SUN :== $MBROLA_DIR:RAW2SUN.EXE
  462.  
  463. to use the decsound device:
  464.  
  465. $ MCR DECSOUND - volume 40 -play sound.au 
  466.  
  467. See also the MBR_OLA.COM batch file in  the UTILITY.ZIP file available
  468. from the MBROLA  Homepage if you cannot   play 16 bits sound files  on
  469. your machine.
  470.  
  471. --------------------------------------------------------------
  472. 5.0 Format of input and output files - Limitations
  473. --------------------------------------------------------------
  474.  
  475. 5.1 Phoneme commands
  476. --------------------
  477.  
  478. The input file bonjour.pho in the above example simply contains :
  479.  
  480. ; bonjour 
  481. _ 51 25 114
  482. b 62 
  483. o~ 127 48 170.42 
  484. Z 110 53.5 116 
  485. u 211 
  486. R 150 50 91 
  487. _ 91
  488.  
  489. This shows the format of the input data  required by MBROLA. Each line
  490. contains  a phoneme name, a duration  (in ms),  and a series (possibly
  491. none)  of pitch  targets  composed of  two   float numbers each  : the
  492. position  of  the  pitch target   within   the phoneme  (in  %  of its
  493. total duration), and the pitch value (in Hz) at this position.
  494.  
  495. In order to increase readability, it is also possible to enclose pitch
  496. target  in parentheses. Hence, the   first  line of bonjour.pho  could
  497. be written :
  498.  
  499. _ 51 (25,114)
  500.  
  501. it tells the synthesizer to produce a  silence of 51  ms, and to put a
  502. pitch target of  114  Hz at 25%  of  51  ms.  Pitch targets  define  a
  503. piecewise linear  pitch curve.  Notice  that the intonation curve they
  504. define  is continuous,  since  the  program automatically drops  pitch
  505. information when synthesizing unvoiced phones.
  506.  
  507. The  data on each  line  is  separated  by  blank characters or  tabs.
  508. Comments can optionally be introduced  in command files, starting with
  509. a  semi-colon ';'.  This default  can be  overrun  with the -c  option 
  510. of the command line.
  511.  
  512. Another  special  escape sequence ';;'   allows  the user to introduce
  513. commands in the middle of  .pho files as  described below. This escape 
  514. sequence is also affected by the -c option.
  515.  
  516. 5.2 Changing the Freq Ratio or Time Ratio
  517. -----------------------------------------
  518.  
  519. A command escape  sequence containing a  line like "T=xx" modifies the
  520. time  ratio to  xx,  the same result   is obtained on the  fundamental
  521. frequency by replacing T with F, like in:
  522.  
  523. ;; T = 1.2
  524. ;;F=0.8
  525.  
  526.  
  527. 5.3 Flush the output stream
  528. ---------------------------
  529.  
  530. Note, finally, that the synthesizer outputs chunks of synthetic speech
  531. determined as   sections of the piecewise   linear pitch curve. Phones
  532. inside a section of  this curve are synthesized  in one go.  The  last
  533. phone of each chunk, however, cannot be properly synthesized while the
  534. next phone is   not known (since the program   uses diphones  as  base
  535. speech   units). When  using    mbrola  with pipes,    this  may be  a
  536. problem. Imagine,  for instance,  that  mbrola is  used to   create  a
  537. pipe-based speaking clock on an HP:
  538.  
  539. speaking_clock | mbrola - -.au | splayer
  540.  
  541. which tells the time,  say, every 30 seconds.  The  last phone of each
  542. time announcement will only be synthesized  when the next announcement
  543. starts.    To bypass this problem,   mbrola accepts  a special command
  544. phone, which flushes the synthesis buffer : "#"
  545.  
  546. This default character can be replaced by another symbol thanks to the
  547. command:
  548.  
  549. ;; FLUSH new_flush_symbol
  550.  
  551. Another important issue with piping under  UNIX, is the possibility to
  552. prematurely end the audio output, if  for example the user presses the
  553. stop button   of  your application. Since release 3.01, Mbrola handles
  554. signals.
  555.  
  556. If in the  previous example the user wants  to  interrupt the speaking
  557. clock message, the application just needs to send the USR1 signal. You
  558. can send such a signal from the console with:
  559.  
  560.      kill -SIGUSR1 mbrola_process_number
  561.  
  562. Once mbrola catches  the signal,  it reads its  input stream  until it
  563. gets EOF or a FLUSH command (hence, surrounding sections with flush is
  564. a good habit).
  565.  
  566. Limitations of the program
  567. --------------------------
  568.  
  569. Phones can be synthesized with  a maximum duration which depends on
  570. the fundamental frequency with which they are produced. The higher the
  571. frequency, the lower  the duration.  For a  frequency  of 133  Hz, the
  572. maximum duration is 7.5 sec. For a frequency of 66.5 Hz, it is 15 sec.
  573. For a frequency of 266 Hz, it is 3.75 sec.
  574.  
  575. --------------------------------------------------------------
  576. 6.0 Joining the MBROLA project as a user 
  577. --------------------------------------------------------------
  578.  
  579. For convenience, we have defined two mailing lists :
  580.  
  581. * mbrola-interest@tcts.fpms.ac.be :  a forum for  MBROLA questions and
  582. issues. It is   used  by the   maintainers of  the mbrola  project  to
  583. announce new releases, bug fixes,  new voices and languages, and other
  584. information of interest to all MBROLA  users.  Users who want to share
  585. .pho files  or free applications running on  top of mbrola should send
  586. mail to mbrola-interest.
  587.  
  588. It  is your interest, as a  user,  to subscribe to the mbrola-interest
  589. mailing list, by sending an e-mail to :
  590.  
  591.           mbrola-interest-request@tcts.fpms.ac.be
  592.  
  593. with the word  'subscribe' in either the header  or the main  text. To
  594. unsubscribe, just send another mail with 'unsubscribe'.
  595.  
  596. BUGS
  597. ----
  598.  
  599. If you detect a bug, or if you find an input  for which the quality of
  600. the speech provided by mbrola is  not as good  as usual, first consult
  601. the  FAQ  file  from  the  MBROLA Project  homepage,   which will   be
  602. frequently updated.
  603.  
  604. If this is  of no help, send  a kind mail to mbrola@tcts.fpms.ac.be in
  605. which you include  the .pho file with  which  the problem  appears and
  606. mention your machine architecture.
  607.  
  608. NEW DATABASES
  609. -------------
  610.  
  611. If you want   to participate to  the  mbrola  project by  providing  a
  612. diphone database (i.e. a set of sample files  with one example of each
  613. diphone in your  language), refer to the mbrola  WWW homepage, or send
  614. an email to: mbrola@tcts.fpms.ac.be.
  615.  
  616. APPLICATIONS
  617. ------------
  618.  
  619. If  you have used mbrola   to build speaking apps  on  top of it (like
  620. talking  clocks,  talking    agendas, talking  tools   for handicapped
  621. persons, etc., and  want to  make it  available to  the community (for
  622. free, of course, and for non-commercial, non-military applications, as
  623. imposed by the mbrola license agreement), just make an announcement to
  624. the mbrola mailing list:
  625.  
  626.           mbrola-interest@tcts.fpms.ac.be. 
  627.  
  628. COMMERCIAL VERSION
  629. ------------------
  630.  
  631. If you are interested in the commercial version of mbrola (source code
  632. available), send an email to: mbrola@tcts.fpms.ac.be 
  633.  
  634. FEEDBACK
  635. --------
  636.  
  637. If you simply find  this initiative useful, please drop  us a note  at
  638. mbrola@tcts.fpms.ac.be. We have spent a lot of our time to provide you
  639. with this program, and we would like to get some feedback in return.
  640.  
  641. Don't forget, either, to mention the MBROLA reference paper :
  642.  
  643. T. DUTOIT, V. PAGEL, N. PIERRET, F. BATAILLE, O. VAN DER VRECKEN
  644. "The MBROLA Project: Towards a Set of High-Quality Speech
  645. Synthesizers Free of Use for Non-Commercial Purposes" 
  646. Proc. ICSLP 96, Philadelphia, vol. 3, pp. 1393-1396
  647.  
  648. or,  for  a more  general reference  to  Text-To-Speech synthesis, the
  649. book:
  650.  
  651. An Introduction to Text-To-Speech Synthesis,
  652. T. DUTOIT, Kluwer Academic Publishers, Dordrecht 
  653. Hardbound, ISBN 0-7923-4498-7
  654. April 1997, 312 pp. 
  655.  
  656. in any scientific publication referring to work for which this program
  657. has been used.
  658.  
  659. --------------------------------------------------------------
  660. 7.0 Joining the MBROLA project as a database provider
  661. --------------------------------------------------------------
  662.  
  663. One of the biggest interests of the MBROLA project (and definitely its
  664. most  original aspect) lies in its  ability to provide an ever growing
  665. set of languages/voices to users.
  666.  
  667. To achieve this goal, the MBROLA project has  itself been organized so
  668. as to incite  other research labs  or companies to share their diphone
  669. databases.
  670.  
  671. The terms of this sharing policy can be summarized as follows :
  672.  
  673. 1. We shall only  use your database to  adapt it to the mbrola format,
  674. and destroy the copy when this is done.
  675.  
  676. 2.   The resulting mbrola diphone  database will  be copyright Faculte
  677. Polytechnique de Mons.  Non-commercial   use  of the database in   the
  678. framework of  the MBROLA project    will be automatically  granted  to
  679. Internet users. In return, we shall send you a license agreement which
  680. will  transfer  all our  commercial  rights on  the  database  to you,
  681. provided the database is used with and only with the MBROLA program.
  682.  
  683. 3. All these  details will be fixed by  some official agreement before
  684. you send us anything.
  685.  
  686. If you want to create a database from scratch
  687. ---------------------------------------------
  688.  
  689. First, you should be aware that recording a  diphone database is not a
  690. trivial operation. If it is not performed carefully, the result can be
  691. deceiving. FR1, for  instance, required about  one month of  work, yet
  692. with the help of some efficient laboratory  tools for signal recording
  693. and  editing.  What is more,  some  phonetic knowledge of the targeted
  694. language is necessary to create the initial corpus.
  695.  
  696. So if you just  think of designing a new  diphone database as a  game,
  697. forget it.
  698.  
  699. If, on the contrary, you are willing to spend some time to provide the
  700. MBROLA community with a new language or voice, or  if you already have
  701. a diphone database and wish to share it  in mbrola format (and receive
  702. in return the rights  for  any commercial  exploitation of the  mbrola
  703. diphone database we will create for you), welcome here.
  704.  
  705. If you want to build a new diphone database, please contact the author
  706. first.  He will help   you as much  as  he can, by providing  phonetic
  707. information if available for instance.
  708.  
  709. In all cases, make a first dummy  trial : create  a small corpus for a
  710. few diphones, record them, segment them, equalize them if you can, and
  711. send the result directly to the author.  He will  test your data, tell
  712. you how good it is, and what should be done to make it better.
  713.  
  714. If you want to share an existing database 
  715. -----------------------------------------
  716.  
  717. contact the authors (see below).
  718.  
  719. --------------------------------------------------------------
  720. 8.0 Acknowledgments
  721. --------------------------------------------------------------
  722.  
  723. I  would like to thank   Vincent Pagel (Mons  / BE)  for his intensive
  724. programming, testing, and debugging of this program, and for all sorts
  725. of fruitful discussions. Vincent  also wrote MBRDICO a general purpose
  726. trainable phonetizer. Not to  forget  Nicolas Pierret and Olivier  Van
  727. der Vreken, for their contribution to the Mbrola coder.
  728.  
  729. Then let's greet  our  pioneer database  providers: 
  730.      Alejandro Barbosa  (MX1),
  731.       Aggelos Bletsas    (GR1), 
  732.       Marian Boldea        (RO1), 
  733.       G÷sta Bruce            (SW1), 
  734.       Alistair Conkie       (EN1 ES1), 
  735.       Denis Costa            (BR1), 
  736.       Arthur Dirksen        (NL1 NL2), 
  737.       Thierry Dutoit        (FR1), 
  738.       CΘline EgΘa            (FR2), 
  739.       Fred Englert           (DE1 DE2), 
  740.       Nikolaj Lazic        (CR1),
  741.       Mike Macon         (US3 MX1),
  742.       Einar Meister        (EE1), 
  743.       Yann-Ber Messager  (BZ1), 
  744.       Vincent Pagel        (FR3 FR4), 
  745.       Marcus Philipson    (SW1), 
  746.       George Sergiadis    (GR1), 
  747.       Nawfal Tounsi        (AR1), 
  748.       Raymond Veldhuis    (NL3), 
  749.       Gordon Tischer        (ES2),
  750.      Johan Wouters      (US3)
  751.       and the team at University Autonoma of Barcelona (ES1)!
  752.  
  753. May they be thanked for their work.
  754.  
  755. Sam  Przyswa (NEXT  Paris/FR),  Fred Englert (IBMRS600  Frankfurt/DE),
  756. Arnaud   Gaudinat (VAX-VMS    University   of  Geneva,  CH),   Cyrille
  757. Mastchenko (BeOS  Montreal/CA), Michael C.  Thornburgh (SCO-Unix USA),
  758. Bruno  Langlois (Java   port  Quebec/CA), Christophe M.   Vallat  (OS2
  759. Domerat/FR),   Cristiano Verondini  (Mac  Bologna/Italy), Gerald Kerma
  760. (Mac  G'K2  Vaugrigneuse/FR),  David  Woodman (SUN4 Berkshire/England)
  761. Gary Thomas   (Linux-PPC Grenoble/France), Thomas Fletcher (QNX-OS CA),
  762. Philippe Devallois (Mac DLL) and Thomas Agopian (BeOs) for their help
  763. in the compilation of MBROLA on many platforms.
  764.  
  765. Arnaud  Gaudinat (Lausanne/CH),  Thierry Gartiser (Nancy/France), Alec
  766. Epting  (Summer    Institure of  Linguistics/USA),   Michael  M. Cohen
  767. (University of California - Santa  Cruz), and Patrick Bouffer (France)
  768. have arranged mirror sites.
  769.  
  770. David Haubensack  has written a French  TTS in PERL, Stephen Isard and
  771. Alistair Conkie  have  provided the Freespeech  British  English TTS!! 
  772. Alan Black and Paul Taylor have supported  the Mbrola Project in their
  773. great Festival multilingual TTS Project. 
  774.  
  775. Fabrice Malfrere (Mons/BE)   who  has developped an  efficient  speech
  776. alignment program for Windows (distributed on the mbrola site).
  777.  
  778. Alain Ruelle  (Mons/BE) who  has developped the  MBRPlay  dll and  the 
  779. Mbroli interactive pho file player for Windows.
  780.  
  781. Nawfal Tounsi(Mons/BE) who has developped the W project aimed at
  782. helping disable people talk with the help of Mbrola. 
  783.  
  784. Last but not  least, I am  also greatly indebted to Francois  Bataille
  785. (Mons/BE) for having supported the creation of this internet project.
  786.  
  787. --------------------------------------------------------------
  788. 9.0 Contacting the author
  789. --------------------------------------------------------------
  790.  
  791. Dr Thierry Dutoit
  792.  
  793. Faculte Polytechnique de Mons, TCTS Lab,
  794. 31, bvd Dolez, B-7000 Mons, Belgium. 
  795. tel : /32/65/374133
  796. fax : /32/65/374129
  797. e-mail: mbrola@tcts.fpms.ac.be, for general information, 
  798. questions on the installation of software and databases.
  799.