summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--manual/appendix/album_art.tex37
-rw-r--r--manual/appendix/appendix.tex4
-rw-r--r--manual/appendix/wps_tags.tex36
-rw-r--r--manual/plugins/pictureflow.tex2
4 files changed, 78 insertions, 1 deletions
diff --git a/manual/appendix/album_art.tex b/manual/appendix/album_art.tex
new file mode 100644
index 0000000000..dc6a778320
--- /dev/null
+++ b/manual/appendix/album_art.tex
@@ -0,0 +1,37 @@
+% $Id: wps_tags.tex 19361 2008-12-07 23:00:15Z bluebrother $ %
+\chapter{\label{ref:album_art}Album Art}
+\section{Introduction}
+
+Rockbox allows you to put the album art, or another image related to the music
+on your \dap to display it in the PictureFlow plugin\opt{albumart}{ or in the
+WPS}. For this feature to work, you must observe a few rules.
+
+\section{Limitations}
+
+Rockbox does not support album art embedded in your files' tags, and will
+instead look for a picture located in the filesystem. In addition to this, the
+pictures must be in the BMP format.
+
+\section{Where to put album art}
+
+The pictures can be named a number of different ways, and placed a number of
+different locations. You can have pictures specific to the file or the album
+or use a generic picture. You can place the picture in the same direcotry
+as the file, in the parent directory or in a fixed directory named
+\fname{/.rockbox/albumart/}. The order Rockbox uses when looking for a picture
+is as follows:
+
+\begin{enumerate}
+\item \fname{./filename.bmp}
+\item \fname{./albumtitle.bmp}
+\item \fname{./cover.bmp}
+\item \fname{/.rockbox/albumart/artist-albumtitle.bmp}
+\item \fname{../albumtitle.bmp}
+\item \fname{../cover.bmp}
+\end{enumerate}
+
+The following characters will be replaced with an underscore (\_) when looking
+for albumtitle.bmp or artist-albumtitle.bmp: \textbackslash{} / : \textless{}
+\textgreater{} ? * \textbar{}. Doublequotes will be replaced by single qutoes.
+See \wikilink{AlbumArt} in the wiki for more details and programs that will
+help you automate the process of putting album art on your \dap{}.
diff --git a/manual/appendix/appendix.tex b/manual/appendix/appendix.tex
index e8a6c839ab..b7ee15a372 100644
--- a/manual/appendix/appendix.tex
+++ b/manual/appendix/appendix.tex
@@ -5,6 +5,10 @@
\input{appendix/wps_tags.tex}
+\opt{swcodec}{\opt{tagcache}{
+\input{appendix/album_art.tex}
+}}
+
\input{appendix/config_file_options.tex}
\input{appendix/menu_structure.tex}
diff --git a/manual/appendix/wps_tags.tex b/manual/appendix/wps_tags.tex
index 2c505f90dc..487090c266 100644
--- a/manual/appendix/wps_tags.tex
+++ b/manual/appendix/wps_tags.tex
@@ -201,6 +201,7 @@ that, it will display the volume value.
Example: Can be used as a simple tag \config{\%St{\textbar}skip length{\textbar}} or with conditionals
\config{\%?St{\textbar}eq enabled{\textbar}{\textless}Equalizer is enabled{\textbar}Equalizer is disabled{\textgreater}}.
+\opt{lcd_bitmap}{
\section{Images}
\begin{table}
\begin{tagmap}{}{}
@@ -255,6 +256,41 @@ with image ID ``M'', and then reference the individual sub-images in a condition
repect each of the players' limits.
\end{itemize}
}
+}
+
+\opt{albumart}{
+\section{Album art}
+\begin{table}
+ \begin{tagmap}{}{}
+ \config{\%Cl{\textbar}x{\textbar}y{\textbar}[l{\textbar}c{\textbar}r]maxwidth{\textbar}[t{\textbar}c{\textbar}b]maxheight{\textbar}}
+ & Define the settings for albumart\\
+ & \config{x}: x coordinate\\
+ & \config{y}: y coordinate\\
+ & \config{maxwidth}: Maximum height.\\
+ & \config{maxheight}: Maximum width.\\
+ \config{\%C} & Display the album art as configured\\
+ \end{tagmap}
+\end{table}
+
+The picture will be rescaled, preserving aspect ratio to fit the given
+\config{maxwidth} and \config{maxheight}. If the aspect ratio doesn't match the
+configured values, the picture will be placed according to the flags to the
+\config{maxwidth} and \config{maxheight} parameters:
+\begin{itemize}
+ \item \config{maxwidth}:
+ \begin{description}
+ \item[\config{l}.] Align left
+ \item[\config{c}.] Align center (default)
+ \item[\config{r}.] Align right
+ \end{description}
+ \item \config{maxheight}:
+ \begin{description}
+ \item[\config{t}.] Align left
+ \item[\config{c}.] Align center (default)
+ \item[\config{b}.] Align right
+ \end{description}
+\end{itemize}
+}
\section{Alignment}
\begin{table}
diff --git a/manual/plugins/pictureflow.tex b/manual/plugins/pictureflow.tex
index 7d913068d2..056c5e89ad 100644
--- a/manual/plugins/pictureflow.tex
+++ b/manual/plugins/pictureflow.tex
@@ -4,7 +4,7 @@ PictureFlow is a plugin that provides a visualisation of your albums with
their associated cover art.
\subsubsection{Requirements}
-PictureFlow uses both the album art (see \wikilink{AlbumArt} in the wiki) and
+PictureFlow uses both the album art (see \reference{ref:album_art}) and
database (see \reference{ref:database}) features of Rockbox.
It is therefore important that these are working correctly before attempting
to use PictureFlow. In addition, there are some other points of which to be