From e39d9af8826edd40ebeb50157040fed2c316b07f Mon Sep 17 00:00:00 2001
From: Marianne Arnold <pixelma@rockbox.org>
Date: Sat, 17 Jul 2010 16:49:31 +0000
Subject: Manual: add another possible parameter to screenshot names:
 'seriesimg' to be able to use screenshots for manuals of the same series
 (e.g. all Clips) which need to be different to other targets with the same
 resolution, keeping the possibility to differentiate between targets (e.g.
 the Clip+ and the rest).

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27470 a1c6a512-1295-4272-9138-f99709370657
---
 manual/preamble.tex | 25 ++++++++++++++++++-------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/manual/preamble.tex b/manual/preamble.tex
index 90aa303528..1027a99b36 100644
--- a/manual/preamble.tex
+++ b/manual/preamble.tex
@@ -150,22 +150,33 @@
 % we want them.
 % Note: use this only for screenshots!
 % Note: leave caption empty to supress it.
+% Resulting file names in the source should consist of up to 3 parts
+% "filename-\genericimg-[\specimg|\seriesimg]"  (the third is optional)
+% filename is specified by the use of this macro in the tex file
+% \genericimg will be generated using the display's resolution (see above)
+% \specimg or \seriesimg are possible options set in the platform files
+% Files will be used in the following order: 1.filename contains \specimg part
+% 2. filename contains \seriesimg part, 3. filename without the third part
 \newcommand{\screenshot}[3]{
   \begin{figure}[H]
     \begin{center}
       \IfFileExists{#1-\genericimg-\specimg.png}
         {\includegraphics[width=\screenshotsize]{#1-\genericimg-\specimg.png}
          \typeout{Note: device specific image used}}
-        {\IfFileExists{#1-\genericimg.png}
-          {\includegraphics[width=\screenshotsize]{#1-\genericimg.png}}
-          {\IfFileExists{#1}
-            {\includegraphics[width=\screenshotsize]{#1}
-             \typeout{Warning: deprecated plain image name used}}%
-            {\typeout{Missing image: #1 (\genericimg) (\specimg)}%
-             \color{red}{\textbf{WARNING!} Image not found}%
+        {\IfFileExists{#1-\genericimg-\seriesimg.png}
+          {\includegraphics[width=\screenshotsize]{#1-\genericimg-\seriesimg.png}
+           \typeout{Note: series specific image used}}
+          {\IfFileExists{#1-\genericimg.png}
+            {\includegraphics[width=\screenshotsize]{#1-\genericimg.png}}
+            {\IfFileExists{#1}
+              {\includegraphics[width=\screenshotsize]{#1}
+               \typeout{Warning: deprecated plain image name used}}%
+              {\typeout{Missing image: #1 (\genericimg) (\specimg)}%
+               \color{red}{\textbf{WARNING!} Image not found}%
             }
           }
         }
+      }
       \if\blank{#3}\else{\label{#3}}\fi\if\blank{#2}\else{%
         \caption{#2}}\fi
     \end{center}
-- 
cgit v1.2.3