path: root/manual/appendix
diff options
Diffstat (limited to 'manual/appendix')
3 files changed, 77 insertions, 0 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}
+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.
+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:
+\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}
+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 @@
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}}.
@@ -255,6 +256,41 @@ with image ID ``M'', and then reference the individual sub-images in a condition
repect each of the players' limits.
+\section{Album art}
+ \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}
+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:
+ \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}