From e5b1a7d4237a9006b6c49c9c1c13b292ca4ecf7c Mon Sep 17 00:00:00 2001 From: Teruaki Kawashima 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