From e5b1a7d4237a9006b6c49c9c1c13b292ca4ecf7c Mon Sep 17 00:00:00 2001
From: Teruaki Kawashima <teru@rockbox.org>
Date: Sun, 21 Nov 2010 13:47:56 +0000
Subject: FS#6321: Universal Image Viewer This unifies jpeg viewer, png viewer,
 and bmp viewer to one plugin, image viewer, so that you can navigate through
 different image formats.

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@28626 a1c6a512-1295-4272-9138-f99709370657
---
 manual/plugins/imageviewer.tex | 142 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 142 insertions(+)
 create mode 100644 manual/plugins/imageviewer.tex

(limited to 'manual/plugins/imageviewer.tex')

diff --git a/manual/plugins/imageviewer.tex b/manual/plugins/imageviewer.tex
new file mode 100644
index 0000000000..28ef62e3a6
--- /dev/null
+++ b/manual/plugins/imageviewer.tex
@@ -0,0 +1,142 @@
+% $Id$ %
+\subsection{Image Viewer}
+This plugin opens image files from the \setting{File Browser} to display them\nopt{lcd_color}{ using Rockbox's greyscale library}. Supported formats are as follows.
+
+\begin{table}
+  \begin{rbtabular}{.60\textwidth}{llX}%
+      {\textbf{Format}& \textbf{File-extension(s)}}%
+      {}{}
+    BMP         & \fname{.bmp}                  \\
+    JPEG        & \fname{.jpg, .jpe, .jpeg}     \\
+    PNG         & \fname{.png}                  \\
+  \end{rbtabular}
+\end{table}
+
+\opt{large_plugin_buffer}{
+\par
+\note{
+When an audio file is playing the size of the image is limited as 
+the decoding process needs to share memory with audio tracks. To be able to
+view a bigger file you may need to stop playback.}
+}
+\nopt{large_plugin_buffer}{%
+\note{This plugin will cause playback to stop.}%
+}%
+
+\begin{btnmap}
+    \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD%
+      ,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD%
+      ,MROBE100_PAD,PBELL_VIBE500_PAD}
+      {\ButtonUp\ / \ButtonDown}%
+    \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonMenu\ / \ButtonPlay}%
+    \opt{IRIVER_H10_PAD}{\ButtonScrollUp\ / \ButtonScrollDown} %
+    \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD%
+      ,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD%
+      ,MROBE100_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IRIVER_H10_PAD,PBELL_VIBE500_PAD}
+      {/ \ButtonLeft\ / \ButtonRight}
+    \opt{touchscreen}{\TouchTopMiddle{} / \TouchBottomMiddle{}/ \TouchMidLeft{} / \TouchMidRight}
+       \opt{HAVEREMOTEKEYMAP}{& }
+    & Move around in zoomed in image\\
+    \opt{RECORDER_PAD}{\ButtonPlay}
+    \opt{ONDIO_PAD}{\ButtonMenu}
+    \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD%
+        ,SANSA_FUZE_PAD,SANSA_C200_PAD,MROBE100_PAD}{\ButtonSelect}
+    \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollFwd}
+    \opt{IRIVER_H10_PAD}{\ButtonPlay}
+    \opt{GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonVolUp}
+    \opt{PBELL_VIBE500_PAD}{\ButtonRec+\ButtonUp}
+    \opt{touchscreen}{\TouchTopRight}
+       \opt{HAVEREMOTEKEYMAP}{& }
+    & Zoom in\\
+    \opt{RECORDER_PAD}{\ButtonOn}
+    \opt{ONDIO_PAD}{\ButtonMenu+\ButtonDown}
+    \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode}
+    \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollBack}
+    \opt{IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD}{Long \ButtonSelect}
+    \opt{IRIVER_H10_PAD}{Long \ButtonPlay}
+    \opt{GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonVolDown}
+    \opt{MROBE100_PAD}{\ButtonPlay}
+    \opt{PBELL_VIBE500_PAD}{\ButtonRec+\ButtonDown}
+    \opt{touchscreen}{\TouchTopLeft}
+       \opt{HAVEREMOTEKEYMAP}{& }
+    & Zoom out\\
+    \opt{RECORDER_PAD}{\ButtonFThree}
+    \opt{ONDIO_PAD}{\ButtonMenu+\ButtonRight}
+    \opt{IRIVER_H100_PAD}{\ButtonOn}
+    \opt{IRIVER_H300_PAD}{\ButtonRec}
+    \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonRight}
+    \opt{IAUDIO_X5_PAD}{\ButtonPlay}
+    \opt{IRIVER_H10_PAD}{\ButtonFF}
+    \opt{SANSA_E200_PAD,SANSA_FUZE_PAD}{\ButtonScrollFwd}
+    \opt{SANSA_C200_PAD}{\ButtonVolUp}
+    \opt{GIGABEAT_PAD}{\ButtonA+\ButtonRight}
+    \opt{GIGABEAT_S_PAD}{\ButtonNext}
+    \opt{MROBE100_PAD}{\ButtonDisplay+\ButtonRight}
+    \opt{PBELL_VIBE500_PAD}{\ButtonRec+\ButtonRight}
+    \opt{touchscreen}{\TouchBottomRight}
+       \opt{HAVEREMOTEKEYMAP}{& }
+    & Next image in directory\\
+    \opt{RECORDER_PAD}{\ButtonFTwo}
+    \opt{ONDIO_PAD}{\ButtonMenu+\ButtonLeft}
+    \opt{IRIVER_H100_PAD,IAUDIO_X5_PAD}{\ButtonRec}
+    \opt{IRIVER_H300_PAD}{\ButtonOn}
+    \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonLeft}
+    \opt{IRIVER_H10_PAD}{\ButtonRew}
+    \opt{SANSA_E200_PAD,SANSA_FUZE_PAD}{\ButtonScrollBack}
+    \opt{SANSA_C200_PAD}{\ButtonVolDown}
+    \opt{GIGABEAT_PAD}{\ButtonA+\ButtonLeft}
+    \opt{GIGABEAT_S_PAD}{\ButtonPrev}
+    \opt{MROBE100_PAD}{\ButtonDisplay+\ButtonLeft}
+    \opt{PBELL_VIBE500_PAD}{\ButtonRec+\ButtonLeft}
+    \opt{touchscreen}{\TouchBottomLeft}
+       \opt{HAVEREMOTEKEYMAP}{& }
+    & Previous image in directory\\
+    \opt{SANSA_E200_PAD,SANSA_C200_PAD}{%currently only defined for the sansa pads
+        \ButtonRec
+       \opt{HAVEREMOTEKEYMAP}{& }
+        & Toggle slide show mode\\
+    }
+    \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
+    \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonMenu}
+    \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonPower}
+    \opt{SANSA_FUZE_PAD}{Long \ButtonHome}
+    \opt{GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD,PBELL_VIBE500_PAD}{\ButtonMenu}
+    \opt{touchscreen}{\TouchCenter}
+       \opt{HAVEREMOTEKEYMAP}{&
+          \opt{IRIVER_RC_H100_PAD}{\ButtonRCStop}
+       }
+    & Show menu / Abort \\
+    \opt{IPOD_4G_PAD,IPOD_3G_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD,PBELL_VIBE500_PAD}{
+        \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonPlay}
+        \opt{GIGABEAT_PAD,MROBE100_PAD}{\ButtonPower}
+        \opt{GIGABEAT_S_PAD}{\ButtonBack}
+        \opt{PBELL_VIBE500_PAD}{\ButtonCancel}
+            \opt{HAVEREMOTEKEYMAP}{& }
+        & Quit the viewer \\
+    }
+\end{btnmap}
+
+The menu has the following entries.
+\begin{description}
+\item[Return.] Returns you to the image
+\item[Toggle Slideshow Mode.] Enables or disables the slideshow mode.
+\item[Change Slideshow Timeout.] You can set the timeout for the slideshow
+  between 1 second and 20 seconds.
+\opt{large_plugin_buffer}{
+\item[Show Playback Menu.] From the playback menu you can control the
+playback of the currently loaded playlist and change the volume of your \dap.
+}
+\opt{lcd_color}{
+\item[Display Options.] From this menu you can force the viewer to render the
+image in greyscale using the \setting{Greyscale} option or set the method of
+dithering used in the \setting{Dithering} submenu. These settings only take affect
+for JPEG images.
+}
+\item[Quit.] Quits the viewer and returns to the \setting{File Browser}.
+\end{description}
+
+\note{
+Progressive scan and other unusual JPEG files are not supported, and will
+result in various ``unsupported xx'' messages. Processing could also fail if the
+image is too big to decode which will be explained by a respective message.
+}
-- 
cgit v1.2.3

