rockbox/manual/configure_rockbox/bookmarking.tex
Alexander Levin 97365803d3 Get rid of unnecessary 'table' environment and the never used parameters for button maps (FS#11088)
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@26201 a1c6a512-1295-4272-9138-f99709370657
2010-05-20 17:38:38 +00:00

114 lines
4.5 KiB
TeX

% $Id$ %
\section{\label{ref:Bookmarkconfigactual}Bookmarking}
Bookmarks allow you to save your current position within a track so that
you can return to it at a later time. \opt{swcodec}{Bookmarks also store
rate, pitch and speed information from the \setting{Pitch Screen} (see
\reference{sec:pitchscreen}).} Bookmarks are saved on a per directory
basis or for individual (saved) playlists. You can store multiple bookmarks,
even for the same track. When there's already a bookmark for a directory or
playlist, new bookmarks are added before existing ones.
Bookmarks are stored next to the directory or playlist they reference, in a
file with the same name as the directory or playlist and a ``.bmark''
extension. To load a bookmark, select the bookmark file and then select
the bookmark to load. There are other ways to load a bookmarks mentioned
below.
\note{Bookmarking only works when tracks are launched from the file browser,
and does not work for tracks launched via the
database. In addition, they do not work with dynamic
playlists.}
\begin{description}
\item [Bookmark on Stop.]
This option controls whether Rockbox creates a bookmark playback is
stopped.
\begin{description}
\item[No.]
Do not create bookmarks.
\item[Yes.]
Always create bookmarks.
\item[Ask.]
Ask if a bookmark should be created.
\item[Yes -- Recent Only.]
Always create a bookmark, but only in the recent bookmarks list.
\item[Ask -- Recent Only.]
Ask if a bookmark should be created, but only add it to the recent
bookmarks list.
\end{description}
When either \setting{Yes -- Recent Only} or \setting{Ask -- Recent Only}
is selected, bookmarks are only created if the \setting{Maintain a List
of Recent Bookmarks} is enabled.
\note{The \setting{Resume} function remembers your position in the most
recently accessed track regardless of how the \setting{Bookmark on Stop}
option is set.}
\item [Load Last Bookmark.]
This option controls if Rockbox should automatically load a bookmark for
a file, when that file is played.
\begin{description}
\item[No]
Always start from the beginning of the track or playlist.
\item[Yes]
Automatically return to the position of the last bookmark. Start
from the beginning if there are no bookmarks.
\item[Ask]
Ask if playback should start from the beginning of the track or
from one of the bookmarks.
\end{description}
\item [Maintain a list of Recent Bookmarks.]
If this option is enabled, a list of the most recently created bookmarks
may be accessed through the \setting{Recent Bookmarks} option in the
\setting{Main Menu}. This list contains up to ten entries.
\begin{description}
\item[No]
Do not keep a list of recently used bookmarks. This also removes
the \setting{Recent Bookmarks} from the \setting{Main Menu}.
\item[Yes]
Keep a list of recently used bookmarks. Each new bookmark is added
to the list of recent bookmarks.
\item[Unique Only]
Add each new bookmark to the list of recently used bookmarks, but
only keep one bookmark from the current directory or playlist; any
previous entries are removed.
\end{description}
\end{description}
The following keys can be used to navigate in any bookmark list.
\begin{btnmap}
\ActionStdNext
\opt{HAVEREMOTEKEYMAP}{& \ActionRCStdNext}
& Selects the next bookmark.\\
%
\ActionStdPrev
\opt{HAVEREMOTEKEYMAP}{& \ActionRCStdPrev}
& Selects the previous bookmark.\\
%
\ActionStdOk
\opt{HAVEREMOTEKEYMAP}{& \ActionRCStdOk}
& Resumes from the selected bookmark.\\
%
\ActionStdCancel
\opt{HAVEREMOTEKEYMAP}{& \ActionRCStdCancel}
& Exits Recent Bookmark menu\\
%
\nopt{GIGABEAT_S_PAD}{\ActionBmDelete
\opt{HAVEREMOTEKEYMAP}{& \ActionRCBmDelete}
& Deletes the currently selected bookmark\\}
%
\ActionStdContext
\opt{HAVEREMOTEKEYMAP}{& \ActionRCStdContext}
& Enters the context menu for the selected bookmark.\\
\end{btnmap}
There are two options in the context menu:
\begin{itemize}
\item \setting{Resume} will commence playback of the currently selected bookmark entry.
\item \setting{Delete} will remove the currently selected bookmark entry from the list.
\end{itemize}