Nyaaori/rockbox
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Attempt to clarify the voice options.

Browse source 
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@13589 a1c6a512-1295-4272-9138-f99709370657
This commit is contained in:
Steve Bavin 2007-06-07 12:16:39 +00:00
parent 3823486a58
commit bb0b0829d4
1 changed files with 30 additions and 23 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

53
manual/configure_rockbox/voice.tex
View file

@ -3,15 +3,14 @@
\begin{description} \begin{description}
\item[Voice Menus.] \item[Voice Menus.]
This option turns on the Voice User Interface, which will read out menu This option conttols the voicing of menus/settings as they are selected
items and settings as they are selected by the cursor. In order for this by the cursor. In order for this to work, a voice file must be present
to work, a voice file must be present in the \fname{/.rockbox/langs/} in the \fname{/.rockbox/langs/} directory on the \dap. Voice files are large
directory on the \dap. Voice files are large (1.5MB) and are not and are not shipped with Rockbox by default.
shipped with Rockbox by default.
The voice file is the name of the language for which it is made, followed 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 by the extension \fname{.voice}. So for English, the file name would be
\fname{english.voice}. \fname{english.voice}.
This option is on by default. It will do nothing unless the This option is on by default, but will do nothing unless the
appropriate voice file is installed in the correct place on the \dap. appropriate voice file is installed in the correct place on the \dap.
The Voice Menus have several limitations: The Voice Menus have several limitations:
\begin{itemize} \begin{itemize}
@ -22,13 +21,12 @@
\end{itemize} \end{itemize}
\item[Voice Directories.] \item[Voice Directories.]
This option turns on the speaking of directory names. The \dap{} This option controls voicing of directory names. A voice file must be present
is not powerful enough to produce these voices in real time, so a number for this to work. Several options are available.
of options are available.
\begin{description} \begin{description}
\item[Spell.] \item[Spell.]
Speak the directory name by spelling it out letter by letter. Support Speak the directory name by spelling it out letter by letter. Support
is provided only for the most common letters and punctuation. is provided only for the most common letters, numbers and punctuation.
\item[Numbers.] \item[Numbers.]
Each directory is assigned a number based upon its position in the Each directory is assigned a number based upon its position in the
file list. They are then announced as ``Directory 1'', ``Directory 2'' file list. They are then announced as ``Directory 1'', ``Directory 2''
@ -36,35 +34,44 @@
\item[Off.] \item[Off.]
No attempt will be made to speak directory names. No attempt will be made to speak directory names.
\end{description} \end{description}
You can also use pre-generated .talk clips to have directory names spoken
properly, but you must enable this explicitly (see below).
\item[Use Directory .talk Clips.] \item[Use Directory .talk Clips.]
This option turns on the use of .talk clips for directories. .talk clips take This option turns on the use of .talk clips for directories. When .talk clips
precedence over the method set under \setting{Voice Directories} above. are used, they take precedence over the method set under \setting{Voice Directories}
above.
\begin{description} \begin{description}
\item[On.] \item[On.]
Use special pre-recorded MP3 files (\fname{\_dirname.talk}) in each Use special pre-recorded MP3 files (\fname{\_dirname.talk}) in each
directory. These must be generated in advance, and are typically directory. These must be generated in advance, and are typically
produced synthetically using a text to speech engine on a PC. produced synthetically using a text-to-speech engine on a PC.
\item[Off.] \item[Off.]
No checking is made for directory .talk clips; they are not used even if present. No checking is made for directory .talk clips; they are not used even if present.
This can reduce disk activity.
\end{description} \end{description}
\item[Voice Filenames.] \item[Voice Filenames.]
This option turns on the speaking of filenames. The options provided This option controls voicing of filenames. Again, a voice file must be present
are \setting{Spell}, \setting{Numbers}, and \setting{Off} which function for this to work. The options provided are \setting{Spell}, \setting{Numbers},
the same as for \setting{Voice Directories}. and \setting{Off} which function the same as for \setting{Voice Directories}.
You can also use .talk clips to have filenames spoken properly, but you must
enable this explicitly (see below).
\item[Use File .talk Clips.] \item[Use File .talk Clips.]
This option turns on the use of .talk clips for files. This option enables the use of .talk clips for files. When .talk clips are used,
they take precedence over the method set under \setting{Voice Filenames}
above.
\begin{description} \begin{description}
\item[On.] \item[On.]
Use special pre-recorded MP3 files (\fname{\_dirname.talk}) for each file. Use special pre-recorded MP3 files for each file.
This functions as above except that the files are named with the same This functions the same as for directories except that the .talk clip file
name as the music file (e.g. \fname{Punkadiddle.mp3} would require a must have the same name as the music file with an extra .talk extension
file called \fname{Punkadiddle.mp3.talk}). (e.g. \fname{Punkadiddle.mp3} would require a file called \fname{Punkadiddle.mp3.talk}).
\item[Off.] \item[Off.]
No checking is made for file .talk clips; they are not used even if present. No checking is made for file .talk clips; they are not used even if present.
This can reduce disk activity.
\end{description} \end{description}
\end{description} \end{description}