

Embedded commands
=================

  Embedded commands within the text start with a CTRL-A character (character code 01)
  and are of the form:
    <ctrl-A> {+ -} [number] command_letter

  eg.    60P   sets the pitch to value 60
         +5P   increases the pitch by 5
         -10P  decreases the pitch by 10
         P     resets the pitch to the default

  The command letters:
  A     Amplitude, range 0-99, default 50
  P     Pitch, range 0-99, default 50
  S     Speed, range 0-99, default 50
  E     Expression (pitch range), range 0-99, default 50
  R     Reverberation, range 0-99, default 0

  Voice
    V<voice>  changes to a new voice or language, eg. Ven-f  changes to "female" voice.

NOTE: I may change the syntax to put the command letter first (eg. P-10 )


Sound Icons
===========

As an alternative to speaking the names of punctuation characters, sounds may be played
instead.  To do this, add lines to the  espeak-data/config  file, eg.

   soundicon _%  /home/myuser/sounds/percent.wav
   soundicon _,  comma.wav

The punctuation character is preceded by an underscore character.  The WAV file can be
given either as an absolute path, or as a filename or relative path within the
espeak-data/soundicons directory.
