From ede16c7d37507a7335ed1aa9ded02507cfaac8c1 Mon Sep 17 00:00:00 2001
From: Marianne Arnold <pixelma@rockbox.org>
Date: Wed, 12 Sep 2007 21:25:52 +0000
Subject: Fix another fixme: rework of the split editor chapter in the Archos
 manuals. If someone knows how to impelement the explained screenshot in a
 cleaner way that works with both pdf and html version, feel free to improve.

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@14676 a1c6a512-1295-4272-9138-f99709370657
---
 manual/plugins/split_editor.tex | 304 +++++++++++++++++++++-------------------
 1 file changed, 158 insertions(+), 146 deletions(-)

(limited to 'manual/plugins/split_editor.tex')

diff --git a/manual/plugins/split_editor.tex b/manual/plugins/split_editor.tex
index 34fd408..a8ee56d 100644
--- a/manual/plugins/split_editor.tex
+++ b/manual/plugins/split_editor.tex
@@ -1,142 +1,155 @@
 \subsection{Split Editor}
-\fixme{This chapter has to be rewritten, to fit in the multi-platform latex
-source code that we currently use}
+
 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 contains
+desired sound is recorded. This results in recordings that contain
 extra snippets of sound in the beginning and the 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
+split an 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}
-
+original file can be deleted or kept as a backup. %
+%
+The whole process of splitting an mp3 file consists of three steps:
+%
 \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 }
+  \item Defining the split point
+  \item Generating the result files
+  \item If desired deleting the input file (with the browser, not the split editor)
 \end{itemize}
 
-\begin{table}[h!]
-\begin{tabular}{|c|c|c|}
-\hline
-Recorder & Ondio & Function \\\hline
-Off & On/Off & Quit plugin \\\hline
-Left/Right & Left/Right & Move the split point indicator \\\hline
-Up/Down & Up/Down & Zoom in / out \\\hline
-Play & Mode & Play from the split position \\\hline
-F1 & Mode+Left & Enter the save dialogue \\\hline
-F2 & Mode+Up & Toggle loop modes \\\hline
-F3 & Mode+Right & Toggle logarithmic / linear scaling \\\hline
-On+Left & ~ & Play half speed \\\hline
-On+Right & ~ & Play 150\% speed \\\hline
-On+Play & ~ & Play normal speed \\\hline
-\end{tabular}
-\end{table}
-
-\subsubsection{Save the files}
+\subsubsection{How To Use The Split Editor}
+  When the device plays the song just hit the \ActionWpsPlay{} button
+  to pause, when playback has roughly reached the split point. This need
+  not be very precise as the split point can be fine tuned later. A screen
+  similar to the one below will appear.
+
+  \begin{figure}[H]
+    \begin{center}
+      \includegraphics[width=8.0cm]{plugins/images/ss-splitedit-main-112x64x1}
+      \caption{The Split Editor's Main Screen}
+    \end{center}
+  \end{figure}
+
+\subsubsection{The Split Editor's Main Screen}
+  \begin{description}
+    \item[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]
+      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
+      \ButtonLeft\ and \ButtonRight\ buttons. Later, when you have fine tuned
+      the split point, the song will be split at this position.
+      %
+    \item[The split time]
+      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]
+      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]
+      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]
+      On the right side of the bottom line 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
+      \opt{RECORDER_PAD}{\ButtonFThree}
+      \opt{ONDIO_PAD}{\ButtonMenu\ + \ButtonRight}
+      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.
+      More information in the Scale \reference{ref:Scalemode} below.
+      %
+    \item[The loop mode]
+      In the middle of the bottom line the loop mode icon is displayed.
+      There are 4 different loop modes. Pressing
+      \opt{RECORDER_PAD}{\ButtonFTwo}
+      \opt{ONDIO_PAD}{\ButtonMenu\ + \ButtonUp}
+      changes to the next loop mode.
+      %
+      \begin{description}
+        \item
+        \includegraphics[width=0.53cm]{plugins/images/icon-splitedit-loop-1}
+          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
+        \includegraphics[width=0.53cm]{plugins/images/icon-splitedit-loop-2}
+          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
+        \includegraphics[width=0.53cm]{plugins/images/icon-splitedit-loop-3}
+          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
+        \includegraphics[width=0.53cm]{plugins/images/icon-splitedit-loop-4}
+          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{description}
+    \item[Perform the split (8)]
+          The icon above the
+          \opt{RECORDER_PAD}{\ButtonFOne}
+          \opt{ONDIO_PAD}{\ButtonLeft}
+          button indicates its function to execute the split. When split
+          positioning is complete open the save dialogue with
+          \opt{RECORDER_PAD}{\ButtonFOne}
+          \opt{ONDIO_PAD}{\ButtonMenu\ + \ButtonLeft}.
+  \end{description}
+
+  \begin{table}
+    \begin{btnmap}{Controls in the split editor}{}
+      \ButtonOff & Quit plugin \\
+      %
+      \ButtonLeft\ / \ButtonRight &  Move the split point indicator \\
+      %
+      \ButtonUp\ / \ButtonDown & Zoom in / out \\
+      %
+      \opt{RECORDER_PAD}{\ButtonPlay}
+      \opt{ONDIO_PAD}{\ButtonMenu}
+      & Play from the split position \\
+      %
+      \opt{RECORDER_PAD}{\ButtonFOne}
+      \opt{ONDIO_PAD}{\ButtonMenu\ + \ButtonLeft}
+      & Enter the save dialogue \\
+      %
+      \opt{RECORDER_PAD}{\ButtonFTwo}
+      \opt{ONDIO_PAD}{\ButtonMenu\ + \ButtonUp}
+      & Toggle loop modes \\
+      %
+      \opt{RECORDER_PAD}{\ButtonFThree}
+      \opt{ONDIO_PAD}{\ButtonMenu\ + \ButtonRight}
+      & Toggle logarithmic / linear scaling \\
+      \opt{RECORDER_PAD}{
+      %
+      \ButtonOn\ + ButtonLeft
+      & Play half speed \\
+      %
+      \ButtonOn\ + ButtonRight
+      & Play 150\% speed \\
+      %
+      \ButtonOn\ + \ButtonPlay
+      & Play normal speed \\
+    }
+    \end{btnmap}
+  \end{table}
+
+\subsubsection{Save dialogue}
 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
@@ -146,27 +159,25 @@ 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{table}[h!]
-\begin{tabular}{|c|c|c|}
-\hline
-RECORDER & ONDIO & FUNCTION \\\hline
-UP/DOWN & UP/DOWN & Select item \\\hline
-PLAY & RIGHT & Toggle / edit item \\\hline
-\end{tabular}
+\screenshot{plugins/images/ss-splitedit-save}{The Split Editor's
+Save Dialogue}{}
+
+\begin{table}
+  \begin{btnmap}{Controls in the save dialogue}{}
+    \ButtonUp\ / \ButtonDown & Select item \\
+    %
+    \opt{RECORDER_PAD}{\ButtonPlay}
+    \opt{ONDIO_PAD}{\ButtonRight}
+    & Toggle / edit item \\
+    %
+    \ButtonOff & Cancel \\
+  \end{btnmap}
 \end{table}
 
-\subsubsection{Scale}
+\subsubsection{\label{ref:Scalemode}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 /
+peak meter. These can be altered in the peak meter settings,
+see \reference{ref:Peakmetersetting}. If extreme minimum or
 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
@@ -174,6 +185,7 @@ 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. 
+shapes. Note that it is always possible to toggle between the two scale
+modes.
 
 
-- 
cgit v1.1

