manual/plugins/imageviewer.tex

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