manual/appendix/file_formats.tex

   1 % $Id$ %
   2 \chapter{File formats}
   3 \section{\label{ref:Supportedfileformats}Supported file formats}
   4 \begin{rbtabular}{\textwidth}{clp{7em}X}%
   5 {\textbf{Icon} & \textbf{File Type} & \textbf{Extension}
   6   & \textbf{Action when selected}}{}{}
   7 \includegraphics[width=0.37cm]{appendix/images/icon-directory.png}
   8   & Directory & \emph{none} & Enter the directory \\
   9 \opt{recorder,recorderv2fm,ondiofm,ondiosp}{
  10   \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
  11   & Rockbox firmware & \fname{.ajz} & Load the new firmware with ROLO \\
  12 }
  13 \opt{swcodec}{
  14   \includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png}
  15   & Audio file & \emph{various}\newline%
  16   (see \ref{ref:Supportedaudioformats})%
  17   % do NOT use \reference{} here as that will break the table.
  18   & Start playing the file and show the WPS\\
  19 }
  20   & Bookmark & \fname{.bmark} & Display all bookmarks for an audio file\\
  21 \opt{lcd_bitmap}{
  22   & Game of Life & \fname{.cells} & Show the configuration with the
  23      ``Rocklife'' plugin\\
  24 }
  25 \includegraphics[width=0.37cm]{appendix/images/icon-config.png}
  26   & Configuration File & \fname{.cfg} & Load the settings file\\
  27 \includegraphics[width=0.37cm]{appendix/images/icon-chip8.png}
  28   & Chip8 game & \fname{.ch8} & Play the Chip8 game \\
  29 \opt{lcd_color}{
  30   & Colours & \fname{.colours} & Open the colours file for editing.
  31     See \reference{ref:ChangingFiletypeColours}.\\
  32 }
  33 \includegraphics[width=0.37cm]{appendix/images/icon-cuesheet.png}
  34   & Cuesheet & \fname{.cue} & View the cuesheet file \\
  35 \opt{radio}{
  36   & FM Presets & \fname{.fmr} & Load the FM Presets (previous are discarded)\\
  37 }
  38 \includegraphics[width=0.37cm]{appendix/images/icon-font.png}
  39   & Font & \fname{.fnt} & Change the user interface font to this one\\
  40 \opt{gigabeat}{
  41   \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
  42   & Rockbox firmware & \fname{.gigabeat} & Load the new firmware with ROLO \\
  43 }
  44 \opt{iaudio}{
  45   \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
  46   & Rockbox firmware & \fname{.iaudio} & Load the new firmware with ROLO \\
  47 }
  48 \opt{ipod}{
  49   \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
  50   & Rockbox firmware & \fname{.ipod} & Load the new firmware with ROLO \\
  51 }
  52 \opt{h100,h300}{
  53   \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
  54   & Rockbox firmware & \fname{.iriver} & Load the new firmware with ROLO \\
  55 }
  56 \includegraphics[width=0.37cm]{appendix/images/icon-image-file.png}
  57   & Image & \fname{.jpg} & View the JPEG image \\
  58   & Link & \fname{.link} & Display list of target files and directories;
  59     selecting one jumps to the target. See \reference{ref:Shortcutsplugin}.\\
  60 \includegraphics[width=0.37cm]{appendix/images/icon-lang.png}
  61   & Language File & \fname{.lng} & Load the language file \\
  62 \includegraphics[width=0.37cm]{appendix/images/icon-playlist.png}
  63   & Playlist & \fname{.m3u, .m3u8} & Load the playlist and start playing
  64     the first file \\
  65 \opt{h10,h10_5gb,sansa,vibe500}{
  66   \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
  67   & Rockbox firmware & \fname{.mi4} & Load the new firmware with ROLO \\
  68 }
  69 \opt{player}{
  70   \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
  71   & Rockbox firmware & \fname{.mod} & Load the new firmware with ROLO \\
  72 }
  73 \opt{masd,masf}{
  74   \includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png}
  75   & Audio file & \fname{.mp2, .mp3} & Start playing the file and show the WPS\\
  76 }
  77 \opt{swcodec}{
  78  \includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png}
  79  & Video & \fname{.mpg, .mpeg, .mpv, .m2v} & Play the MPEG1/2 video \\
  80 }
  81 \includegraphics[width=0.37cm]{appendix/images/icon-rock.png}
  82   & Plugin & \fname{.rock} & Start the plugin\\
  83 \opt{masf}{\opt{lcd_bitmap}{
  84   \includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png}
  85     & Rockbox Video & \fname{.rvf} & View the movie (Rockbox format)\\}
  86 }
  87 \opt{sansaAMS}{
  88   \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
  89   & Rockbox firmware & \fname{.sansa} & Load the new firmware with ROLO \\
  90 }
  91 \includegraphics[width=0.37cm]{appendix/images/icon-text.png}
  92   & Text File & \fname{.txt} & Display the text file using the text viewer plugin\\
  93 \opt{archos}{
  94   \includegraphics[width=0.37cm]{appendix/images/icon-ucl.png}
  95     & Flash Image & \fname{.ucl} & Flash the Rockbox image into the ROM \\
  96   }
  97   & Voice file & \fname{.voice} & Allow Rockbox to speak menus\\
  98 \opt{masf}{
  99   \includegraphics[width=0.37cm]{appendix/images/icon-wav-file.png}
 100     & Wave Audio File & \fname{.wav} & Play the WAV file \\%
 101 }
 102 \includegraphics[width=0.37cm]{appendix/images/icon-wps.png}
 103   & While Playing Screen & \fname{.wps} & Load the new WPS display configuration\\
 104 \end{rbtabular}
 105
 106 \opt{swcodec}{
 107   \section{\label{ref:Supportedaudioformats}Supported audio formats}
 108   \subsection{Lossy Codecs}
 109   \begin{rbtabular}{\textwidth}{lp{6em}X}%
 110   {\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
 111     ATSC A/52 & \fname{.a52, .ac3} & Supports downmixing for playback of 5.1 streams in stereo. \\
 112     ADX & \fname{.adx} & \\
 113     Advanced Audio Coding & \fname{.m4a, .m4b, .mp4} & \\
 114     MPEG audio & \fname{.mp1, .mpa, .mp2, .mp3} & \\
 115     Musepack & \fname{.mpc} & Supports SV7 and SV8 in mono/stereo \\
 116     OGG/Vorbis & \fname{.ogg, .oga} & Playback of some old ``floor 0'' files may fail. \\
 117     Sony Audio & \fname{.oma, .aa3} & \\
 118     RealAudio & \fname{.rm, .ra, .rmvb} & \\
 119     Speex & \fname{.spx} & \\
 120     Dialogic telephony type & \fname{.vox} & \\
 121     Windows Media Audio & \fname{.wma, .wmv, .asf} & \\
 122   \end{rbtabular}
 123
 124   \subsection{Lossless Codecs}
 125   \begin{rbtabular}{\textwidth}{lp{6em}X}%
 126   {\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
 127     Audio Interchange File Format & \fname{.aif, .aiff} & AIFF supports following formats: \\
 128                                   &                     & linear pcm 8/16/24/32 bit. \\
 129                                   &                     & IEEE float 32/64 bit\\
 130                                   &                     & ITU-T G.711 a-low/$\mu$-low\\
 131                                   &                     & QuickTime IMA ADPCM\\
 132     \opt{h100,h300,x5,m5,m3}{
 133       Monkey's Audio & \fname{.ape, .mac} & -c1000 and -c2000 files decode
 134       fast enough to be useful.}
 135     \opt{gigabeatf}{
 136       Monkey's Audio & \fname{.ape, .mac} & -c1000 to -c3000
 137       files decode fast enough to be useful.}
 138     \opt{gigabeats}{
 139       Monkey's Audio & \fname{.ape, .mac} & -c1000 to -c4000 files decode
 140       fast enough to be useful.}
 141     \opt{ipod,h10,h10_5gb,mrobe100,sansa,vibe500}{
 142       Monkey's Audio & \fname{.ape, .mac} & Only -c1000 files decode fast
 143       enough to be useful.}
 144     \\
 145     Sun Audio & \fname{.au, .snd} & Sun Audio supports following formats: \\
 146               &                   & linear pcm 8/16/24/32 bit. \\
 147               &                   & IEEE float 32/64 bit\\
 148               &                   & ITU-T G.711 a-low/$\mu$-low\\
 149     Free Lossless Audio & \fname{.flac} & \\
 150     Apple Lossless & \fname{.m4a, .mp4} & \\
 151     Shorten & \fname{.shn} & Seeking not supported.\\
 152     True Audio & \fname{.tta} & In some targets, the decoding speed is slow. \\
 153     Wave64 & \fname{.w64} & Wave/Wave64 supports following formats: \\
 154     Waveform audio format & \fname{.wav} & linear pcm 8/16/24/32 bit. \\
 155                           &              & IEEE float 32/64 bit\\
 156                           &              & ITU-T G.711 a-low/$\mu$-low\\
 157                           &              & Microsoft ADPCM\\
 158                           &              & Intel DVI ADPCM(IMA ADPCM) 2/3/4/5 bit\\
 159                           &              & Dialogic OKI ADPCM\\
 160                           &              & YAMAHA ADPCM\\
 161                           &              & Adobe SWF ADPCM\\
 162     Wavpack & \fname{.wv} & \\
 163   \end{rbtabular}
 164
 165   \subsection{Other Codecs}
 166   \begin{rbtabular}{\textwidth}{lp{6em}X}%
 167   {\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
 168     Atari Sound Format & \fname{.cmc, .cm3, .cmr, .cms, .dmc, .dlt, .mpt, .mpd} & \\
 169     Synthetic music Mobile Application Format & \fname{.mmf} & Supports PCM/ADPCM only \\
 170     MOD & \fname{.mod} & \\
 171     NES Sound Format & \fname{.nsf, .nsfe} & \\
 172     Atari SAP & \fname{.sap} & \\
 173     Sound Interface Device & \fname{.sid} & \\
 174     SPC700 & \fname{.spc} & \\
 175   \end{rbtabular}
 176 }