From 0aa702836bd0be397c010ebd677bd673b7f900af Mon Sep 17 00:00:00 2001 From: Moshe Piekarski Date: Mon, 16 Nov 2020 18:14:31 -0500 Subject: Manual: remove most HWCODEC artifacts This causes 3 changes in layout. 2 I can't track down and 1 is better this way. Change-Id: If4ad5e1d7431b4c2cbaaf9767d78139ef4e2dc44 --- manual/rockbox_interface/main.tex | 4 - manual/rockbox_interface/tagcache.tex | 7 +- manual/rockbox_interface/wps.tex | 204 ++++++++++++++-------------------- 3 files changed, 87 insertions(+), 128 deletions(-) (limited to 'manual/rockbox_interface') diff --git a/manual/rockbox_interface/main.tex b/manual/rockbox_interface/main.tex index 33dae2f62f..27c6b56e8f 100644 --- a/manual/rockbox_interface/main.tex +++ b/manual/rockbox_interface/main.tex @@ -749,10 +749,8 @@ The default directory structure that is assumed by some parts of Rockbox your music organized in a way different than they assume when attempting to guess the Artist and Album names from your filetree. }% -\opt{swcodec}{ See \reference{ref:Supportedaudioformats} for a list of supported audio formats. -} \subsection{The first contact} @@ -817,13 +815,11 @@ is discussed in more detail in \reference{ref:manage_settings}. The Rockbox distribution comes with some themes that should look nice on your \dap{}. -\opt{lcd_bitmap}{ \note{Some of the themes shipped with Rockbox need additional fonts from the fonts package, so make sure you installed them. Also, if you downloaded additional themes from the Internet make sure you have the needed fonts installed as otherwise the theme may not display properly.} -} \opt{usb_power}{ \section{USB Charging} diff --git a/manual/rockbox_interface/tagcache.tex b/manual/rockbox_interface/tagcache.tex index 8be9a1bd53..3fae3c5c04 100644 --- a/manual/rockbox_interface/tagcache.tex +++ b/manual/rockbox_interface/tagcache.tex @@ -3,9 +3,8 @@ \subsection{Introduction} This chapter describes the Rockbox music database system. Using the information -contained in the tags (ID3v1, ID3v2% - \opt{swcodec}{, Vorbis Comments, Apev2, etc.}% -) in your audio files, Rockbox builds and maintains a database of the music +contained in the tags (ID3v1, ID3v2, Vorbis Comments, Apev2, etc.) in your +audio files, Rockbox builds and maintains a database of the music files on your player and allows you to browse them by Artist, Album, Genre, Song Name, etc. The criteria the database uses to sort the songs can be completely customised. More information on how to achieve this can be found on the Rockbox @@ -63,12 +62,10 @@ its subdirectories will be scanned and added to the database. \item[Update Now] \setting{Update now} causes the database to detect new and deleted files - \opt{swcodec}{ \note{Unlike the \setting{Auto Update} function, \setting{Update Now} will update the database regardless of whether the \setting{Directory Cache} is enabled. Thus, an update using \setting{Update now} may take a long time. - } } Unlike \setting{Initialize Now}, the \setting{Update Now} function does not remove runtime database information. diff --git a/manual/rockbox_interface/wps.tex b/manual/rockbox_interface/wps.tex index 3729590e36..e20ed6737d 100644 --- a/manual/rockbox_interface/wps.tex +++ b/manual/rockbox_interface/wps.tex @@ -3,26 +3,24 @@ The While Playing Screen (WPS) displays various pieces of information about the currently playing audio file. % -\opt{lcd_bitmap}{% - The appearance of the WPS can be configured using WPS configuration files. - The items shown depend on your configuration -- all items can be turned on - or off independently. Refer to \reference{ref:wps_tags} for details on how - to change the display of the WPS. - \begin{itemize} - \item Status bar: The Status bar shows Battery level, charger status, - volume, play mode, repeat mode, shuffle mode\opt{rtc}{ and clock}. - In contrast to all other items, the status bar is always at the top of - the screen. - \item (Scrolling) path and filename of the current song. - \item The ID3 track name. - \item The ID3 album name. - \item The ID3 artist name. - \item Bit rate. VBR files display average bitrate and ``(avg)'' - \item Elapsed and total time. - \item A slidebar progress meter representing where in the song you are. - \item Peak meter. - \end{itemize} -} +The appearance of the WPS can be configured using WPS configuration files. +The items shown depend on your configuration -- all items can be turned on +or off independently. Refer to \reference{ref:wps_tags} for details on how +to change the display of the WPS. +\begin{itemize} +\item Status bar: The Status bar shows Battery level, charger status, + volume, play mode, repeat mode, shuffle mode\opt{rtc}{ and clock}. + In contrast to all other items, the status bar is always at the top of + the screen. +\item (Scrolling) path and filename of the current song. +\item The ID3 track name. +\item The ID3 album name. +\item The ID3 artist name. +\item Bit rate. VBR files display average bitrate and ``(avg)'' +\item Elapsed and total time. +\item A slidebar progress meter representing where in the song you are. +\item Peak meter. +\end{itemize} % See \reference{ref:ConfiguringtheWPS} for details of customising @@ -138,44 +136,43 @@ your WPS (While Playing Screen). \end{btnmap} -\opt{lcd_bitmap}{ - \subsection{\label{ref:peak_meter}Peak Meter} - The peak meter can be displayed on the While Playing Screen and consists of - several indicators. +\subsection{\label{ref:peak_meter}Peak Meter} +The peak meter can be displayed on the While Playing Screen and consists of +several indicators. +\opt{recording}{ + For a picture of the peak meter, please see the While + Recording Screen in \reference{ref:while_recording_screen}. +} +\opt{ipodvideo}{ + \note{Especially the \playerman{} \playertype{}'s performance and battery runtime + suffers when this feature is enabled. For this \dap{} it is highly recommended + to not use peak meter.} +} + +\begin{description} +\item [The bar:] + This is the wide horizontal bar. It represents the current volume value. +\item [The peak indicator:] + This is a little vertical line at the right end of the bar. It indicates + the peak volume value that occurred recently. +\item [The clip indicator:] + This is a little black block that is displayed at the very right of the + scale when an overflow occurs. It usually does not show up during normal + playback unless you play an audio file that is distorted heavily. \opt{recording}{ - For a picture of the peak meter, please see the While - Recording Screen in \reference{ref:while_recording_screen}. - } - \opt{ipodvideo}{ - \note{Especially the \playerman{} \playertype{}'s performance and battery runtime - suffers when this feature is enabled. For this \dap{} it is highly recommended - to not use peak meter.} + If you encounter clipping while recording, your recording will sound distorted. + You should lower the gain. } + \note{Note that the clip detection is not very precise. + Clipping might occur without being indicated.} +\item [The scale:] + Between the indicators of the right and left channel there are little dots. + These dots represent important volume values. In linear mode each dot is a + 10\% mark. In dBFS mode the dots represent the following values (from right + to left): 0~dB, {}-3~dB, {}-6~dB, {}-9~dB, {}-12~dB, {}-18~dB, {}-24~dB, {}-30~dB, + {}-40~dB, {}-50~dB, {}-60~dB. +\end{description} - \begin{description} - \item [The bar:] - This is the wide horizontal bar. It represents the current volume value. - \item [The peak indicator:] - This is a little vertical line at the right end of the bar. It indicates - the peak volume value that occurred recently. - \item [The clip indicator:] - This is a little black block that is displayed at the very right of the - scale when an overflow occurs. It usually does not show up during normal - playback unless you play an audio file that is distorted heavily. - \opt{recording}{ - If you encounter clipping while recording, your recording will sound distorted. - You should lower the gain. - } - \note{Note that the clip detection is not very precise. - Clipping might occur without being indicated.} - \item [The scale:] - Between the indicators of the right and left channel there are little dots. - These dots represent important volume values. In linear mode each dot is a - 10\% mark. In dBFS mode the dots represent the following values (from right - to left): 0~dB, {}-3~dB, {}-6~dB, {}-9~dB, {}-12~dB, {}-18~dB, {}-24~dB, {}-30~dB, - {}-40~dB, {}-50~dB, {}-60~dB. - \end{description} -} \subsection{\label{sec:contextmenu}The WPS Context Menu} Like the context menu for the \setting{File Browser}, the \setting{WPS Context Menu} allows you quick access to some often used functions. @@ -267,7 +264,6 @@ This may even be the whole track. The rate can be changed in two modes: procentual and semitone. Initially, procentual mode is active. - \opt{swcodec}{ If you've enabled the \setting{Timestretch} option in \setting{Sound Settings} and have since rebooted, you can also use timestretch mode. This allows you to change the playback speed @@ -278,73 +274,43 @@ This may even be the whole track. limitations of the algorithm, speed is limited to be between 35\% and 250\% of the current pitch value. Pitch must maintain the same ratio as well as remain between 50\% and 200\%. - } - The value of the \opt{swcodec}{rate, pitch and speed}\nopt{swcodec}{rate} + The value of the rate, pitch and speed is not persistent, i.e. after the \dap\ is turned on it will - always be set to 100\%. \opt{swcodec}{ However, the rate, pitch and speed + always be set to 100\%. However, the rate, pitch and speed information will be stored in any bookmarks you may create (see \reference{ref:Bookmarkconfigactual}) and will be restored upon - playing back those bookmarks.} - - \nopt{swcodec}{ - \begin{btnmap} - \ActionPsToggleMode - & Toggle pitch changing mode. \\ - % - \ActionPsIncSmall{} / \ActionPsDecSmall - & Increase~/ Decrease pitch by 0.1\% (in procentual mode) or by 0.1 - semitone (in semitone mode).\\ - % - \ActionPsIncBig{} / \ActionPsDecBig - & Increase~/ Decrease pitch by 1\% (in procentual mode) or a semitone - (in semitone mode).\\ - % - \ActionPsNudgeLeft{} / \ActionPsNudgeRight - & Temporarily change pitch by 2\% (beatmatch). \\ - % - \ActionPsReset - & Reset rate to 100\%. \\ - % - \ActionPsExit - & Leave the \setting{Pitch Screen}. \\ - % - \end{btnmap} - - \warn{Changing the pitch can cause audible `Artifacts' or `Dropouts'.} - } + playing back those bookmarks. - \opt{swcodec}{ - \begin{btnmap} - \ActionPsToggleMode - \opt{HAVEREMOTEKEYMAP}{& \ActionRCPsToggleMode} - & Toggle pitch changing mode (cycle through all available modes).\\ - % - \ActionPsIncSmall{} / \ActionPsDecSmall - \opt{HAVEREMOTEKEYMAP}{& \ActionRCPsIncSmall{} / \ActionRCPsDecSmall} - & Increase~/ Decrease pitch by 0.1\% (in procentual mode) or 0.1 - semitone (in semitone mode).\\ - % - \nopt{PBELL_VIBE500_PAD}{ % there is no long scroll up or down because of slide - \ActionPsIncBig{} / \ActionPsDecBig - \opt{HAVEREMOTEKEYMAP}{& \ActionRCPsIncBig{} / \ActionRCPsDecBig} - & Increase~/ Decrease pitch by 1\% (in procentual mode) or a semitone - (in semitone mode).\\ - } - % - \ActionPsNudgeLeft{} / \ActionPsNudgeRight - \opt{HAVEREMOTEKEYMAP}{& \ActionRCPsNudgeLeft{} / \ActionRCPsNudgeRight} - & Temporarily change pitch by 2\% (beatmatch), or modify speed (in timestretch mode).\\ - % - \ActionPsReset - \opt{HAVEREMOTEKEYMAP}{& \ActionRCPsReset} - & Reset pitch and speed to 100\%. \\ - % - \ActionPsExit - \opt{HAVEREMOTEKEYMAP}{& \ActionRCPsExit} - & Leave the \setting{Pitch Screen}. \\ - % - \end{btnmap} - } + \begin{btnmap} + \ActionPsToggleMode + \opt{HAVEREMOTEKEYMAP}{& \ActionRCPsToggleMode} + & Toggle pitch changing mode (cycle through all available modes).\\ + % + \ActionPsIncSmall{} / \ActionPsDecSmall + \opt{HAVEREMOTEKEYMAP}{& \ActionRCPsIncSmall{} / \ActionRCPsDecSmall} + & Increase~/ Decrease pitch by 0.1\% (in procentual mode) or 0.1 + semitone (in semitone mode).\\ + % + \nopt{PBELL_VIBE500_PAD}{ % there is no long scroll up or down because of slide + \ActionPsIncBig{} / \ActionPsDecBig + \opt{HAVEREMOTEKEYMAP}{& \ActionRCPsIncBig{} / \ActionRCPsDecBig} + & Increase~/ Decrease pitch by 1\% (in procentual mode) or a semitone + (in semitone mode).\\ + } + % + \ActionPsNudgeLeft{} / \ActionPsNudgeRight + \opt{HAVEREMOTEKEYMAP}{& \ActionRCPsNudgeLeft{} / \ActionRCPsNudgeRight} + & Temporarily change pitch by 2\% (beatmatch), or modify speed (in timestretch mode).\\ + % + \ActionPsReset + \opt{HAVEREMOTEKEYMAP}{& \ActionRCPsReset} + & Reset pitch and speed to 100\%. \\ + % + \ActionPsExit + \opt{HAVEREMOTEKEYMAP}{& \ActionRCPsExit} + & Leave the \setting{Pitch Screen}. \\ + % + \end{btnmap} } -- cgit v1.2.3