devs/foxbox
1
0
Fork 0
forked from len0rd/rockbox
Code Pull requests Activity

General code cleanup. Add a fixme note.

Browse source 
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@11170 a1c6a512-1295-4272-9138-f99709370657
This commit is contained in:
Martin Arver 2006-10-10 14:07:28 +00:00
parent 69b98bd16e
commit 59d278843c
1 changed files with 85 additions and 84 deletions
Download patch file Download diff file Expand all files Collapse all files

137
manual/working_with_playlists/main.tex
View file

@ -2,98 +2,104 @@
\label{ref:working_with_playlists} \label{ref:working_with_playlists}
\section{Introduction} \section{Introduction}
\fixme{This chapter is currently in a half written state, with possible errors.
Please help us fix this chapter by submitting additions/corrections to the tracker}
\section{Playlist terminology} \section{Playlist terminology}
Here are some common terms that are used in Rockbox when referring to playlists: Here are some common terms that are used in Rockbox when referring to
playlists:
\begin{description} \begin{description}
\item[Directory:] A playlist! One of the keys to getting the most out of \item[Directory.] A playlist! One of the keys to getting the most out of
Rockbox is understanding that Rockbox \emph{always} considers the song that it Rockbox is understanding that Rockbox \emph{always} considers the song that
is playing to be part of a playlist, and in some situations, Rockbox will it is playing to be part of a playlist, and in some situations, Rockbox will
create a playlist automatically. For example, if you are playing the contents create a playlist automatically. For example, if you are playing the
of a directory, Rockbox will automatically create a playlist containing the contents of a directory, Rockbox will automatically create a playlist
songs in that directory. This means that just about anything that is containing the songs in that directory. This means that just about anything
described in this chapter with respect to playlists also applies to that is described in this chapter with respect to playlists also applies to
directories. directories.
\item[Dynamic playlist:] A dynamic playlist is a playlist that is created \item[Dynamic playlist.] A dynamic playlist is a playlist that is created
``On the fly.'' Any time you insert or queue tracks using the ``On the fly.'' Any time you insert or queue tracks using the
\setting{Playlist submenu} (see \reference:{playlist_submenu}), you are creating (or adding \setting{Playlist submenu} (see \reference:{playlist_submenu}), you are
to) a dynamic playlist. creating (or adding to) a dynamic playlist.
\item[Insert:] In Rockbox, to \setting{Insert} an item into a playlist means \item[Insert.] In Rockbox, to \setting{Insert} an item into a playlist means
putting an item into a playlist and leaving it there, even after it is played. putting an item into a playlist and leaving it there, even after it is
As you will see later in this chapter, Rockbox can \setting{Insert} into a played. As you will see later in this chapter, Rockbox can \setting{Insert}
playlist in several places. into a playlist in several places.
\item[Queue:] In Rockbox, to \setting{Queue} a song means to put the song \item[Queue.] In Rockbox, to \setting{Queue} a song means to put the song
into a playlist and then to remove the song from the playlist once it has been into a playlist and then to remove the song from the playlist once it has
played. The only difference between \setting{Insert} and \setting{Queue} is been played. The only difference between \setting{Insert} and
that the \setting{Queue} option removes the song from the playlist once it has \setting{Queue} is that the \setting{Queue} option removes the song from the
been played, and the \setting{Insert} option does not. playlist once it has been played, and the \setting{Insert} option does not.
\end{description}
\section{Creating playlists} \section{Creating playlists}
Rockbox can create playlists in four different ways. Rockbox can create playlists in four different ways.
\subsection{Creating playlists by playing a song} \subsection{Creating playlists by playing a song}
Whenever a song is selected from the \setting{File Browser} using the Whenever a song is selected from the \setting{File Browser} using the
\ButtonSelect\ button, Rockbox will automatically create a playlist containing \ButtonSelect{} button, Rockbox will automatically create a playlist
all of the songs in the directory in which that song is located. containing all of the songs in the directory in which that song is located.
\note{If you already have already created a dynamic playlist, playing a new \note{If you already have already created a dynamic playlist, playing a new
song will \emph{erase} the current playlist and create a new one. If you want song will \emph{erase} the current playlist and create a new one. If you
to add a song to the current playlist rather than erasing the current want to add a song to the current playlist rather than erasing the current
playlist, see the section below on ``Adding music to playlists.'' playlist, see the section below on ``Adding music to playlists.''}
\subsection{Creating a dynamic playlist using the Insert and Queue functions} \subsection{Creating a dynamic playlist using the Insert and Queue functions}
\subsection{Creating a playlist using the Playlist Catalog} \subsection{Creating a playlist using the Playlist Catalog}
\subsection{Creating a playlist from the Main Menu} \subsection{Creating a playlist from the Main Menu}
\section{Adding music to playlists} \section{Adding music to playlists}
\subsection{\label{ref:Playlistsubmenu}Adding music to a dynamic playlist} \subsection{\label{ref:Playlistsubmenu}Adding music to a dynamic playlist}
\screenshot{rockbox_interface/images/ss-playlist-menu}{The Playlist Submenu}{} \screenshot{rockbox_interface/images/ss-playlist-menu}{The Playlist Submenu}{}
The \setting{Playlist Submenu} allows you to put tracks into a ``dynamic The \setting{Playlist Submenu} allows you to put tracks into a
playlist''. If there is no music currently playing, Rockbox will create a new ``dynamic playlist''. If there is no music currently playing, Rockbox will
dynamic playlist and put the selected track(s) into the playlist. If there is create a new dynamic playlist and put the selected track(s) into the
music currently playing, Rockbox will put the selected track(s) into the playlist. If there is music currently playing, Rockbox will put the
current playlist. The place in which the newly selected tracks are added to selected track(s) into the current playlist. The place in which the newly
the playlist is determined by the following options: selected tracks are added to the playlist is determined by the following
options:
\begin{description} \begin{description}
\item [Insert.] Add track(s) to playlist. If no other tracks have been
inserted then the selected track will be added immediately after current
playing track, otherwise they will be added to end of insertion list.
\item [Insert:] Add track(s) to playlist. If no other \item [Insert next.] Add track(s) immediately after current playing
tracks have been inserted then the selected track will be added immediately
after current playing track, otherwise they will be added to end of insertion
list.
\item [Insert next:] Add track(s) immediately after current playing
track, no matter what else has been inserted. track, no matter what else has been inserted.
\item [Insert last:] Add track(s) to end of playlist. \item [Insert last.] Add track(s) to end of playlist.
\item [Queue:] Queue is the same as Insert except queued tracks are deleted \item [Queue.] Queue is the same as Insert except queued tracks are
immediately from the playlist after they've been played. Also, queued tracks deleted immediately from the playlist after they've been played. Also,
are not saved to the playlist file (see \reference{ref:playlistoptions}). queued tracks are not saved to the playlist file (see
\reference{ref:playlistoptions}).
\item [Queue next:] Queue track(s) immediately after current playing track. \item [Queue next.] Queue track(s) immediately after current playing track.
\item [Queue last:] Queue track(s) at end of playlist. \end{description} \item [Queue last.] Queue track(s) at end of playlist.
\end{description}
The \setting{Playlist Submenu} can be used to add either single tracks or The \setting{Playlist Submenu} can be used to add either single tracks or
entire directories to a playlist. If the \setting{Playlist Submenu} is entire directories to a playlist. If the \setting{Playlist Submenu} is
invoked on a single track, it will put only that track into the playlist. invoked on a single track, it will put only that track into the playlist.
On the other hand, if the \setting{Playlist Submenu} is invoked on a On the other hand, if the \setting{Playlist Submenu} is invoked on a
directory, Rockbox adds all of the tracks in that directory to the playlist. directory, Rockbox adds all of the tracks in that directory to the
playlist.
Dynamic playlists are saved so resume will restore them exactly as they were before Dynamic playlists are saved so resume will restore them exactly as they
shutdown. were before shutdown.
\section{Saving playlists} \section{Saving playlists}
@ -101,16 +107,11 @@ shutdown.
\section{Helpful Hints} \section{Helpful Hints}
\subsection{Including subdirectories in playlists} \subsection{Including subdirectories in playlists}
You can control whether or not Rockbox includes the contents of subdirectories
when adding an entire directory to a playlists. Set the \setting{Main Menu
$\rightarrow$ Playlist Options $\rightarrow$ Recusively Insert Directories}
setting to \setting{Yes} if you would like Rockbox to include tracks in
subdirectories as well as tracks in the currently-selected directory.}
You can control whether or not Rockbox includes the contents of
subdirectories when adding an entire directory to a playlists.
Set the \setting{Main Menu $\rightarrow$ Playlist Options $\rightarrow$
Recusively Insert Directories} setting to \setting{Yes} if you would like
Rockbox to include tracks in subdirectories as well as tracks in the
currently selected directory.