1 files changed, 142 insertions, 0 deletions
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.
+}

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 @@
	1	% $Id$ %
	2	\subsection{Image Viewer}
	3	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.
	4
	5	\begin{table}
	6	\begin{rbtabular}{.60\textwidth}{llX}%
	7	{\textbf{Format}& \textbf{File-extension(s)}}%
	8	{}{}
	9	BMP & \fname{.bmp} \\
	10	JPEG & \fname{.jpg, .jpe, .jpeg} \\
	11	PNG & \fname{.png} \\
	12	\end{rbtabular}
	13	\end{table}
	14
	15	\opt{large_plugin_buffer}{
	16	\par
	17	\note{
	18	When an audio file is playing the size of the image is limited as
	19	the decoding process needs to share memory with audio tracks. To be able to
	20	view a bigger file you may need to stop playback.}
	21	}
	22	\nopt{large_plugin_buffer}{%
	23	\note{This plugin will cause playback to stop.}%
	24	}%
	25
	26	\begin{btnmap}
	27	\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD%
	28	,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD%
	29	,MROBE100_PAD,PBELL_VIBE500_PAD}
	30	{\ButtonUp\ / \ButtonDown}%
	31	\opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonMenu\ / \ButtonPlay}%
	32	\opt{IRIVER_H10_PAD}{\ButtonScrollUp\ / \ButtonScrollDown} %
	33	\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD%
	34	,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD%
	35	,MROBE100_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IRIVER_H10_PAD,PBELL_VIBE500_PAD}
	36	{/ \ButtonLeft\ / \ButtonRight}
	37	\opt{touchscreen}{\TouchTopMiddle{} / \TouchBottomMiddle{}/ \TouchMidLeft{} / \TouchMidRight}
	38	\opt{HAVEREMOTEKEYMAP}{& }
	39	& Move around in zoomed in image\\
	40	\opt{RECORDER_PAD}{\ButtonPlay}
	41	\opt{ONDIO_PAD}{\ButtonMenu}
	42	\opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD%
	43	,SANSA_FUZE_PAD,SANSA_C200_PAD,MROBE100_PAD}{\ButtonSelect}
	44	\opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollFwd}
	45	\opt{IRIVER_H10_PAD}{\ButtonPlay}
	46	\opt{GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonVolUp}
	47	\opt{PBELL_VIBE500_PAD}{\ButtonRec+\ButtonUp}
	48	\opt{touchscreen}{\TouchTopRight}
	49	\opt{HAVEREMOTEKEYMAP}{& }
	50	& Zoom in\\
	51	\opt{RECORDER_PAD}{\ButtonOn}
	52	\opt{ONDIO_PAD}{\ButtonMenu+\ButtonDown}
	53	\opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode}
	54	\opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollBack}
	55	\opt{IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD}{Long \ButtonSelect}
	56	\opt{IRIVER_H10_PAD}{Long \ButtonPlay}
	57	\opt{GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonVolDown}
	58	\opt{MROBE100_PAD}{\ButtonPlay}
	59	\opt{PBELL_VIBE500_PAD}{\ButtonRec+\ButtonDown}
	60	\opt{touchscreen}{\TouchTopLeft}
	61	\opt{HAVEREMOTEKEYMAP}{& }
	62	& Zoom out\\
	63	\opt{RECORDER_PAD}{\ButtonFThree}
	64	\opt{ONDIO_PAD}{\ButtonMenu+\ButtonRight}
	65	\opt{IRIVER_H100_PAD}{\ButtonOn}
	66	\opt{IRIVER_H300_PAD}{\ButtonRec}
	67	\opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonRight}
	68	\opt{IAUDIO_X5_PAD}{\ButtonPlay}
	69	\opt{IRIVER_H10_PAD}{\ButtonFF}
	70	\opt{SANSA_E200_PAD,SANSA_FUZE_PAD}{\ButtonScrollFwd}
	71	\opt{SANSA_C200_PAD}{\ButtonVolUp}
	72	\opt{GIGABEAT_PAD}{\ButtonA+\ButtonRight}
	73	\opt{GIGABEAT_S_PAD}{\ButtonNext}
	74	\opt{MROBE100_PAD}{\ButtonDisplay+\ButtonRight}
	75	\opt{PBELL_VIBE500_PAD}{\ButtonRec+\ButtonRight}
	76	\opt{touchscreen}{\TouchBottomRight}
	77	\opt{HAVEREMOTEKEYMAP}{& }
	78	& Next image in directory\\
	79	\opt{RECORDER_PAD}{\ButtonFTwo}
	80	\opt{ONDIO_PAD}{\ButtonMenu+\ButtonLeft}
	81	\opt{IRIVER_H100_PAD,IAUDIO_X5_PAD}{\ButtonRec}
	82	\opt{IRIVER_H300_PAD}{\ButtonOn}
	83	\opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonLeft}
	84	\opt{IRIVER_H10_PAD}{\ButtonRew}
	85	\opt{SANSA_E200_PAD,SANSA_FUZE_PAD}{\ButtonScrollBack}
	86	\opt{SANSA_C200_PAD}{\ButtonVolDown}
	87	\opt{GIGABEAT_PAD}{\ButtonA+\ButtonLeft}
	88	\opt{GIGABEAT_S_PAD}{\ButtonPrev}
	89	\opt{MROBE100_PAD}{\ButtonDisplay+\ButtonLeft}
	90	\opt{PBELL_VIBE500_PAD}{\ButtonRec+\ButtonLeft}
	91	\opt{touchscreen}{\TouchBottomLeft}
	92	\opt{HAVEREMOTEKEYMAP}{& }
	93	& Previous image in directory\\
	94	\opt{SANSA_E200_PAD,SANSA_C200_PAD}{%currently only defined for the sansa pads
	95	\ButtonRec
	96	\opt{HAVEREMOTEKEYMAP}{& }
	97	& Toggle slide show mode\\
	98	}
	99	\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
	100	\opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonMenu}
	101	\opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonPower}
	102	\opt{SANSA_FUZE_PAD}{Long \ButtonHome}
	103	\opt{GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD,PBELL_VIBE500_PAD}{\ButtonMenu}
	104	\opt{touchscreen}{\TouchCenter}
	105	\opt{HAVEREMOTEKEYMAP}{&
	106	\opt{IRIVER_RC_H100_PAD}{\ButtonRCStop}
	107	}
	108	& Show menu / Abort \\
	109	\opt{IPOD_4G_PAD,IPOD_3G_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD,PBELL_VIBE500_PAD}{
	110	\opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonPlay}
	111	\opt{GIGABEAT_PAD,MROBE100_PAD}{\ButtonPower}
	112	\opt{GIGABEAT_S_PAD}{\ButtonBack}
	113	\opt{PBELL_VIBE500_PAD}{\ButtonCancel}
	114	\opt{HAVEREMOTEKEYMAP}{& }
	115	& Quit the viewer \\
	116	}
	117	\end{btnmap}
	118
	119	The menu has the following entries.
	120	\begin{description}
	121	\item[Return.] Returns you to the image
	122	\item[Toggle Slideshow Mode.] Enables or disables the slideshow mode.
	123	\item[Change Slideshow Timeout.] You can set the timeout for the slideshow
	124	between 1 second and 20 seconds.
	125	\opt{large_plugin_buffer}{
	126	\item[Show Playback Menu.] From the playback menu you can control the
	127	playback of the currently loaded playlist and change the volume of your \dap.
	128	}
	129	\opt{lcd_color}{
	130	\item[Display Options.] From this menu you can force the viewer to render the
	131	image in greyscale using the \setting{Greyscale} option or set the method of
	132	dithering used in the \setting{Dithering} submenu. These settings only take affect
	133	for JPEG images.
	134	}
	135	\item[Quit.] Quits the viewer and returns to the \setting{File Browser}.
	136	\end{description}
	137
	138	\note{
	139	Progressive scan and other unusual JPEG files are not supported, and will
	140	result in various ``unsupported xx'' messages. Processing could also fail if the
	141	image is too big to decode which will be explained by a respective message.
	142	}