manual/configure_rockbox/voice.tex

   1 % $Id$ %
   2 \section{\label{ref:Voiceconfiguration}Voice}
   3
   4   \begin{description}
   5   \item[Voice Menus.]
   6     This option controls the voicing of menus/settings as they are selected
   7     by the cursor. In order for this to work, a voice file must be present
   8     in the \fname{/.rockbox/langs/} directory on the \dap.  Voice files are large
   9     and are not shipped with Rockbox by default.
  10     The voice file is the name of the language for which it is made, followed
  11     by the extension \fname{.voice}.  So for English, the file name would be
  12     \fname{english.voice}.
  13     This option is on by default, but will do nothing unless the
  14     appropriate voice file is installed in the correct place on the \dap.
  15     The Voice Menus have several limitations:
  16     \begin{itemize}
  17     \item Setting the Sound Option \setting{Channels} to \setting{Karaoke} may
  18       disable voice menus.
  19     \item Plugins \opt{rtc}{and the wake up alarm} do not support
  20       voice features.
  21     \end{itemize}
  22
  23   \item[Voice Directories.]
  24     This option controls voicing of directory names. A voice file must be present
  25     for this to work. Several options are available.
  26     \begin{description}
  27     \item[Spell.]
  28       Speak the directory name by spelling it out letter by letter.  Support
  29       is provided only for the most common letters, numbers and punctuation.
  30     \item[Numbers.]
  31       Each directory is assigned a number based upon its position in the
  32       file list.  They are then announced as ``Directory 1'', ``Directory 2''
  33       etc.
  34     \item[Off.]
  35       No attempt will be made to speak directory names.
  36     \end{description}
  37     You can use pre-generated .talk clips to have  directory names spoken
  38     properly, but you must enable this explicitly (see below).
  39
  40   \item[Use Directory .talk Clips.]
  41     This option turns on the use of .talk clips for directories.
  42     \begin{description}
  43     \item[On.]
  44       Use special pre-recorded MP3 files (\fname{\_dirname.talk}) in each
  45       directory. These must be generated in advance, and are typically
  46       produced synthetically using a text-to-speech engine on a PC.
  47     \item[Off.]
  48       No checking is made for directory .talk clips; they are not used even if present.
  49       This can reduce disk activity.
  50     \end{description}
  51     Use of a .talk clip takes precedence over other directory name voicing. Otherwise
  52     (e.g. if a .talk clip is not available), voicing uses the method set under
  53     \setting{Voice Directories} above.
  54
  55   \item[Voice Filenames.]
  56     This option controls voicing of filenames. Again, a voice file must be present
  57     for this to work. The options provided are \setting{Spell}, \setting{Numbers},
  58     and \setting{Off} which function the same as for \setting{Voice Directories}.
  59     You can use pre-generated .talk clips to have filenames spoken properly, but
  60     you must enable this explicitly (see below).
  61
  62   \item[Use File .talk Clips.]
  63     This option turns on the use of .talk clips for files.
  64     \begin{description}
  65     \item[On.]
  66       Use special pre-recorded MP3 files for each file.
  67       This functions the same as for directories except that the .talk clip file
  68       must have the same name as the described file with an extra .talk extension
  69       (e.g. \fname{Punkadiddle.mp3} would require a file called \fname{Punkadiddle.mp3.talk}).
  70     \item[Off.]
  71       No checking is made for file .talk clips; they are not used even if present.
  72       This can reduce disk activity.
  73     \end{description}
  74     Use of a .talk clip takes precedence over other filename voicing. Otherwise
  75     (e.g. if  a .talk clip is not available), voicing uses the method set under
  76      \setting{Voice Filenames} above.
  77
  78   \item[Say File Type.]
  79     This option turns on voicing of file types when \setting{Voice Filenames}
  80     is set to \setting{Spell} or \setting{Numbers}.
  81     When \setting{Voice Directories} is set to \setting{Spell}, ``Directory''
  82     will be voiced after each spelled out directory.
  83
  84   \item[Announce Battery Level.]
  85     When this option is enabled the battery level is announced when it falls
  86     under 50\%, 30\% and 15\%.
  87
  88   \end{description}
  89
  90 See \wikilink{VoiceHowto} for more details on configuring speech support in Rockbox.