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