rockbox/manual/configure_rockbox/voice.tex
Dominik Riebeling b38b85bd17 Adjust voice section to current style. Code policing.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@10032 a1c6a512-1295-4272-9138-f99709370657
2006-06-02 19:51:07 +00:00

55 lines
2.5 KiB
TeX
Executable file

% $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/lang/}
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 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 directory names. 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.