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