From e4b01963c596aa341389246e030f83bb72dff145 Mon Sep 17 00:00:00 2001 From: Martin Arver Date: Sat, 11 Feb 2006 01:28:43 +0000 Subject: Change directory for plugins as well git-svn-id: svn://svn.rockbox.org/rockbox/trunk@8658 a1c6a512-1295-4272-9138-f99709370657 --- manual/chapter5/plugins.tex | 1243 ------------------------------------------- 1 file changed, 1243 deletions(-) delete mode 100644 manual/chapter5/plugins.tex (limited to 'manual/chapter5/plugins.tex') diff --git a/manual/chapter5/plugins.tex b/manual/chapter5/plugins.tex deleted file mode 100644 index e6136c8404..0000000000 --- a/manual/chapter5/plugins.tex +++ /dev/null @@ -1,1243 +0,0 @@ -\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{chapter5/flipit.tex}} - -\opt{player}{\input{chapter5/jackpot.tex}} - -\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{chapter5/minesweeper.tex}} - -\opt{player}{\input{chapter5/nim.tex}} - -\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{chapter5/rockblox.tex}} - -\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{chapter5/sliding.tex}} - -\opt{recorder,recorderv2fm,ondio}{\input{chapter5/snake.tex}} - -\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{chapter5/snake2.tex}} - -\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{chapter5/sokoban.tex}} - -\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{chapter5/solitaire.tex}} - -\opt{recorder,recorderv2fm,ondio}{\input{chapter5/star.tex}} - -\opt{recorder,recorderv2fm}{\input{chapter5/wormlet.tex}} - -\section{Demos} - -\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{chapter5/bounce.tex}} - -\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{chapter5/cube.tex}} - -\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{chapter5/grayscale.tex}} - -{\input{chapter5/hello.tex}} - -\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{chapter5/mandelbrot.tex}} - -\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{chapter5/mosaic.tex}} - -\opt{recorder,recorderv2fm,ondio}{\input{chapter5/oscillograph.tex}} - -\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{chapter5/snow.tex}} - -\opt{recorder,recorderv2fm,ondio}{\input{chapter5/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} -- cgit v1.2.3