From 410cbd1af7103cf9a19ca3f155647da5a34e4d05 Mon Sep 17 00:00:00 2001
From: Jonas Häggqvist <rasher@rasher.dk>
Date: Fri, 20 Feb 2009 18:37:57 +0000
Subject: Add an album art appendix to the manual. Add album art tags to the
 WPS tags appendix and remove the image tag section from the Player manual.

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@20067 a1c6a512-1295-4272-9138-f99709370657
---
 manual/appendix/album_art.tex | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 manual/appendix/album_art.tex

(limited to 'manual/appendix/album_art.tex')

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{}.
-- 
cgit v1.2.3

