summaryrefslogtreecommitdiffstats
path: root/manual/plugins/main.tex
diff options
context:
space:
mode:
Diffstat (limited to 'manual/plugins/main.tex')
-rw-r--r--manual/plugins/main.tex1243
1 files changed, 1243 insertions, 0 deletions
diff --git a/manual/plugins/main.tex b/manual/plugins/main.tex
new file mode 100644
index 0000000000..2a53337a6b
--- /dev/null
+++ b/manual/plugins/main.tex
@@ -0,0 +1,1243 @@
+\chapter{Plugins}
+\newpage
+Plugins are little programs that Rockbox can load and run. Plugins have
+the file extension .rock. Most of them can be started from the main
+menu if you put them in the \textbf{/.rockbox/rocks} directory. Press
+PLAY on them to start them.
+
+Viewer plugins get started automatically by
+``playing'' an associated file (i.e. text
+files, chip8 games), or from the ``Open with'' option on the File menu.
+
+Plugins listed here have the platforms they run under (Player for
+Jukebox players, Recorder for Jukebox recorders including Jukebox FM,
+and Ondio for the Ondio SP and FM). If no platforms are listed then
+the plugin runs on all Rockbox platforms.\\
+
+\textbf{The plugin loader}
+Only one plugin can be loaded at a time. Plugins run in the GUI thread
+and have exclusive control over the user interface. This means you
+cannot switch back and forth between a plugin and Rockbox. A plugin is
+loaded, run and then exited, which returns control to Rockbox. Music
+will carry on playing whilst plugins are being run.
+
+\section{Games}
+See also the Chip{}-8 emulator on page \pageref{ref:Chip8emulator}.
+
+\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/flipit.tex}}
+
+\opt{player}{\input{plugins/jackpot.tex}}
+
+\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/minesweeper.tex}}
+
+\opt{player}{\input{plugins/nim.tex}}
+
+\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/rockblox.tex}}
+
+\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/sliding.tex}}
+
+\opt{recorder,recorderv2fm,ondio}{\input{plugins/snake.tex}}
+
+\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/snake2.tex}}
+
+\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/sokoban.tex}}
+
+\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/solitaire.tex}}
+
+\opt{recorder,recorderv2fm,ondio}{\input{plugins/star.tex}}
+
+\opt{recorder,recorderv2fm}{\input{plugins/wormlet.tex}}
+
+\section{Demos}
+
+\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/bounce.tex}}
+
+\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/cube.tex}}
+
+\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/grayscale.tex}}
+
+{\input{plugins/hello.tex}}
+
+\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/mandelbrot.tex}}
+
+\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/mosaic.tex}}
+
+\opt{recorder,recorderv2fm,ondio}{\input{plugins/oscillograph.tex}}
+
+\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/snow.tex}}
+
+\opt{recorder,recorderv2fm,ondio}{\input{plugins/vumeter.tex}}
+
+\section{\label{ref:Viewersplugins}Viewers}
+
+Viewers are plugins which are associated with specific file extensions.
+They cannot be run directly but are started by ``playing''
+the associated file. Viewers are stored in the
+\textbf{/.rockbox/viewers/ }directory.
+
+\subsection{\label{ref:Chip8emulator}Chip{}-8 Emulator (Recorder, Ondio)}
+The Chip{}-8 Emulator allows you to play many old chip8 games found on
+the Net. It modifies Rockbox, so file extensions .ch8 will be
+recognised as chip8 games. Just press PLAY on a .ch8 file to start a
+game.
+
+There are lots of tiny Chip8 games (usually only about 256 bytes to a
+couple of KB) which were made popular by the HP48
+calculator's emulator for them. The original Chip8 had
+64x32 pixel graphics, and the new superchip emulator supports 128x64
+graphics, which almost fits on the Recorder's display.
+The only problem is they are based on a 4x4 keyboard, but since most
+games do not use all of the buttons, this can easily be worked around.
+
+Some places where can you can find .ch8 files:
+
+\begin{itemize}
+\item The original chip8 patch had several attached:
+\url{http://sourceforge.net/tracker/index.php?func=detail&aid=628509&group_id=44306&atid=439120}
+\item Check out the HP48 chip games section:
+\url{http://www.hpcalc.org/hp48/games/chip/}
+\item Check out the PC emulator by the guy who wrote the HP48 emulator:
+\url{http://www.pdc.kth.se/~lfo/chip8/CHIP8.htm}
+\item Links to other chip8 emulators:
+\url{http://www.zophar.net/chip8.html}
+\end{itemize}
+
+\subsection{JPEG viewer (Recorder, Ondio)}
+Press PLAY on a .jpg file in order to view the contents using Rockbox's greyscale library. Use the arrow keys to move around the image, PLAY to zoom in
+and ON to zoom out. Press OFF to exit the viewer.
+
+Note: JPEGs that use progressive scan encoding are not supported and will produce an error.
+
+\subsection{Movie Player (Recorder, Ondio)}
+Play movies on your Jukebox! In order to do
+this, movies must be in AVI format, and then converted to .RVF,
+Rockbox's own video format. For more details on how to use this plugin, please see \url{http://www.rockbox.org/twiki/bin/view/Main/VideoTutorial}.
+
+\subsection{Rockbox\_flash (Recorder, Ondio)}
+{\centering\itshape
+ [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=4.059cm,height=2.32cm]{images/rockbox-manual-img57.png}
+ \newline
+Rockbox flash
+\par}
+
+For ``playing'' .UCL files on flashed Jukeboxes. Reprograms the flash memory of
+the Jukebox unit (see page \pageref{ref:Rockboxinflash} for details).
+
+\subsection{Search}
+This plugin can be used on playlists. It searches through the playlist
+that it is opened on looking for any occurrences of the string entered by the
+user. The results of this search are saved to a new playlist,
+\textbf{search\_results.m3u}, within the same directory as the
+original playlist.
+
+\subsection{Sort}
+This plugin takes a file and sorts it in forward alphabetical order. Case is
+ignored. This is useful for ordering playlists generated by the ``Create Playlist'' menu option (see page \pageref{ref:Playlistsubmenu}).
+
+\subsection{Text Viewer}
+This is a Viewer for text files with word wrap. Just press PLAY on a
+.txt file to display it. Has controls to handle various styles of text
+formatting. Has top{}-of{}-file and bottom{}-of{}-file buttons. You
+can view files without a .txt extension by using \textbf{Open with ..}
+from the Play Screen menu
+
+\subsubsection{Controls}
+
+\begin{itemize}
+\item \textbf{F1 (Recorder) / ON{}-MINUS (Player): }
+toggles Word mode between Wrap and Chop:
+
+\begin{itemize}
+\item Wrap breaks lines at white space or hyphen.
+\item Chop breaks lines at the maximum column limit.
+\end{itemize}
+
+\item \textbf{F2 (Recorder) / ON{}-MENU{}-PLUS (Player): }
+cycles Line mode through Normal, Join and Expand:
+
+\begin{itemize}
+\item Normal breaks lines at newline characters.
+\item Join ignores unpaired newline characters (i.e., joins lines). Useful for
+adopting the orphans that occur with e{}-mail style (i.e.,pre{}-wrapped) text files.
+\item Expand doubles unpaired newlines (i.e., adds a blank line). Useful
+for making the paragraphs clearer in some book style text files.
+\end{itemize}
+
+\item \textbf{F3 (Recorder) / ON{}-PLUS (Player):}
+toggles View mode between Narrow and Wide:
+
+\begin{itemize}
+\item Narrow sets maximum column to the screen width.
+\item Wide sets maximum column to 114. Useful for navigating large
+files. (Currently, Wide and Join cannot be selected together.)
+\end{itemize}
+
+\item \textbf{ON{}-F1 (Recorder):}
+toggles Page mode between Normal and Overlap:
+
+\begin{itemize}
+\item Normal sets page{}-down/page{}-up to one full screen.
+\item Overlap tells page{}-down/page{}-up to retain one line from
+previous screen.
+\end{itemize}
+
+\item \textbf{ON{}-F3 (Recorder):}
+toggles Scrollbar mode, for the current View mode.
+
+\begin{itemize}
+\item Narrow mode has no scrollbar by default, until toggled.
+\item Wide mode has a scrollbar by default, until toggled.
+\item If file fits on one screen, there is no scrollbar and ON{}-F3 has
+no effect.
+\end{itemize}
+\end{itemize}
+
+Settings are not remembered after the viewer has been exited.
+Keys are as follows:
+
+\subsubsection{Recorder}
+
+\begin{tabular}[c]{|p{3.317cm}|p{7.104cm}|}
+\hline
+{\centering\bfseries\itshape
+KEY
+\par}
+&
+{\centering\bfseries\itshape
+ACTION
+\par}
+\\\hline
+{\centering
+UP
+\par}
+&
+Page{}-up (one screen up)
+\\\hline
+{\centering
+DOWN
+\par}
+&
+Page{}-down (one screen down)
+\\\hline
+{\centering
+LEFT
+\par}
+&
+Top of file (Narrow mode)\newline
+One screen left (Wide mode)
+\\\hline
+{\centering
+RIGHT
+\par}
+&
+Bottom of file (Narrow mode)\newline
+One screen right (Wide mode)
+\\\hline
+{\centering
+ON{}-UP
+\par}
+&
+One line up
+\\\hline
+{\centering
+ON{}-DOWN
+\par}
+&
+One line down
+\\\hline
+{\centering
+ON{}-LEFT
+\par}
+&
+One column left
+\\\hline
+{\centering
+ON{}-RIGHT
+\par}
+&
+One column right
+\\\hline
+{\centering
+OFF
+\par}
+&
+Exit text viewer
+\\\hline
+\end{tabular}
+
+\subsubsection{Player}
+
+\begin{tabular}[c]{|p{3.291cm}|p{7.131cm}|}
+\hline
+{\centering\bfseries\itshape
+KEY
+\par}
+&
+{\centering\bfseries\itshape
+ACTION
+\par}
+\\\hline
+{\centering
+MINUS
+\par}
+&
+Page{}-up (one screen up)
+\\\hline
+{\centering
+PLUS
+\par}
+&
+Page{}-down (one screen down)
+\\\hline
+{\centering
+MENU MINUS
+\par}
+&
+Top of file (Narrow mode)\newline
+One screen left (Wide mode)
+\\\hline
+{\centering
+MENU PLUS
+\par}
+&
+Bottom of file (Narrow mode)\newline
+One screen right (Wide mode)
+\\\hline
+{\centering
+STOP
+\par}
+&
+Exit text viewer
+\\\hline
+\end{tabular}
+
+\subsubsection{Compatibility}
+
+\begin{itemize}
+\item Correctly reads plain text files in Unix, Win/DOS, or Macintosh
+format. Latin{}-alphabet Unicode files are a l m o s t r e a d a b l
+e.
+\item Currently prefers fixed{}-width fonts. With proportional fonts,
+pretends all characters are the width of a lower{}-case 'o'.
+\item Currently messages are in English
+\item Does not currently support right{}-to{}-left languages.
+\end{itemize}
+
+\subsection{VBRfix}
+This function scans a VBR (Variable Bitrate)
+MP3 file and updates/creates the Xing VBR header. The Xing header
+contains information about the VBR stream used to calculate average bit
+rate, time information and to more accurately fwd/rew in the stream.
+
+This function is especially useful when the playback of a file skips,
+fwd/rew does not work correctly or the time display is incorrect. Run
+VBRfix on files you record with your Jukebox. The header is not present
+in the recorded files and VBRfix adds this header.
+
+Note: VBRfix can only run when music is
+turned off (since it uses the same memory as the player) and can take a
+while to complete if run on big files.
+
+\section{Applications}
+
+\subsection{Battery\_test}
+{\centering\itshape
+ [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=3.704cm,height=2.117cm]{images/rockbox-manual-img58.png}
+ \textmd{ } [Warning: Image ignored]
+% Unhandled or unsupported graphics:
+%\includegraphics[width=4.598cm,height=1.976cm]{images/rockbox-manual-img59.png}
+ \newline
+ Recorder battery test Player battery test
+\par}
+
+This plugin simulates normal power drain by spinning up the disk and
+reading a big file once every 90 seconds (or thereabouts). Each
+spin up also writes the battery level to a
+log file. The test stops when battery level reaches 4\% in order to
+avoid being unable to write to the disk. The power usage data is saved
+to a file in the root directory of the Jukebox. This plugin can
+sometimes be useful for diagnosing problems with battery charging.
+
+\subsection{Calculator (Recorder, Ondio)}
+{\centering\itshape
+ [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=3.889cm,height=2.223cm]{images/rockbox-manual-img60.png}
+ \newline
+Calculator
+\par}
+
+This is a simple scientific calculator for
+use on the Jukebox. It works like a standard calculator. Move using
+the arrow keys and press PLAY to press a button. Pressing the ``1st''
+button will toggle between other available maths functions on the right
+hand side.
+
+\subsection{Calendar (Recorder, Ondio)}
+{\centering\itshape
+ [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=3.9cm,height=2.23cm]{images/rockbox-manual-img61.png}
+ \newline
+Calendar
+\par}
+
+This is a small and simple calendar application with memo saving function.
+
+Dots indicate dates with memos. To add a new memo press PLAY on the
+date. Includes one off, annual, monthly, and weekly memos:
+
+\begin{tabular}[c]{|p{2.6469998cm}|p{3.95cm}|}
+\hline
+{\centering\bfseries\itshape
+KEY
+\par}
+&
+{\centering\bfseries\itshape
+ACTION
+\par}
+\\\hline
+{\centering
+PLAY
+\par}
+&
+monthly
+\\\hline
+{\centering
+LEFT
+\par}
+&
+weekly
+\\\hline
+{\centering
+RIGHT
+\par}
+&
+annually
+\\\hline
+{\centering
+ON
+\par}
+&
+one off
+\\\hline
+{\centering
+STOP
+\par}
+&
+exit
+\\\hline
+\end{tabular}
+
+\subsection{Chess Clock}
+{\centering\itshape
+ [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=4.634cm,height=1.984cm]{images/rockbox-manual-img62.png}
+ \newline
+Chess Clock
+\par}
+
+The chess clock plugin is designed to
+simulate a chess clock, but it can be used
+in any kind of game with up to ten players.
+
+\subsubsection{Setup}
+
+\begin{itemize}
+\item First enter the number of players (1{}-10) (press PLAY to
+continue).
+\item Then set the total game time in mm:ss (press PLAY to continue,
+STOP to go back).
+\item Then the maximum round time is entered. For example, this could
+be used to play Scrabble for a maximum of 15 minutes each, with each
+round taking no longer than one minute. (press PLAY to continue).
+\item Done. Player 1 starts in paused mode. So press PLAY to start.
+\end{itemize}
+
+\subsubsection{While playing}
+The number of the current player is displayed on the top line. The time
+below is the time remaining for that round (and possibly also the total
+time left if different).
+
+Keys are as follows:
+
+\begin{center}\begin{tabular}{|p{1.917cm}|p{2.7649999cm}|p{1.7049999cm}|p{9.433001cm}|}
+\hline
+{\centering\bfseries\itshape
+PLAYER
+\par}
+&
+{\centering\bfseries\itshape
+RECORDER
+\par}
+&
+{\centering\bfseries\itshape
+ONDIO
+\par}
+&
+{\centering\bfseries\itshape
+FUNCTION
+\par}
+\\\hline
+{\centering
+ON
+\par}
+&
+{\centering
+OFF
+\par}
+&
+{\centering
+ONOFF
+\par}
+&
+Exit plugin
+\\\hline
+{\centering
+STOP
+\par}
+&
+{\centering
+LEFT
+\par}
+&
+{\centering
+LEFT
+\par}
+&
+Restart round for the player
+\\\hline
+{\centering
+PLAY
+\par}
+&
+{\centering
+PLAY
+\par}
+&
+{\centering
+RIGHT
+\par}
+&
+Pausing the time (press again to continue)
+\\\hline
+{\centering
+RIGHT
+\par}
+&
+{\centering
+UP
+\par}
+&
+{\centering
+UP
+\par}
+&
+Switch to next player
+\\\hline
+{\centering
+LEFT
+\par}
+&
+{\centering
+DOWN
+\par}
+&
+{\centering
+DOWN
+\par}
+&
+Switch to previous player
+\\\hline
+{\centering
+MENU
+\par}
+&
+{\centering
+F1
+\par}
+&
+{\centering
+MODE
+\par}
+&
+Enter a simple menu
+\\\hline
+\end{tabular}\end{center}
+From the menu it is possible to delete a player, modify the round time
+for the current player or set the total time for the game.
+
+When the round time is up for a player the message ``ROUND UP!'' is shown (press NEXT to continue).
+
+When the total time is up for a player the message ``TIME UP!''is shown. Then player will then be removed from the timer.
+
+\subsection{Clock (Recorder)}
+{\centering\itshape
+ [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=3.528cm,height=2.016cm]{images/rockbox-manual-img63.png}
+ \newline
+Clock
+\par}
+
+This is a fully featured analogue and digital clock program.
+
+\subsubsection{Key configuration}
+
+\begin{center}\begin{tabular}{|p{2.411cm}|p{6.012cm}|}
+\hline
+{\centering\bfseries\itshape
+KEY
+\par}
+&
+{\centering\bfseries\itshape
+ACTION
+\par}
+\\\hline
+{\centering
+F1
+\par}
+&
+Help
+\\\hline
+{\centering
+F2
+\par}
+&
+Start / Stop stopwatch
+\\\hline
+{\centering
+F2 (Hold)
+\par}
+&
+Reset stopwatch
+\\\hline
+{\centering
+F3
+\par}
+&
+Options
+\\\hline
+{\centering
+Play
+\par}
+&
+Select clock mode
+\\\hline
+{\centering
+UP
+\par}
+&
+Enable idle power off
+\\\hline
+{\centering
+DOWN
+\par}
+&
+Disable idle power off
+\\\hline
+{\centering
+RIGHT
+\par}
+&
+Enable backlight
+\\\hline
+{\centering
+LEFT
+\par}
+&
+Disable backlight
+\\\hline
+{\centering
+OFF
+\par}
+&
+Save settings to disk and exit
+\\\hline
+\end{tabular}\end{center}
+
+\subsubsection{Backlight configuration}
+If RIGHT or LEFT is not pressed during clock operation (with the
+exception of at the Help/Options/Mode Selector/Credit screens) then the
+backlight timeout will remain your Rockbox default setting (example, 15
+seconds). If RIGHT or LEFT is pressed, Clock will set the backlight to
+ON or OFF, respectively. When Clock is exited, your default Rockbox
+setting for Backlight will be restored.
+
+\subsubsection{Saving Settings}
+Settings are saved to disk when Clock is exited. They are saved to
+\textbf{/.rockbox/rocks/.clock\_settings''}. To reset your settings
+back to the defaults, simply navigate to this file using Rockbox,
+highlight it, and press the ON+PLAY keys to get the Delete option. This way you can feel free to experiment with the settings {}- and you could even load
+separate settings, say, one for your desk at home and one for in the car {}- by keeping two files in your \textbf{/.rockbox/rocks} folder such as
+``h.clock\_settings'' and ``c.clock\_settings''. Simply remove the
+``h'' for your home settings to go into effect, or add the ``h'' back and take off the ``c'' for your car settings.
+
+In the future, loading different settings will probably be made easier
+through a built{}-in settings file loader in Clock.
+
+\subsection{Euro Converter (Player)}
+{\centering\itshape
+ [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=4.671cm,height=2cm]{images/rockbox-manual-img64.png}
+ \newline
+Euro converter
+\par}
+
+This plugin converts euros back into pre{}-euro currency. The country for which is does this is selectable by pressing the MENU key. The MINUS and
+PLUS keys move the cursor between the digits and the PLAY and STOP keys
+increase and decrease the current digit. The amount in the old
+currency is displayed on the second line.
+
+\subsection{Favorites}
+{\centering\itshape
+ [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=4.667cm,height=1.998cm]{images/rockbox-manual-img65.png}
+ \newline
+Favorites
+\par}
+
+When listening to any song you can open it with this plugin and it will
+add the current song to a special playlist of all songs you selected in
+\textbf{/favorites.m3u}.
+
+\subsection{Firmware\_flash (Recorder, Ondio)}
+{\centering\mdseries\itshape
+ [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=3.634cm,height=2.076cm]{images/rockbox-manual-img66.png}
+ \newline
+Firmware\_flash
+\par}
+
+Use when flashing Rockbox (see page \pageref{ref:FlashingRockboxReal}.
+In the ideal case, you'll need this tool only once. For safety reasons you may wish to delete \textbf{firmware\_flash.rock} from \textbf{/.rockbox/rocks} once flashing is complete.
+
+\subsection{Metronome}
+This plugin can be used as a metronome to keep time during music
+practice. Adjust the tempo though the interface or by tapping it out
+on the appropriate button.
+
+\begin{tabular}[c]{|p{2.587cm}|p{2.55cm}|p{2.62cm}|p{4.952cm}|}
+\hline
+{\centering\bfseries\itshape
+PLAYER
+\par}
+&
+{\centering\bfseries\itshape
+RECORDER
+\par}
+&
+{\centering\bfseries\itshape
+ONDIO
+\par}
+&
+{\centering\bfseries\itshape
+FUNCTION
+\par}
+\\\hline
+{\centering
+STOP
+\par}
+&
+{\centering
+OFF
+\par}
+&
+{\centering
+ONOFF
+\par}
+&
+Exit plugin
+\\\hline
+{\centering
+PLAY
+\par}
+&
+{\centering
+PLAY
+\par}
+&
+{\centering
+~
+\par}
+&
+Start / Stop
+\\\hline
+{\centering
+ON
+\par}
+&
+{\centering
+ON
+\par}
+&
+{\centering
+~
+\par}
+&
+Tap tempo
+\\\hline
+{\centering
+~
+\par}
+&
+{\centering
+~
+\par}
+&
+{\centering
+MODE
+\par}
+&
+Start / Tap tempo
+\\\hline
+{\centering
+~
+\par}
+&
+{\centering
+~
+\par}
+&
+{\centering
+HOLD MODE
+\par}
+&
+Stop
+\\\hline
+{\centering
+MINUS/PLUS
+\par}
+&
+{\centering
+LEFT/RIGHT
+\par}
+&
+{\centering
+LEFT/RIGHT
+\par}
+&
+Adjust tempo
+\\\hline
+{\centering
+ON+MINUS/\newline
+ON+PLUS
+\par}
+&
+{\centering
+UP/DOWN
+\par}
+&
+{\centering
+UP/DOWN
+\par}
+&
+Adjust volume
+\\\hline
+\end{tabular}
+
+\subsection{Split Editor (Recorder, Ondio)}
+When recording an mp3 file, it is common practice to start the recording
+a little bit early and stop it a little bit late to ensure all the
+desired sound is recorded. This results in recordings that contain
+extra snippets of sound and the beginning and end. Unfortunately these
+snippets can not be deleted easily because they are stored in the same
+file as the desired recording. The purpose of the split editor is to
+split a mp3 file (the input file) at a point in time (split point). Two
+new files can be generated from the input file. The first file contains
+the part before the split point and the second file contains the part
+after the split point. Once this process has been successful the
+original file can be deleted or kept as a backup.
+
+The whole process of splitting a mp3 file consists of three steps:
+
+\begin{enumerate}
+\item defining the split point
+\item generating the result files.
+\item if desired delete the input file (with the browser, not the split
+editor)
+\end{enumerate}
+
+\subsubsection{How to use the Split Editor}
+
+\begin{itemize}
+\item \textbf{Pause near the split point}
+When the device plays the song just hit the PAUSE button, when playback
+has roughly reached the split point. This need not be very precise as
+the split point can be fine tuned later.
+\item \textbf{Open the split editor}
+
+Open the plugin. A screen similar to the one below will appear.
+
+{\centering\itshape
+ [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=3.701cm,height=2.11cm]{images/rockbox-manual-img67.gif}
+ \newline
+The Split Editor
+\par}
+
+{\centering\upshape
+Here is an explanation of the areas marked in red on the screenshot.
+\par}
+
+\begin{enumerate}
+\item The waveform \newline
+\newline
+The waveform displays the volume of the song over time. It will appear
+as the song plays and help to visually identify the point in time where
+the split is desired
+\item The split point indicator\newline
+\newline
+The split point indicator is a vertical line with a small triangle at
+the top end. It is the most important control element of the split
+editor. It can be moved with the LEFT and RIGHT buttons. Later, when
+you have fine tuned the split point, the song will be split at this
+position.
+\item The split time\newline
+\newline
+At the top of the window a time value is displayed. This is the point in
+time within the song at which the split point indicator is positioned.
+\item The locator\newline
+\newline
+Another vertical bar represents the position locator. It moves along as
+the song plays. In contrast to the split point indicator it has no
+triangles at the ends.
+\item The time bar\newline
+\newline
+The time bar displays the current position within the song relative to
+the whole song. The entire length of the time bar represents the song
+length. The length of the solid part of the time bar represents the position and length
+of the displayed part of the song.
+\item The scale mode\newline
+\newline
+Directly above the F3 button the scale mode is displayed. The waveform
+can be scaled either logarithmically or linearly. In logarithmic scale
+mode the letters ``dB'' are displayed, in linear mode ``\%''. Use F3 to
+switch between these modes. Linear mode usually gives better optical
+hints with commercially recorded music. For quiet recordings,
+especially of human speech, the logarithmic scale often is preferable.
+\item The loop mode \newline
+\newline
+Directly above the F2 button the loop mode icon is displayed. There are
+4 different loop modes. Pressing F2 changes to the next loop mode.
+
+\begin{itemize}
+\item [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=0.794cm,height=0.476cm]{images/rockbox-manual-img68.gif}
+ Playback loops around the split point indicator. This mode is best
+used when searching and zooming for the desired point at which to split
+the recording.
+\item [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=0.794cm,height=0.476cm]{images/rockbox-manual-img69.gif}
+ Playback loops from the split point indicator to the end of the
+visible area. This mode is best used when fine tuning the split
+indicator position at the beginning of a recording.
+\item [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=0.794cm,height=0.476cm]{images/rockbox-manual-img70.gif}
+ Playback loops from the beginning of the
+visible area to the split point. This mode is best used when fine
+tuning the split indicator position at the end of a recording.
+\item [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=0.688cm,height=0.476cm]{images/rockbox-manual-img71.gif}
+ Playback doesn't loop, the borders of the visible
+area as well as the split point indicator are ignored. This mode is
+best used when playing the song outside of the borders of the displayed
+region.
+\end{itemize}
+
+\item Perform the split \newline
+\newline
+The icon directly above the F1 button indicates its function to execute
+the split. When split positioning is complete open the save dialogue with F1.
+\end{enumerate}
+
+{\bfseries
+Controls in the split editor }
+\end{itemize}
+
+\begin{tabular}[c]{|p{2.975cm}|p{3.047cm}|p{6.649cm}|}
+\hline
+{\centering\bfseries\itshape
+Recorder
+\par}
+&
+{\centering\bfseries\itshape
+Ondio
+\par}
+&
+{\centering\bfseries\itshape
+Function
+\par}
+\\\hline
+{\centering
+Off
+\par}
+&
+{\centering
+On/Off
+\par}
+&
+Quit plugin
+\\\hline
+{\centering
+Left/Right
+\par}
+&
+{\centering
+Left/Right
+\par}
+&
+Move the split point indicator
+\\\hline
+{\centering
+Up/Down
+\par}
+&
+{\centering
+Up/Down
+\par}
+&
+Zoom in / out
+\\\hline
+{\centering
+Play
+\par}
+&
+{\centering
+Mode
+\par}
+&
+Play from the split position
+\\\hline
+{\centering
+F1
+\par}
+&
+{\centering
+Mode+Left
+\par}
+&
+Enter the save dialogue
+\\\hline
+{\centering
+F2
+\par}
+&
+{\centering
+Mode+Up
+\par}
+&
+Toggle loop modes
+\\\hline
+{\centering
+F3
+\par}
+&
+{\centering
+Mode+Right
+\par}
+&
+Toggle logarithmic / linear scaling
+\\\hline
+{\centering
+On+Left
+\par}
+&
+{\centering
+~
+\par}
+&
+Play half speed
+\\\hline
+{\centering
+On+Right
+\par}
+&
+{\centering
+~
+\par}
+&
+Play 150\% speed
+\\\hline
+{\centering
+On+Play
+\par}
+&
+{\centering
+~
+\par}
+&
+Play normal speed
+\\\hline
+\end{tabular}
+
+\subsubsection{Save the files}
+In the save dialogue it is possible to specify which of the files you
+want to save and their names. When finished, select
+``Save'' and the files will be written to
+disk. Note that files can not be overwritten, so filenames that
+don't exist yet must be chosen. If unsure whether the
+file already exists simply try to save it. If another file with this
+name exists the dialogue will return and you can choose another
+filename
+
+{\centering\itshape
+ [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=3.701cm,height=2.11cm]{images/rockbox-manual-img72.gif}
+ \newline
+Save dialogue
+\par}
+
+Controls in the save dialogue
+\begin{tabular}[c]{|p{2.62cm}|p{2.266cm}|p{3.965cm}|}
+\hline
+{\centering\bfseries\itshape
+RECORDER
+\par}
+&
+{\centering\bfseries\itshape
+ONDIO
+\par}
+&
+{\centering\bfseries\itshape
+FUNCTION
+\par}
+\\\hline
+{\centering
+UP/DOWN
+\par}
+&
+{\centering
+UP/DOWN
+\par}
+&
+Select item
+\\\hline
+{\centering
+PLAY
+\par}
+&
+{\centering
+RIGHT
+\par}
+&
+Toggle / edit item
+\\\hline
+\end{tabular}
+
+\subsubsection{Scale}
+The values in the waveform are scaled according to the settings of the
+peak meter. These can be altered in the menu
+\textbf{General Settings {}-{\textgreater} Display{}-{\textgreater} Peak Meter}. If extreme minimum /
+maximum values are set the waveform might be cut off. A minimum
+setting of {}-60 dB and a maximum setting of 0 dB are recommended.
+These settings should be capable of producing useful waveforms for very
+soft sounds in logarithmic mode (dB). When the editor is used on loud
+sounds (such as commercial rock or pop music) switching to the linear
+scale may prove more effective since the logarithmic scale compresses
+loud noises and makes it more difficult to identify characteristic
+shapes. Note that it is always possible to toggle the scale with F3.
+
+\subsection{Stopwatch}
+{\centering\itshape
+ [Warning: Image ignored] % Unhandled or unsupported graphics:
+%\includegraphics[width=3.704cm,height=2.117cm]{images/rockbox-manual-img73.png}
+ \textmd{ } [Warning: Image ignored]
+% Unhandled or unsupported graphics:
+%\includegraphics[width=4.667cm,height=1.998cm]{images/rockbox-manual-img74.png}
+ \newline
+Recorder stopwatch Player stopwatch
+\par}
+
+A simple stopwatch program with support for saving times.
+
+\subsubsection{Keys are as follows:}
+
+\begin{tabular}[c]{|p{2.9029999cm}|p{2.763cm}|p{2.199cm}|p{5.235cm}|}
+\hline
+{\centering\bfseries\itshape
+PLAYER
+\par}
+&
+{\centering\bfseries\itshape
+RECORDER
+\par}
+&
+{\centering\bfseries\itshape
+ONDIO
+\par}
+&
+{\centering\bfseries\itshape
+FUNCTION
+\par}
+\\\hline
+{\centering
+MENU
+\par}
+&
+{\centering
+OFF
+\par}
+&
+{\centering
+ONOFF
+\par}
+&
+Quit Plugin
+\\\hline
+{\centering
+PLAY
+\par}
+&
+{\centering
+PLAY
+\par}
+&
+{\centering
+RIGHT
+\par}
+&
+Start / stop
+\\\hline
+{\centering
+STOP
+\par}
+&
+{\centering
+LEFT
+\par}
+&
+{\centering
+LEFT
+\par}
+&
+Reset timer
+\\\hline
+{\centering
+ON
+\par}
+&
+{\centering
+ON
+\par}
+&
+{\centering
+MODE
+\par}
+&
+Take lap time
+\\\hline
+{\centering
+MINUS/PLUS
+\par}
+&
+{\centering
+DOWN/UP
+\par}
+&
+{\centering
+DOWN/UP
+\par}
+&
+Scroll through lap times
+\\\hline
+\end{tabular}