manual/appendix/file_formats.tex

   1 % $Id$ %
   2 \chapter{File formats}
   3 \section{\label{ref:Supportedfileformats}Supported file formats}
   4 \begin{table}
   5 \begin{center}
   6 \begin{tabularx}{\textwidth}{llXX}\toprule
   7 \textbf{Icon} & \textbf{File Type} & \textbf{Extension}
   8   & \textbf{Action when selected} \\\midrule
   9 \includegraphics[width=0.37cm]{appendix/images/icon-directory.png}
  10   & Directory & \emph{none} & Enter the directory \\
  11 \includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png}
  12   & Audio file &
  13   \opt{MASCODEC}{\fname{.mp2, .mp3}}\opt{swcodec}{\emph{various (see
  14     \reference{ref:Supportedaudioformats}})}
  15   & Start playing the file and show the WPS\\
  16   \includegraphics[width=0.37cm]{appendix/images/icon-cuesheet.png}
  17   & Cuesheet & \fname{.cue} & View the cuesheet file \\
  18 \opt{masf}{
  19   \includegraphics[width=0.37cm]{appendix/images/icon-wav-file.png}
  20     & Wave Audio File & \fname{.wav} & Play the WAV file \\%
  21 }
  22 \includegraphics[width=0.37cm]{appendix/images/icon-playlist.png}
  23   & Playlist & \fname{.m3u, .m3u8} & Load the playlist and start playing
  24     the first file \\
  25 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
  26   & Rockbox firmware &
  27     \opt{player}{\fname{.mod}}\opt{recorder,recorderv2fm,ondiofm,ondiosp}{\fname{.ajz}}%
  28     \opt{h100,h300}{\fname{.iriver}}\opt{ipod}{\fname{.ipod}}\opt{iaudio}{\fname{.iaudio}}%
  29     \opt{h10,h10_5gb,sansa}{\fname{.mi4}}\opt{gigabeat}{\fname{.gigabeat}}
  30   & Load the new firmware with ROLO \\
  31 \includegraphics[width=0.37cm]{appendix/images/icon-wps.png}
  32   & While Playing Screen & \fname{.wps} & Load the new WPS display configuration \\
  33 \includegraphics[width=0.37cm]{appendix/images/icon-lang.png}
  34   & Language File & \fname{.lng} & Load the language file \\
  35 \includegraphics[width=0.37cm]{appendix/images/icon-text.png}
  36   & Text File & \fname{.txt} & Display the text file using the text viewer plugin\\
  37 \includegraphics[width=0.37cm]{appendix/images/icon-config.png}
  38   & Configuration File & \fname{.cfg} & Load the settings file\\
  39 \includegraphics[width=0.37cm]{appendix/images/icon-font.png}
  40   & Font & \fname{.fnt} & Change the user interface font to this one\\
  41 \includegraphics[width=0.37cm]{appendix/images/icon-rock.png}
  42   & Plugin & \fname{.rock} & Start the plugin\\
  43 \opt{archos}{
  44   \includegraphics[width=0.37cm]{appendix/images/icon-ucl.png}
  45     & Flash Image & \fname{.ucl} & Flash the Rockbox image into the ROM \\
  46   }
  47 \includegraphics[width=0.37cm]{appendix/images/icon-chip8.png}
  48   & Chip8 game & \fname{.ch8} & Play the Chip8 game \\
  49 \includegraphics[width=0.37cm]{appendix/images/icon-image-file.png}
  50   & Image & \fname{.jpg} & View the JPEG image \\
  51 \opt{swcodec}{
  52  \includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png}
  53  & Video & \fname{.mpg, .mpeg, .mpv, .m2v} & Play the MPEG1/2 video \\
  54 }
  55 \opt{MASCODEC}{\opt{lcd_bitmap}{
  56   \includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png}
  57     & Rockbox Video & \fname{.rvf} & View the movie (Rockbox format)\\}
  58 }
  59 \opt{radio}{
  60   & FM Preset & \fname{.fmr} & Loads FM Presets of your choosing\\}
  61   & Voice file & \fname{.voice} & Allows Rockbox to speak menus for you\\
  62   & Bookmark & \fname{.bmark} & Displays all bookmarks for an audio file\\
  63   & Link & \fname{.link} & Display list of target files and directories;
  64     selecting one jumps to the target. See \reference{ref:Shortcutsplugin}.\\
  65 \opt{lcd_color}{
  66   & Colours & \fname{.colours} & Open the colours file for editing.
  67     See \reference{ref:ChangingFiletypeColours}.\\
  68 }
  69 \bottomrule
  70 \end{tabularx}
  71 \end{center}
  72 \end{table}
  73
  74 \opt{swcodec}{
  75   \section{\label{ref:Supportedaudioformats}Supported audio formats}
  76   \begin{table}
  77   \begin{center}
  78   \begin{tabularx}{\textwidth}{lXX}\toprule
  79   \textbf{Format} & \textbf{Extension} & \textbf{Notes} \\\midrule
  80     \emph{Lossy codecs} \\
  81     \midrule
  82     MPEG audio & \fname{.mp1, .mpa, .mp2, .mp3} & \\
  83     OGG/Vorbis & \fname{.ogg, .oga} & Some old ``floor 0'' files may crash Rockbox. \\
  84     Musepack & \fname{.mpc} & \\
  85     Advanced Audio Coding & \fname{.m4a, .m4b, .mp4} & \\
  86     Windows Media Audio & \fname{.wma, .wmv, .asf} & \\
  87     ATSC A/52 & \fname{.a52, .ac3} & Supports downmixing for playback of 5.1 streams in stereo. \\
  88     ADX & \fname{.adx} & \\
  89     Speex & \fname{.spx} & \\
  90     \\
  91     \midrule
  92     \emph{Lossless codecs} \\
  93     \midrule
  94     Waveform audio format & \fname{.wav} & \\
  95     Audio Interchange File Format & \fname{.aif, .aiff} & \\
  96     Free Lossless Audio & \fname{.flac} & \\
  97     Apple Lossless & \fname{.m4a, .mp4} & \\
  98     Wavpack & \fname{.wv} & \\
  99     Shorten & \fname{.shn} & Seeking not supported.\\
 100     \opt{h100,h300,x5,m5,m3}{
 101       Monkey's Audio & \fname{.ape, .mac} & -c1000 and -c2000 files decode fast enough to be useful. \\
 102     }
 103     \opt{gigabeatf}{
 104       Monkey's Audio & \fname{.ape, .mac} & -c1000 to -c3000 files decode fast enough to be useful. \\
 105     }
 106     \opt{gigabeats}{
 107       Monkey's Audio & \fname{.ape, .mac} & -c1000 to -c4000 files decode fast enough to be useful. \\
 108     }
 109     \nopt{h100,h300,x5,m5,m3,gigabeat}{%
 110       Monkey's Audio & \fname{.ape, .mac} & Only -c1000 files decode fast enough to be useful. \\
 111     }
 112     \\
 113     \midrule
 114     \emph{Other codecs} \\
 115     \midrule
 116     Sound Interface Device & \fname{.sid} & \\
 117     MOD & \fname{.mod} & \\
 118     NES Sound Format & \fname{.nsf, .nsfe} & \\
 119     SPC700 & \fname{.spc} & \\
 120     Atari SAP & \fname{.sap} & \\
 121   \bottomrule
 122   \end{tabularx}
 123   \end{center}
 124   \end{table}
 125 }