mirror of
https://github.com/Rockbox/rockbox.git
synced 2025-12-09 05:05:20 -05:00
6cc8c40e6b
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@9688 a1c6a512-1295-4272-9138-f99709370657
61 lines
3.3 KiB
TeX
Executable file
61 lines
3.3 KiB
TeX
Executable file
\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. Bookmarks are saved on a per folder
|
|
basis. In other words, all of the files in the same folder have their
|
|
bookmarks stored together in the folder where the files are located. You
|
|
can store multiple bookmarks for the same track.
|
|
\begin{description}
|
|
\item [Bookmark on Stop: ]This option controls whether Rockbox writes a
|
|
bookmark to the disk when the STOP button is pressed.
|
|
\emph{No} turns automatic bookmarking completely off. In contrast
|
|
\emph{Yes} turns automatic bookmarking on while \emph{Ask} asks on stopping
|
|
the track if a bookmark should be created.
|
|
With the above options ``Yes'' and ``Ask'' if there is an existing
|
|
\fname{.bmark} file the current position information will be added to the
|
|
front of the existing list, up to the maximum number of allowed bookmarks
|
|
per file (currently 10). If no \fname{.bmark} file exists, one will be
|
|
created with the new bookmark information. Finally, if the ``Maintain
|
|
a list of Recently Used Bookmarks'' option is enabled, the bookmarking
|
|
information will be added to recent bookmarks list.
|
|
\begin{description}
|
|
\item[Yes -- Recent Only:]
|
|
Turns on automatic bookmarking - One bookmark only
|
|
\item[Ask -- Recent Only:]
|
|
Asks if a bookmark should be created when stopping track --
|
|
One bookmark only
|
|
\end{description}
|
|
With the two ``Recent Only'' options, nothing is written to the
|
|
\fname{.bmark} file. if the ``Maintain a list of Recently Used Bookmarks''
|
|
option is enabled, the bookmarking information will however be added to
|
|
recent bookmarks list.
|
|
\note{The \emph{Resume} function remembers your position in the most
|
|
recently accessed track regardless of how the \emph{Bookmark on Stop}
|
|
option is set.}
|
|
|
|
\item [Load Last Bookmark: ]
|
|
|
|
When the \emph{Load Last Bookmark} option is set to YES, Rockbox
|
|
automatically returns to the position of the last bookmark within a file
|
|
when that file is played.
|
|
|
|
When the \emph{Load Last Bookmark} option is set to ASK, Rockbox will
|
|
give the user the option of starting from the beginning of the track
|
|
of or from the bookmark.
|
|
|
|
When the \emph{Load Last Bookmark} option is set to NO, playback always
|
|
starts from the beginning of the track, and the user must play the bookmark
|
|
or use the \emph{Load Bookmark} function in the Main Menu, while the file
|
|
is playing, to resume at the bookmarked location.
|
|
|
|
\item [Maintain a list of Recently Used Bookmarks: ]
|
|
|
|
This list of Most Recent Bookmarks (MRB's) may be accessed through the
|
|
\emph{Recent Bookmarks} option of the \emph{Bookmarks} submenu of the
|
|
Main Menu. When set to \emph{Yes} each new bookmark will be added to the
|
|
MRB list. Setting this to \emph{No} disables the addition of bookmarks to
|
|
the MRB list. \emph{Unique Only} will remove an old bookmark for the current
|
|
track from the MRB list and replace it with the new one if a bookmark in the
|
|
MRB list already existed. Otherwise this will behave like the
|
|
\emph{Yes} setting.
|
|
\fixme{The above information was obtained by reading the source code, but my C is rather rusty...}
|
|
\end{description}
|