| % $Id$ % |
| \section{\label{ref:Voiceconfiguration}Voice} |
| |
| \begin{description} |
| \item[Voice Menus.] |
| This option turns on the Voice User Interface, which will read out menu |
| items and settings as they are selected by the cursor. In order for this |
| to work, a voice file must be present in the \fname{/.rockbox/langs/} |
| directory on the \dap. Voice files are large (1.5MB) and are not |
| shipped with Rockbox by default. |
| The voice file is the name of the language for which it is made, followed |
| by the extension \fname{.voice}. So for English, the file name would be |
| \fname{english.voice}. |
| This option is on by default. It will do nothing unless the |
| appropriate voice file is installed in the correct place on the \dap. |
| The Voice Menus have several limitations: |
| \begin{itemize} |
| \item Setting the Sound Option \setting{Channels} to \setting{Karaoke} may |
| disable voice menus. |
| \item Plugins \opt{CONFIG_RTC}{and the wake up alarm} do not support |
| voice features. |
| \end{itemize} |
| |
| \item[Voice Directories.] |
| This option turns on the speaking of directory names. The \dap{} |
| is not powerful enough to produce these voices in real time, so a number |
| of options are available. |
| \begin{description} |
| \item[.talk mp3 clip.] |
| Use special pre-recorded MP3 files (\fname{\_dirname.talk}) in each |
| directory. These must be generated in advance, and are typically |
| produced synthetically using a text to speech engine on a PC. |
| If no such file exists, the output is as for the \setting{numbers} |
| option below. |
| \item[Spell.] |
| Speak the directory name by spelling it out letter by letter. Support |
| is provided only for the most common letters and punctuation. |
| \item[Numbers.] |
| Each directory is assigned a number based upon its position in the |
| file list. They are then announced as ``Directory 1'', ``Directory 2'' |
| etc. |
| \item[Off.] |
| No attempt will be made to speak directory names. |
| \end{description} |
| |
| \item[Voice Filenames.] |
| This option turns on the speaking of filenames. The options provided |
| are \setting{Spell}, \setting{Numbers}, and \setting{Off} which function |
| the same as for \setting{Voice Directories} and \setting{.talk mp3 clip}, |
| which functions as above except that the files are named with the same |
| name as the music file (e.g. \fname{Punkadiddle.mp3} would require a |
| file called \fname{Punkadiddle.mp3.talk}). |
| |
| \end{description} |
| |
| See \wikilink{VoiceHowto} for more details on configuring speech support in Rockbox. |