summaryrefslogtreecommitdiff
path: root/manual
diff options
context:
space:
mode:
authorDominik Riebeling <Dominik.Riebeling@gmail.com>2006-04-08 20:08:35 +0000
committerDominik Riebeling <Dominik.Riebeling@gmail.com>2006-04-08 20:08:35 +0000
commit51122c0ab486c7212827309c2ba0b4f6973d8a9c (patch)
treedefcf57b31bc73f409bc47396d0329030e7c7ddb /manual
parentf7aff0acd79530bc7e514ea4c2d3404827f58dbd (diff)
downloadrockbox-51122c0ab486c7212827309c2ba0b4f6973d8a9c.tar.gz
rockbox-51122c0ab486c7212827309c2ba0b4f6973d8a9c.zip
Fix some glitches in "Playback Options".
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@9567 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'manual')
-rwxr-xr-xmanual/configure_rockbox/playback_options.tex92
1 files changed, 52 insertions, 40 deletions
diff --git a/manual/configure_rockbox/playback_options.tex b/manual/configure_rockbox/playback_options.tex
index 64540c6b63..5e83831415 100755
--- a/manual/configure_rockbox/playback_options.tex
+++ b/manual/configure_rockbox/playback_options.tex
@@ -1,3 +1,4 @@
1% $Id$ %
1\section{\label{ref:PlaybackOptions}Playback Options} 2\section{\label{ref:PlaybackOptions}Playback Options}
2 The ``Playback Options'' submenu allows you to configure settings related to audio playback. 3 The ``Playback Options'' submenu allows you to configure settings related to audio playback.
3 \begin{description} 4 \begin{description}
@@ -9,18 +10,18 @@
9 \begin{description} 10 \begin{description}
10 % 11 %
11 \item[Off: ]The current directory or playlist will not repeat 12 \item[Off: ]The current directory or playlist will not repeat
12 when it is finished.\\ 13 when it is finished.
13 \note{Note: If you have the ``Auto change directory'' option set to ``Yes,'' 14 \note{If you have the ``Auto change directory'' option set to ``Yes'',
14 Rockbox will move on to the next directory on your hard drive. If the ``Auto 15 Rockbox will move on to the next directory on your hard drive. If the ``Auto
15 change directory'' option is set to ``No,'' playback will stop when the current 16 change directory'' option is set to ``No'', playback will stop when the current
16 directory or playlist is finished.} 17 directory or playlist is finished.}
17 % 18 %
18 \item[All: ]The current directory or playlist will repeat when it is finished.\\ 19 \item[All: ]The current directory or playlist will repeat when it is finished.
19 \note{Note: this option does \emph{not} shuffle all files on your \dap. 20 \note{This option does \emph{not} shuffle all files on your \dap.
20 Rockbox is playlist oriented. When you play a song, or a directory, or an album, 21 Rockbox is playlist oriented. When you play a song, or a directory, or an album,
21 Rockbox creates a playlist and plays it. Thus, to shuffle all songs on the \dap, 22 Rockbox creates a playlist and plays it. Thus, to shuffle all songs on the \dap,
22 you need to create a playlist of all songs on the player, and play that playlist 23 you need to create a playlist of all songs on the player, and play that playlist
23 with shuffle mode set to ``All.''} 24 with shuffle mode set to ``All''.}
24 % 25 %
25 \item[One: ]Repeat one track over and over. 26 \item[One: ]Repeat one track over and over.
26 % 27 %
@@ -28,7 +29,8 @@
28 will be shuffled and then repeated. 29 will be shuffled and then repeated.
29 % 30 %
30 \item[A--B: ]Repeats between two user defined point within a track, typically 31 \item[A--B: ]Repeats between two user defined point within a track, typically
31 used by musicians when attempting to learn a piece of music.\\ 32 used by musicians when attempting to learn a piece of music.
33
32 This option is more complicated to use that the others as the \dap\ must first be 34 This option is more complicated to use that the others as the \dap\ must first be
33 placed into A--B repeat mode and then the start and end points defined.\\ 35 placed into A--B repeat mode and then the start and end points defined.\\
34 \fixme{ 36 \fixme{
@@ -39,19 +41,19 @@
39 41
40 \item[Play Selected First: ]This setting controls what happens when you select a file 42 \item[Play Selected First: ]This setting controls what happens when you select a file
41 for playback while shuffle mode is on. If the Play Selected First setting is 43 for playback while shuffle mode is on. If the Play Selected First setting is
42 ``Yes,'' the file you selected will be played first. If this setting is ``No,'' 44 ``Yes'', the file you selected will be played first. If this setting is ``No'',
43 a random file in the directory will be played first. 45 a random file in the directory will be played first.
44 46
45 \item[Resume: ]Rockbox can be configured to start playing automatically when you turn 47 \item[Resume: ]Rockbox can be configured to start playing automatically when you turn
46 on the \dap. If the resume function is set to start automatically playing, Rockbox 48 on the \dap. If the resume function is set to start automatically playing, Rockbox
47 will start at the point where you last turned off the \dap. The options for the 49 will start at the point where you last turned off the \dap. The options for the
48 Resume function are:\\ 50 Resume function are:
49 \begin{enumerate} 51 \begin{description}
50 \item[Yes: ]Rockbox will unconditionally try to resume. 52 \item[Yes: ]Rockbox will unconditionally try to resume.
51 \item[No: ]Rockbox will not resume. 53 \item[No: ]Rockbox will not resume.
52 \emph{If resume is set to ``No,'' Rockbox will start in the File Browser.} 54 \emph{If resume is set to ``No,'' Rockbox will start in the File Browser.}
53 \end{enumerate} 55 \end{description}
54 \note{Note: Earlier versions of Rockbox had an "Ask" setting, which would ask whether 56 \note{Earlier versions of Rockbox had an ``Ask'' setting, which would ask whether
55 to resume when the jukebox was turned on. This setting has been eliminated because it 57 to resume when the jukebox was turned on. This setting has been eliminated because it
56 was redundant. If resume is set to ``Yes'' pressing 58 was redundant. If resume is set to ``Yes'' pressing
57 \opt{PLAYER_PAD,RECORDER_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD}{\fixme{FixMe}} 59 \opt{PLAYER_PAD,RECORDER_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD}{\fixme{FixMe}}
@@ -78,17 +80,20 @@
78 reduce the chances of there being a gap or pause during playback of songs. 80 reduce the chances of there being a gap or pause during playback of songs.
79 81
80 \opt{MASCODEC}{The anti-skip buffer can be set to a value between 0 and 7 seconds.} 82 \opt{MASCODEC}{The anti-skip buffer can be set to a value between 0 and 7 seconds.}
81 \opt{SWCODEC}{The anti-skip buffer can be set to various values between 5 seconds and 10 minutes.} 83 \opt{SWCODEC}{The anti-skip buffer can be set to various values between
84 5 seconds and 10 minutes.}
82 85
83 \emph{Tip: }Having a large anti-skip buffer tends to use more power, and may reduce your 86 \note{Having a large anti-skip buffer tends to use more power, and may reduce your
84 battery life. It is recommended to always use the lowest possible setting that allows 87 battery life. It is recommended to always use the lowest possible setting that allows
85 correct and continuous playback. 88 correct and continuous playback.}
86 89
87 \item[Fade On Stop/Pause: ]Enables and disables a fade effect when you pause or stop 90 \item[Fade On Stop/Pause: ]Enables and disables a fade effect when you pause or stop
88 playing a song. If the Fade on Stop/Pause option is set to ``Yes,'' your music will 91 playing a song. If the Fade on Stop/Pause option is set to ``Yes,'' your music will
89 fade out when you press \fixme{STOP} or \fixme{PAUSE}, and fade in when you resume playback. 92 fade out when you press \fixme{STOP} or \fixme{PAUSE}, and fade in when
93 you resume playback.
90 94
91 \item[Party Mode: ]Enables unstoppable music playback. When new songs are selected, they are 95 \item[Party Mode: ]Enables unstoppable music playback. When new songs are
96 selected, they are
92 added to the end of the current dynamic playlist instead of being played immediately. 97 added to the end of the current dynamic playlist instead of being played immediately.
93 The \fixme{PLAY} and \fixme{STOP} buttons are disabled. 98 The \fixme{PLAY} and \fixme{STOP} buttons are disabled.
94 99
@@ -117,48 +122,55 @@
117 % 122 %
118 \item[Fade Out Duration: ]The length of time, in seconds, that it takes your music to fade out. 123 \item[Fade Out Duration: ]The length of time, in seconds, that it takes your music to fade out.
119 % 124 %
120 \item[Fade Out Mode: ]If set to ``Crossfade," one song will fade out and the next song will 125 \item[Fade Out Mode: ]If set to ``Crossfade'', one song will fade out and the next song will
121 simultaneously fade in. If set to ``Mix,'' the currently playing song will fade out 126 simultaneously fade in. If set to ``Mix,'' the currently playing song will fade out
122 according to the fade out settings, but the next song will simply start, without fading in. 127 according to the fade out settings, but the next song will simply start, without fading in.
123 \end{description} 128 \end{description}
124 129
125 \emph{TIP:} The crossfade setting is particularly effective when the player is set on shuffle. 130 \note{The crossfade setting is particularly effective when the player is set on shuffle.}
126 } 131 }
127 132
128 \opt{SWCODEC}{ 133 \opt{SWCODEC}{
129 \item[Replaygain: ]This allows you to control the replaygain function. The purpose of replaygain 134 \item[Replaygain: ]This allows you to control the replaygain function.
130 is to adjust the volume of the music played so that all songs (or albums, depending on your 135 The purpose of replaygain is to adjust the volume of the music played
131 settings) have the same apparent volume. This prevents sudden changes in volume when changing 136 so that all songs (or albums, depending on your settings) have the
132 between songs recorded at different volume levels.\\ 137 same apparent volume. This prevents sudden changes in volume when
133 138 changing between songs recorded at different volume levels.
134 For replaygain to work, the songs must have been processed by a program that adds replaygain 139 For replaygain to work, the songs must have been processed by a program
135 information as ID3 tags (or vorbis tags for certain formats). Note that APEv2 tags are not 140 that adds replaygain information to the ID3 tags (vorbis tags
136 currently supported. 141 respectively).
142 \note{APEv2 tags are not currently supported.}
137 143
138 Options for replaygain are: 144 Options for replaygain are:
139 \begin{description} 145 \begin{description}
140 \item[Enable Replaygain: ]This turns on/off the replaygain function. 146 \item[Enable Replaygain: ]This turns on/off the replaygain function.
141 % 147 %
142 \item[Prevent Clipping: ]Avoid clipping of a song's waveform. If a song would clip during 148 \item[Prevent Clipping: ]Avoid clipping of a song's waveform.
143 playback, the volume is lowered for that song. Replaygain information is needed for this to work. 149 If a song would clip during playback, the volume is lowered for
150 that song. Replaygain information is needed for this to work.
144 % 151 %
145 \item[Replaygain type: ]Choose the type of replaygain to apply: 152 \item[Replaygain type: ]Choose the type of replaygain to apply:
146 \begin{description} 153 \begin{description}
147 \item[Album Gain: ]Maintain a constant volume level between albums, but keep any intentional 154 \item[Album Gain: ]Maintain a constant volume level between
148 volume variations between songs in an album. (If album gain value is not available, uses track 155 albums, but keep any intentional volume variations between
149 gain information). 156 songs in an album. (If album gain value is not available,
157 uses track gain information).
150 % 158 %
151 \item[Track Gain: ]Maintain a constant volume level between tracks. If track gain value is not 159 \item[Track Gain: ]Maintain a constant volume level between
152 available, no replaygain is applied. 160 tracks. If track gain value is not available, no replaygain
161 is applied.
153 % 162 %
154 \item[Track Gain if Shuffling: ]Maintains a constant volume between tracks if shuffle mode is 163 \item[Track Gain if Shuffling: ]Maintains a constant volume
155 selected. Reverts to album mode if shuffle is off. 164 between tracks if shuffle mode is selected. Reverts to album
165 mode if shuffle is off.
156 \end{description} 166 \end{description}
157 % 167 %
158 \item[Pre-Amp: ]This allows you to adjust the volume when replaygain is applied. Replaygain often 168 \item[Pre-Amp: ]This allows you to adjust the volume when replaygain
159 lowers the volume, sometimes quite much, so here you can compensate for that. Please note that a 169 is applied. Replaygain often lowers the volume, sometimes quite
160 (large) positive pre-amp setting can cause clipping, unless prevent clipping is enabled. The 170 much, so here you can compensate for that. Please note that a
161 pre-amp can be set to any decibel (dB) value between -12dB and +12dB, in increments of 0.1 dB. 171 (large) positive pre-amp setting can cause clipping, unless
172 prevent clipping is enabled. The pre-amp can be set to any
173 decibel (dB) value between -12dB and +12dB, in increments of 0.1{}dB.
162 \end{description} 174 \end{description}
163 } 175 }
164 } 176 }