manual/configure_rockbox/bookmarking.tex

   1 % $Id$ %
   2 \section{\label{ref:Bookmarkconfigactual}Bookmarking}
   3   Bookmarks allow you to save your current position within a track so that
   4   you can return to it at a later time. \opt{swcodec}{Bookmarks also store
   5   rate, pitch and speed information from the \setting{Pitch Screen} (see
   6   \reference{sec:pitchscreen}).} Bookmarks are saved on a per directory
   7   basis or for individual (saved) playlists. You can store multiple bookmarks,
   8   even for the same track. When there's already a bookmark for a directory or
   9   playlist, new bookmarks are added before existing ones.
  10
  11   Bookmarks are stored next to the directory or playlist they reference, in a
  12   file with the same name as the directory or playlist and a ``.bmark''
  13   extension. To load a bookmark, select the bookmark file and then select
  14   the bookmark to load. There are other ways to load a bookmarks mentioned
  15   below.
  16
  17   \note{Bookmarking only works when tracks are launched from the file browser,
  18         and does not work for tracks launched via the
  19         database. In addition, they do not work with dynamic
  20         playlists.}
  21
  22   \begin{description}
  23
  24   \item [Bookmark on Stop.]
  25     This option controls whether Rockbox creates a bookmark playback is
  26     stopped.
  27     \begin{description}
  28       \item[No.]
  29             Do not create bookmarks.
  30       \item[Yes.]
  31             Always create bookmarks.
  32       \item[Ask.]
  33             Ask if a bookmark should be created.
  34       \item[Yes -- Recent Only.]
  35             Always create a bookmark, but only in the recent bookmarks list.
  36       \item[Ask -- Recent Only.]
  37             Ask if a bookmark should be created, but only add it to the recent
  38             bookmarks list.
  39     \end{description}
  40     When either \setting{Yes -- Recent Only} or \setting{Ask -- Recent Only}
  41     is selected, bookmarks are only created if the \setting{Maintain a List
  42     of Recent Bookmarks} is enabled.
  43     \note{The \setting{Resume} function remembers your position in the most
  44       recently accessed track regardless of how the \setting{Bookmark on Stop}
  45       option is set.}
  46
  47   \item [Load Last Bookmark.]
  48     This option controls if Rockbox should automatically load a bookmark for
  49     a file, when that file is played.
  50
  51     \begin{description}
  52       \item[No]
  53             Always start from the beginning of the track or playlist.
  54       \item[Yes]
  55             Automatically return to the position of the last bookmark. Start
  56             from the beginning if there are no bookmarks.
  57       \item[Ask]
  58             Ask if playback should start from the beginning of the track or
  59             from one of the bookmarks.
  60     \end{description}
  61
  62   \item [Maintain a list of Recent Bookmarks.]
  63     If this option is enabled, a list of the most recently created bookmarks
  64     may be accessed through the \setting{Recent Bookmarks} option in the
  65     \setting{Main Menu}. This list contains up to ten entries.
  66
  67     \begin{description}
  68       \item[No]
  69             Do not keep a list of recently used bookmarks. This also removes
  70             the \setting{Recent Bookmarks} from the \setting{Main Menu}.
  71       \item[Yes]
  72             Keep a list of recently used bookmarks. Each new bookmark is added
  73             to the list of recent bookmarks.
  74       \item[Unique Only]
  75             Add each new bookmark to the list of recently used bookmarks, but
  76             only keep one bookmark from the current directory or playlist; any
  77             previous entries are removed.
  78     \end{description}
  79 \end{description}
  80
  81 The following keys can be used to navigate in any bookmark list.
  82   \begin{btnmap}
  83       \ActionStdNext
  84       \opt{HAVEREMOTEKEYMAP}{& \ActionRCStdNext}
  85       & Selects the next bookmark.\\
  86       %
  87       \ActionStdPrev
  88       \opt{HAVEREMOTEKEYMAP}{& \ActionRCStdPrev}
  89       & Selects the previous bookmark.\\
  90       %
  91       \ActionStdOk
  92       \opt{HAVEREMOTEKEYMAP}{& \ActionRCStdOk}
  93       & Resumes from the selected bookmark.\\
  94       %
  95       \ActionStdCancel
  96       \opt{HAVEREMOTEKEYMAP}{& \ActionRCStdCancel}
  97       & Exits Recent Bookmark menu\\
  98       %
  99       \nopt{GIGABEAT_S_PAD}{\ActionBmDelete
 100       \opt{HAVEREMOTEKEYMAP}{& \ActionRCBmDelete}
 101       & Deletes the currently selected bookmark\\}
 102       %
 103       \ActionStdContext
 104       \opt{HAVEREMOTEKEYMAP}{& \ActionRCStdContext}
 105       & Enters the context menu for the selected bookmark.\\
 106   \end{btnmap}
 107
 108 There are two options in the context menu:
 109
 110 \begin{itemize}
 111   \item \setting{Resume} will commence playback of the currently selected bookmark entry.
 112   \item \setting{Delete} will remove the currently selected bookmark entry from the list.
 113 \end{itemize}
 114