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