From 50b036320ba53963f142d00ecd9ea7b27901ea35 Mon Sep 17 00:00:00 2001
From: Yoshihisa Uchida <uchida@rockbox.org>
Date: Sun, 28 Feb 2010 10:42:56 +0000
Subject: manual: File formats/Supported audio formats updates. - sort by
 extension. - add SMAF/Sun Audio/Vox/Wave64 codecs.   I divided the audio
 formats table with Lossy/Lossless/Other.

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@24961 a1c6a512-1295-4272-9138-f99709370657
---
 manual/appendix/file_formats.tex | 198 +++++++++++++++++++++++++--------------
 1 file changed, 127 insertions(+), 71 deletions(-)

(limited to 'manual/appendix/file_formats.tex')

diff --git a/manual/appendix/file_formats.tex b/manual/appendix/file_formats.tex
index ebf231114f..e1e08df958 100644
--- a/manual/appendix/file_formats.tex
+++ b/manual/appendix/file_formats.tex
@@ -7,101 +7,134 @@
   & \textbf{Action when selected}}{}{}
 \includegraphics[width=0.37cm]{appendix/images/icon-directory.png} 
   & Directory & \emph{none} & Enter the directory \\
-\includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png} 
-  & Audio file & 
-  \opt{masd,masf}{\fname{.mp2, .mp3}}%
-  \opt{swcodec}{\emph{various}\newline%
-  (see \ref{ref:Supportedaudioformats}})%
+\opt{recorder,recorderv2fm,ondiofm,ondiosp}{
+  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
+  & Rockbox firmware & \fname{.ajz} & Load the new firmware with ROLO \\
+}
+\opt{swcodec}{
+  \includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png} 
+  & Audio file & \emph{various}\newline%
+  (see \ref{ref:Supportedaudioformats})%
   % do NOT use \reference{} here as that will break the table.
   & Start playing the file and show the WPS\\
-  \includegraphics[width=0.37cm]{appendix/images/icon-cuesheet.png} 
-  & Cuesheet & \fname{.cue} & View the cuesheet file \\
-\opt{masf}{
-  \includegraphics[width=0.37cm]{appendix/images/icon-wav-file.png} 
-    & Wave Audio File & \fname{.wav} & Play the WAV file \\%
 }
-\includegraphics[width=0.37cm]{appendix/images/icon-playlist.png}
-  & Playlist & \fname{.m3u, .m3u8} & Load the playlist and start playing 
-    the first file \\
-\includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
-  & Rockbox firmware & 
-    \opt{player}{\fname{.mod}}\opt{recorder,recorderv2fm,ondiofm,ondiosp}{\fname{.ajz}}%
-    \opt{h100,h300}{\fname{.iriver}}\opt{ipod}{\fname{.ipod}}\opt{iaudio}{\fname{.iaudio}}%
-    \opt{h10,h10_5gb,sansa}{\fname{.mi4}}\opt{gigabeat}{\fname{.gigabeat}}%
-    \opt{sansaAMS}{\fname{.sansa}}
-  & Load the new firmware with ROLO \\
-\includegraphics[width=0.37cm]{appendix/images/icon-wps.png} 
-  & While Playing Screen & \fname{.wps} & Load the new WPS display configuration \\
-\includegraphics[width=0.37cm]{appendix/images/icon-lang.png} 
-  & Language File & \fname{.lng} & Load the language file \\
-\includegraphics[width=0.37cm]{appendix/images/icon-text.png} 
-  & Text File & \fname{.txt} & Display the text file using the text viewer plugin\\
+  & Bookmark & \fname{.bmark} & Display all bookmarks for an audio file\\
+\opt{lcd_bitmap}{
+  & Game of Life & \fname{.cells} & Show the configuration with the
+     ``Rocklife'' plugin\\
+}
 \includegraphics[width=0.37cm]{appendix/images/icon-config.png} 
   & Configuration File & \fname{.cfg} & Load the settings file\\
-\includegraphics[width=0.37cm]{appendix/images/icon-font.png} 
-  & Font & \fname{.fnt} & Change the user interface font to this one\\
-\includegraphics[width=0.37cm]{appendix/images/icon-rock.png} 
-  & Plugin & \fname{.rock} & Start the plugin\\
-\opt{archos}{
-  \includegraphics[width=0.37cm]{appendix/images/icon-ucl.png} 
-    & Flash Image & \fname{.ucl} & Flash the Rockbox image into the ROM \\
-  }
 \includegraphics[width=0.37cm]{appendix/images/icon-chip8.png} 
   & Chip8 game & \fname{.ch8} & Play the Chip8 game \\
+\opt{lcd_color}{
+  & Colours & \fname{.colours} & Open the colours file for editing.
+    See \reference{ref:ChangingFiletypeColours}.\\
+}
+\includegraphics[width=0.37cm]{appendix/images/icon-cuesheet.png} 
+  & Cuesheet & \fname{.cue} & View the cuesheet file \\
+\opt{radio}{
+  & FM Presets & \fname{.fmr} & Load the FM Presets (previous are discarded)\\
+}
+\includegraphics[width=0.37cm]{appendix/images/icon-font.png} 
+  & Font & \fname{.fnt} & Change the user interface font to this one\\
+\opt{gigabeat}{
+  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
+  & Rockbox firmware & \fname{.gigabeat} & Load the new firmware with ROLO \\
+}
+\opt{iaudio}{
+  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
+  & Rockbox firmware & \fname{.iaudio} & Load the new firmware with ROLO \\
+}
+\opt{ipod}{
+  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
+  & Rockbox firmware & \fname{.ipod} & Load the new firmware with ROLO \\
+}
+\opt{h100,h300}{
+  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
+  & Rockbox firmware & \fname{.iriver} & Load the new firmware with ROLO \\
+}
 \includegraphics[width=0.37cm]{appendix/images/icon-image-file.png} 
   & Image & \fname{.jpg} & View the JPEG image \\
+  & Link & \fname{.link} & Display list of target files and directories;
+    selecting one jumps to the target. See \reference{ref:Shortcutsplugin}.\\
+\includegraphics[width=0.37cm]{appendix/images/icon-lang.png} 
+  & Language File & \fname{.lng} & Load the language file \\
+\includegraphics[width=0.37cm]{appendix/images/icon-playlist.png}
+  & Playlist & \fname{.m3u, .m3u8} & Load the playlist and start playing 
+    the first file \\
+\opt{h10,h10_5gb,sansa}{
+  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
+  & Rockbox firmware & \fname{.mi4} & Load the new firmware with ROLO \\
+}
+\opt{player}{
+  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
+  & Rockbox firmware & \fname{.mod} & Load the new firmware with ROLO \\
+}
+\opt{masd,masf}{
+  \includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png} 
+  & Audio file & \fname{.mp2, .mp3} & Start playing the file and show the WPS\\
+}
 \opt{swcodec}{
  \includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png}
  & Video & \fname{.mpg, .mpeg, .mpv, .m2v} & Play the MPEG1/2 video \\
 }
+\includegraphics[width=0.37cm]{appendix/images/icon-rock.png} 
+  & Plugin & \fname{.rock} & Start the plugin\\
 \opt{masf}{\opt{lcd_bitmap}{
   \includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png} 
     & Rockbox Video & \fname{.rvf} & View the movie (Rockbox format)\\}
 }
-\opt{radio}{
-  & FM Presets & \fname{.fmr} & Load the FM Presets (previous are discarded)\\}
+\opt{sansaAMS}{
+  \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 
+  & Rockbox firmware & \fname{.sansa} & Load the new firmware with ROLO \\
+}
+\includegraphics[width=0.37cm]{appendix/images/icon-text.png} 
+  & Text File & \fname{.txt} & Display the text file using the text viewer plugin\\
+\opt{archos}{
+  \includegraphics[width=0.37cm]{appendix/images/icon-ucl.png} 
+    & Flash Image & \fname{.ucl} & Flash the Rockbox image into the ROM \\
+  }
   & Voice file & \fname{.voice} & Allow Rockbox to speak menus\\
-  & Bookmark & \fname{.bmark} & Display all bookmarks for an audio file\\
-  & Link & \fname{.link} & Display list of target files and directories;
-    selecting one jumps to the target. See \reference{ref:Shortcutsplugin}.\\
-\opt{lcd_color}{
-  & Colours & \fname{.colours} & Open the colours file for editing.
-    See \reference{ref:ChangingFiletypeColours}.\\
+\opt{masf}{
+  \includegraphics[width=0.37cm]{appendix/images/icon-wav-file.png} 
+    & Wave Audio File & \fname{.wav} & Play the WAV file \\%
 }
-\opt{lcd_bitmap}{
-  & Game of Life & \fname{.cells} & Show the configuration with the
-     ``Rocklife'' plugin\\}
-
+\includegraphics[width=0.37cm]{appendix/images/icon-wps.png} 
+  & While Playing Screen & \fname{.wps} & Load the new WPS display configuration\\
 \end{rbtabular}
 \end{table}
 
 \opt{swcodec}{
   \section{\label{ref:Supportedaudioformats}Supported audio formats}
+  \textbf{Lossy codecs}
   \begin{table}
   \begin{rbtabular}{\textwidth}{lp{6em}X}%
   {\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
-    \multicolumn{2}{c}{\textbf{Lossy codecs}}\\
-    \midrule
-    MPEG audio & \fname{.mp1, .mpa, .mp2, .mp3} & \\
-    OGG/Vorbis & \fname{.ogg, .oga} & Some old ``floor 0'' files may crash Rockbox. \\
-    Musepack & \fname{.mpc} & Supports SV7 only \\
-    Advanced Audio Coding & \fname{.m4a, .m4b, .mp4} & \\
-    Windows Media Audio & \fname{.wma, .wmv, .asf} & \\
     ATSC A/52 & \fname{.a52, .ac3} & Supports downmixing for playback of 5.1 streams in stereo. \\
     ADX & \fname{.adx} & \\
-    Speex & \fname{.spx} & \\
-    RealAudio & \fname{.rm, .ra, .rmvb} & \\
+    Advanced Audio Coding & \fname{.m4a, .m4b, .mp4} & \\
+    MPEG audio & \fname{.mp1, .mpa, .mp2, .mp3} & \\
+    Musepack & \fname{.mpc} & Supports SV7 only \\
+    OGG/Vorbis & \fname{.ogg, .oga} & Some old ``floor 0'' files may crash Rockbox. \\
     Sony Audio & \fname{.oma, .aa3} & \\
-    
-    \midrule
-    \multicolumn{2}{c}{\textbf{Lossless codecs}}\\
-    \midrule
-    Waveform audio format & \fname{.wav} & \\
-    Audio Interchange File Format & \fname{.aif, .aiff} & \\
-    Free Lossless Audio & \fname{.flac} & \\
-    Apple Lossless & \fname{.m4a, .mp4} & \\
-    Wavpack & \fname{.wv} & \\
-    Shorten & \fname{.shn} & Seeking not supported.\\
+    RealAudio & \fname{.rm, .ra, .rmvb} & \\
+    Speex & \fname{.spx} & \\
+    Dialogic telephony type & \fname{.vox} & \\
+    Windows Media Audio & \fname{.wma, .wmv, .asf} & \\
+  \end{rbtabular}
+  \end{table}
+  \newpage
+
+  \textbf{Lossless codecs}
+  \begin{table}
+  \begin{rbtabular}{\textwidth}{lp{6em}X}%
+  {\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
+    Audio Interchange File Format & \fname{.aif, .aiff} & AIFF supports following formats: \\
+                                  &                     & linear pcm 8/16/24/32 bit. \\
+                                  &                     & IEEE float 32/64 bit\\
+                                  &                     & ITU-T G.711 a-low/$\mu$-low\\
+                                  &                     & QuickTime IMA ADPCM\\
     \opt{h100,h300,x5,m5,m3}{
       Monkey's Audio & \fname{.ape, .mac} & -c1000 and -c2000 files decode
       fast enough to be useful.}
@@ -115,15 +148,38 @@
       Monkey's Audio & \fname{.ape, .mac} & Only -c1000 files decode fast
       enough to be useful.}
     \\
-    \midrule
-    \multicolumn{2}{c}{\textbf{Other codecs}}\\
-    \midrule
-    Sound Interface Device & \fname{.sid} & \\
+    Sun Audio & \fname{.au, .snd} & Sun Audio supports following formats: \\
+              &                   & linear pcm 8/16/24/32 bit. \\
+              &                   & IEEE float 32/64 bit\\
+              &                   & ITU-T G.711 a-low/$\mu$-low\\
+    Free Lossless Audio & \fname{.flac} & \\
+    Apple Lossless & \fname{.m4a, .mp4} & \\
+    Shorten & \fname{.shn} & Seeking not supported.\\
+    Wave64 & \fname{.w64} & Wave/Wave64 supports following formats: \\
+    Waveform audio format & \fname{.wav} & linear pcm 8/16/24/32 bit. \\
+                          &              & IEEE float 32/64 bit\\
+                          &              & ITU-T G.711 a-low/$\mu$-low\\
+                          &              & Microsoft ADPCM\\
+                          &              & Intel DVI ADPCM(IMA ADPCM) 2/3/4/5 bit\\
+                          &              & Dialogic OKI ADPCM\\
+                          &              & YAMAHA ADPCM\\
+                          &              & Adobe SWF ADPCM\\
+    Wavpack & \fname{.wv} & \\
+  \end{rbtabular}
+  \end{table}
+  \newpage
+
+  \textbf{Other codecs}
+  \begin{table}
+  \begin{rbtabular}{\textwidth}{lp{6em}X}%
+  {\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
+    Atari Sound Format & \fname{.cmc, .cm3, .cmr, .cms, .dmc, .dlt, .mpt, .mpd} & \\
+    Synthetic music Mobile Application Format & \fname{.mmf} & Supports PCM/ADPCM only \\
     MOD & \fname{.mod} & \\
     NES Sound Format & \fname{.nsf, .nsfe} & \\
-    SPC700 & \fname{.spc} & \\
     Atari SAP & \fname{.sap} & \\
-    Atari Sound Format & \fname{.cmc, .cm3, .cmr, .cms, .dmc, .dlt, .mpt, .mpd} & \\
+    Sound Interface Device & \fname{.sid} & \\
+    SPC700 & \fname{.spc} & \\
   \end{rbtabular}
   \end{table}
 }
-- 
cgit v1.2.3

