summaryrefslogtreecommitdiff
path: root/manual/configure_rockbox
diff options
context:
space:
mode:
Diffstat (limited to 'manual/configure_rockbox')
-rwxr-xr-xmanual/configure_rockbox/voice.tex65
1 files changed, 44 insertions, 21 deletions
diff --git a/manual/configure_rockbox/voice.tex b/manual/configure_rockbox/voice.tex
index 7fcc90c577..c1ff4243bc 100755
--- a/manual/configure_rockbox/voice.tex
+++ b/manual/configure_rockbox/voice.tex
@@ -1,32 +1,55 @@
1% $Id$ %
1\section{\label{ref:Voiceconfiguration}Voice} 2\section{\label{ref:Voiceconfiguration}Voice}
2 3
3 \begin{itemize} 4 \begin{description}
4 \item \textbf{Voice Menus:} 5 \item[Voice Menus.]
5 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 \textbf{/.rockbox/lang/} directory on the \dap. Voice files are large (1.5MB) and are not shipped with Rockbox by default. 6 This option turns on the Voice User Interface, which will read out menu
6 The voice file is the name of the language for which it is made, followed by the extension .voice. So for English, the file name would be \fname{english.voice}. 7 items and settings as they are selected by the cursor. In order for this
7 This option is on by default. It will do nothing unless the appropriate .voice file is installed in the correct place on the \dap. 8 to work, a voice file must be present in the \fname{/.rockbox/lang/}
9 directory on the \dap. Voice files are large (1.5MB) and are not
10 shipped with Rockbox by default.
11 The voice file is the name of the language for which it is made, followed
12 by the extension \fname{.voice}. So for English, the file name would be
13 \fname{english.voice}.
14 This option is on by default. It will do nothing unless the
15 appropriate voice file is installed in the correct place on the \dap.
8 The Voice Menus have several limitations: 16 The Voice Menus have several limitations:
9 \begin{itemize} 17 \begin{itemize}
10 \item Setting the Sound Option \textbf{Channels} to ``karaoke'' may disable voice menus. 18 \item Setting the Sound Option \setting{Channels} to \setting{Karaoke} may
19 disable voice menus.
11 \item Plugins and the wake up alarm do not support voice features. 20 \item Plugins and the wake up alarm do not support voice features.
12 \end{itemize} 21 \end{itemize}
13 22
14 \item \textbf{Voice Directories:} 23 \item[Voice Directories.]
15 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. 24 This option turns on the speaking of directory names. The \dap{}
16 \begin{itemize} 25 is not powerful enough to produce these voices in real time, so a number
17 \item \textbf{.talk mp3 clip: } 26 of options are available.
18 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 ``numbers'' option below. 27 \begin{description}
19 \item \textbf{Spell: } 28 \item[.talk mp3 clip.]
20 Speak the directory name by spelling it out letter by letter. Support is provided only for the most common letters and punctuation. 29 Use special pre-recorded MP3 files (\fname{\_dirname.talk}) in each
21 \item \textbf{Numbers: } 30 directory. These must be generated in advance, and are typically
22 Each directory is assigned a number based upon its position in the file list. They are then announced as ``Directory 1'', ``Directory 2'' etc. 31 produced synthetically using a text to speech engine on a PC.
23 \item \textbf{Off: } 32 If no such file exists, the output is as for the \setting{numbers}
33 option below.
34 \item[Spell.]
35 Speak the directory name by spelling it out letter by letter. Support
36 is provided only for the most common letters and punctuation.
37 \item[Numbers.]
38 Each directory is assigned a number based upon its position in the
39 file list. They are then announced as ``Directory 1'', ``Directory 2''
40 etc.
41 \item[Off.]
24 No attempt will be made to speak directory names. 42 No attempt will be made to speak directory names.
25 \end{itemize} 43 \end{description}
26 44
27 \item \textbf{Voice Filenames:} 45 \item[Voice Filenames.]
28 This option turns on the speaking of directory names. The options provided are ``Spell'', ``Numbers'', and ``Off'' which function the same as for \textbf{Voice Directories} and ``.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 \textbf{Punkadiddle.mp3.talk}). 46 This option turns on the speaking of directory names. The options provided
47 are \setting{Spell}, \setting{Numbers}, and \setting{Off} which function
48 the same as for \setting{Voice Directories} and \setting{.talk mp3 clip},
49 which functions as above except that the files are named with the same
50 name as the music file (e.g. \fname{Punkadiddle.mp3} would require a
51 file called \fname{Punkadiddle.mp3.talk}).
29 52
30 \end{itemize} 53 \end{description}
31 54
32See \url{http://www.rockbox.org/twiki/bin/view/Main/VoiceHowto} for more details on configuring speech support in Rockbox. 55See \wikilink{VoiceHowto} for more details on configuring speech support in Rockbox.