summaryrefslogtreecommitdiff
path: root/manual
diff options
context:
space:
mode:
Diffstat (limited to 'manual')
-rw-r--r--manual/appendix/appendix.tex119
1 files changed, 81 insertions, 38 deletions
diff --git a/manual/appendix/appendix.tex b/manual/appendix/appendix.tex
index 7c3cd04fca..f9f1537b22 100644
--- a/manual/appendix/appendix.tex
+++ b/manual/appendix/appendix.tex
@@ -4,20 +4,34 @@
4\begin{center} 4\begin{center}
5\begin{tabularx}{\textwidth}{llX}\toprule 5\begin{tabularx}{\textwidth}{llX}\toprule
6\textbf{Icon} & \textbf{File Type} & \textbf{Action} \\\midrule 6\textbf{Icon} & \textbf{File Type} & \textbf{Action} \\\midrule
7\includegraphics[width=0.37cm]{appendix/images/icon-directory.png} & Directory & The browser enters that directory \\ 7\includegraphics[width=0.37cm]{appendix/images/icon-directory.png}
8\includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png} & Audio file & Rockbox takes you to the WPS and starts playing the file \\ 8 & Directory & The browser enters that directory \\
9\includegraphics[width=0.37cm]{appendix/images/icon-playlist.png} & .m3u & Rockbox loads the playlist and starts playing the first file \\ 9\includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png}
10\includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} & Rockbox firmware file & ROLO will load the new firmware \\ 10 & Audio file & Rockbox takes you to the WPS and starts playing the file \\
11\includegraphics[width=0.37cm]{appendix/images/icon-wps.png} & .wps & The new WPS display configuration will be loaded \\ 11\includegraphics[width=0.37cm]{appendix/images/icon-playlist.png}
12\includegraphics[width=0.37cm]{appendix/images/icon-lang.png} & .lng & Loads a language file \\ 12 & .m3u & Rockbox loads the playlist and starts playing the first file \\
13\includegraphics[width=0.37cm]{appendix/images/icon-text.png} & .txt & This will display the text file using Rockbox text browser plugin\\ 13\includegraphics[width=0.37cm]{appendix/images/icon-rolo.png}
14\includegraphics[width=0.37cm]{appendix/images/icon-config.png} & .cfg & The settings file will be loaded\\ 14 & Rockbox firmware file & ROLO will load the new firmware \\
15\includegraphics[width=0.37cm]{appendix/images/icon-font.png} & .fnt & This font will replace the current one\\ 15\includegraphics[width=0.37cm]{appendix/images/icon-wps.png}
16\includegraphics[width=0.37cm]{appendix/images/icon-rock.png} & .rock & Starts a Rockbox plugin\\ 16 & .wps & The new WPS display configuration will be loaded \\
17\includegraphics[width=0.37cm]{appendix/images/icon-ucl.png} & .ucl & This Rockbox image will be flashed into the ROM \\ 17\includegraphics[width=0.37cm]{appendix/images/icon-lang.png}
18\includegraphics[width=0.37cm]{appendix/images/icon-chip8.png} & .ch8 & Play a Chip8 game \\ 18 & .lng & Loads a language file \\
19\includegraphics[width=0.37cm]{appendix/images/icon-image-file.png} & .jpg & View a JPEG image \\ 19\includegraphics[width=0.37cm]{appendix/images/icon-text.png}
20\includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png} & .rvf & View a movie (Rockbox format)\\\bottomrule 20 & .txt & This will display the text file using Rockbox text browser plugin\\
21\includegraphics[width=0.37cm]{appendix/images/icon-config.png}
22 & .cfg & The settings file will be loaded\\
23\includegraphics[width=0.37cm]{appendix/images/icon-font.png}
24 & .fnt & This font will replace the current one\\
25\includegraphics[width=0.37cm]{appendix/images/icon-rock.png}
26 & .rock & Starts a Rockbox plugin\\
27\includegraphics[width=0.37cm]{appendix/images/icon-ucl.png}
28 & .ucl & This Rockbox image will be flashed into the ROM \\
29\includegraphics[width=0.37cm]{appendix/images/icon-chip8.png}
30 & .ch8 & Play a Chip8 game \\
31\includegraphics[width=0.37cm]{appendix/images/icon-image-file.png}
32 & .jpg & View a JPEG image \\
33\includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png}
34 & .rvf & View a movie (Rockbox format)\\\bottomrule
21\end{tabularx} 35\end{tabularx}
22\end{center} 36\end{center}
23 37
@@ -29,17 +43,18 @@
29 43
30\chapter{LCD Screen Sizes} 44\chapter{LCD Screen Sizes}
31\begin{center} 45\begin{center}
32 \begin{tabular}{@{}lll@{}}\toprule 46 \begin{tabularx}{.8\textwidth}{lXX}\toprule
33 \textbf{Player} & \textbf{Main LCD Size} & \textbf{Remote LCD Size}\\\midrule 47 \textbf{Player} & \textbf{Main LCD Size} & \textbf{Remote LCD Size}\\\midrule
34 iriver H1x0 & 160x128 & 128x64\\ 48 iriver H1x0 & 160x128 & 128x64\\
35 iriver H3x0 & 220x176 & 128x64\\ 49 iriver H3x0 & 220x176 & 128x64\\
36 Archos Recorders & 112x64 & \\ 50 Archos Recorders & 112x64 & (none)\\
37 Archos Ondio & 112x64 & \\ 51 Archos Ondio & 112x64 & (none)\\
38 iPod Nano & 176x132 & \\ 52 iPod Nano & 176x132 & (none)\\
39 iPod 4G Color & 220x176 & \\ 53 iPod 4G Color & 220x176 & (none)\\
40 iPod 5G Video & 320x240 & \\ 54 iPod 5G Video & 320x240 & (none)\\
41 iAudio X5 & 160x128 & \\\bottomrule 55 iAudio X5 & 160x128 & (none)\\
42 \end{tabular} 56 iPodMini 2G &138x110 & (none) \\\bottomrule
57 \end{tabularx}
43\end{center} 58\end{center}
44 59
45 60
@@ -77,8 +92,10 @@ For open feature requests refer to
77\subsection{Rules for submitting a new feature request} 92\subsection{Rules for submitting a new feature request}
78 93
79\begin{enumerate} 94\begin{enumerate}
80\item Check that the feature hasn't already been requested. Duplicates are really boring! 95\item Check that the feature hasn't already been requested.
81\item Check that the feature hasn't already been implemented. Download the latest daily build and/or search the mail list archive. 96 Duplicates are really boring!
97\item Check that the feature hasn't already been implemented.
98 Download the latest daily build and/or search the mail list archive.
82\item Check that the feature is possible to implement (see page \pageref{ref:NODO}). 99\item Check that the feature is possible to implement (see page \pageref{ref:NODO}).
83\end{enumerate} 100\end{enumerate}
84 101
@@ -91,29 +108,55 @@ cannot do. View it as the opposite of a TODO!
91\item Record to WAV (uncompressed) or MP3pro format!\\ 108\item Record to WAV (uncompressed) or MP3pro format!\\
92The recording hardware (the MAS) does not allow us to do this 109The recording hardware (the MAS) does not allow us to do this
93\item Crossfade between tracks!\\ 110\item Crossfade between tracks!\\
94 Crossfading would require two mp3 decoders, and we only have one. This is not possible. 111 Crossfading would require two mp3 decoders, and we only have one.
112 This is not possible.
95\item Interfacing with other USB devices (like cameras) or 2 player games over USB\\ 113\item Interfacing with other USB devices (like cameras) or 2 player games over USB\\
96The USB system demands that there is a master that talks to a slave. The Jukebox can only serve as a slave, as most other USB devices such as cameras can. Thus, without a master no communication between the slaves can take place. If that is not enough, we have no ways of actually controlling the communication performed over USB since the USB circuit in the Jukebox is strictly made for disk{}-access and does not allow us to play with it the way we'd need for any good communication to work. 114 The USB system demands that there is a master that talks to a slave. The
115 Jukebox can only serve as a slave, as most other USB devices such as
116 cameras can. Thus, without a master no communication between the slaves
117 can take place. If that is not enough, we have no ways of actually
118 controlling the communication performed over USB since the USB circuit
119 in the Jukebox is strictly made for disk{}-access and does not allow us
120 to play with it the way we'd need for any good communication to work.
97\item Support MP3pro, WMA or other sound format playback!\\ 121\item Support MP3pro, WMA or other sound format playback!\\
98The mp3{}-decoding hardware can only play MP3. We cannot make it play other sound formats. 122 The mp3{}-decoding hardware can only play MP3. We cannot make it play other
99\item Converting OGG{}-{\textgreater}MP3 \\ 123 sound formats.
100The mp3{}-decoding hardware cannot decode OGG. It can be reprogrammed, but there is too little memory for OGG and we have no documentation on how to program the MAS' DSP. Doing the conversion with the CPU is impossible, since a 12MHz SH1 is far too slow for this daunting task. 124\item Converting OGG $\rightarrow$ MP3 \\
125 The mp3{}-decoding hardware cannot decode OGG. It can be reprogrammed, but
126 there is too little memory for OGG and we have no documentation on how to
127 program the MAS' DSP. Doing the conversion with the CPU is impossible, since
128 a 12MHz SH1 is far too slow for this daunting task.
101\item Archos Multimedia support!\\ 129\item Archos Multimedia support!\\
102The Archos Multimedia is a completely different beast. It is an entirely different architecture, different CPU and upgrading the software is done a completely different way. We do not wish to venture into this. Others may do so. We won't. 130 The Archos Multimedia is a completely different beast. It is an entirely
131 different architecture, different CPU and upgrading the software is done
132 a completely different way. We do not wish to venture into this. Others
133 may do so. We won't.
103\item Multi{}-band (or graphic) equaliser\\ 134\item Multi{}-band (or graphic) equaliser\\
104We cannot access information for that kind of visualisation from the MP3 decoding hardware. 135 We cannot access information for that kind of visualisation from the MP3
105\item Support other filesystems than FAT32 (likeNTFS or ext2 or whatever)!\\ 136 decoding hardware.
106No. Rockbox needs to support FAT32 since it can only start off a FAT32 partition (since that is the only way the ROM can load it), and adding support for more file systems will just take away valuable ram for unnecessary features. You can partition your Jukebox fine, just make sure the first one is FAT32 and then make the other ones whatever file system you want. Just don't expect Rockbox to understand them. 137\item Support other filesystems than FAT32 (like NTFS or ext2 or whatever)!\\
138 No. Rockbox needs to support FAT32 since it can only start off a FAT32
139 partition (since that is the only way the ROM can load it), and adding
140 support for more file systems will just take away valuable ram for
141 unnecessary features. You can partition your Jukebox fine, just make sure
142 the first one is FAT32 and then make the other ones whatever file system
143 you want. Just don't expect Rockbox to understand them.
107\item Add scandisk{}-like features!\\ 144\item Add scandisk{}-like features!\\
108It would be a very slow operation that would drain the batteries and take a lot of useful ram for something that is much better and faster done when connected to a host computer. 145 It would be a very slow operation that would drain the batteries and
146 take a lot of useful ram for something that is much better and faster
147 done when connected to a host computer.
109\item CBR recording!\\ 148\item CBR recording!\\
110The MP3 encoding hardware does not allow this. 149 The MP3 encoding hardware does not allow this.
111\item Change tempo of a song without changing pitch!\\ 150\item Change tempo of a song without changing pitch!\\
112 The MP3 decoding hardware does not allow this. 151 The MP3 decoding hardware does not allow this.
113\item Graphic frequency (spectrum analyser!)\\ 152\item Graphic frequency (spectrum analyser!)\\
114We can't access the audio waveform from the MP3 decoder so we can't analyse it. Even if we had access to it, the CPU would probably be too slow to perform the analysis anyway. 153 We can't access the audio waveform from the MP3 decoder so we can't analyse
154 it. Even if we had access to it, the CPU would probably be too slow to
155 perform the analysis anyway.
115\item Cool sound effects!\\ 156\item Cool sound effects!\\
116 Adding new sound effects requires reprogramming the MAS chip, and wecan't do that. The MAS chip is programmable, but we have no access to the chip documentation. 157 Adding new sound effects requires reprogramming the MAS chip, and we can't
158 do that. The MAS chip is programmable, but we have no access to the chip
159 documentation.
117\end{itemize} 160\end{itemize}
118} 161}
119 162