diff options
Diffstat (limited to 'manual/configure_rockbox/playback_options.tex')
-rw-r--r-- | manual/configure_rockbox/playback_options.tex | 80 |
1 files changed, 42 insertions, 38 deletions
diff --git a/manual/configure_rockbox/playback_options.tex b/manual/configure_rockbox/playback_options.tex index b34643967d..1cf05eac33 100644 --- a/manual/configure_rockbox/playback_options.tex +++ b/manual/configure_rockbox/playback_options.tex | |||
@@ -3,35 +3,35 @@ | |||
3 | The \setting{Playback} sub menu allows you to configure settings | 3 | The \setting{Playback} sub menu allows you to configure settings |
4 | related to audio playback. | 4 | related to audio playback. |
5 | \begin{description} | 5 | \begin{description} |
6 | \item[Shuffle. ]Turning shuffle on will cause Rockbox to randomly re-order the | 6 | \item[Shuffle]Turning shuffle on will cause Rockbox to randomly re-order the |
7 | playlist. Thus, to shuffle all of the audio files on the player, you first | 7 | playlist. Thus, to shuffle all of the audio files on the player, you first |
8 | need to create a playlist containing all of them. For more information on | 8 | need to create a playlist containing all of them. For more information on |
9 | creating playlists refer to \reference{ref:working_with_playlists}.\\ | 9 | creating playlists refer to \reference{ref:working_with_playlists}.\\ |
10 | Options: \setting{Yes}/\setting{No}. | 10 | Options: \setting{Yes}/\setting{No}. |
11 | % | 11 | % |
12 | \item[Repeat. ]Configures settings related to repeating of directories or | 12 | \item[Repeat]Configures settings related to repeating of directories or |
13 | playlists.\\ | 13 | playlists.\\ |
14 | Options: \setting{Off} / \setting{All} / \setting{One} / \setting{Shuffle} | 14 | Options: \setting{Off} / \setting{All} / \setting{One} / \setting{Shuffle} |
15 | \nopt{ondiosp,ondiofm}{\setting{/A-B}}: | 15 | \nopt{ondiosp,ondiofm}{\setting{/A-B}}: |
16 | \begin{description} | 16 | \begin{description} |
17 | % | 17 | % |
18 | \item[Off. ]The current playlist will not repeat when it is finished. | 18 | \item[Off]The current playlist will not repeat when it is finished. |
19 | \note{If you have the \setting{Auto change directory} option set to | 19 | \note{If you have the \setting{Auto-Change Directory} option set to |
20 | \setting{Yes}, Rockbox will move on to the next directory on your | 20 | \setting{Yes}, Rockbox will move on to the next directory on your |
21 | hard drive. If the \setting{Auto Change Directory} option is set to | 21 | hard drive. If the \setting{Auto-Change Directory} option is set to |
22 | \setting{No}, playback will stop when the current directory or | 22 | \setting{No}, playback will stop when the current directory or |
23 | playlist is finished.} | 23 | playlist is finished.} |
24 | % | 24 | % |
25 | \item[All. ]The current playlist will repeat when it is finished. | 25 | \item[All]The current playlist will repeat when it is finished. |
26 | 26 | ||
27 | % | 27 | % |
28 | \item[One. ]Repeat one track over and over. | 28 | \item[One]Repeat one track over and over. |
29 | % | 29 | % |
30 | \item[Shuffle. ]When the current playlist has finished playing, it will | 30 | \item[Shuffle]When the current playlist has finished playing, it will |
31 | be shuffled and then repeated. | 31 | be shuffled and then repeated. |
32 | % | 32 | % |
33 | \nopt{ondiosp,ondiofm}{ | 33 | \nopt{ondiosp,ondiofm}{ |
34 | \item[A-B. ]Repeats between two user defined points within a track, | 34 | \item[A-B]Repeats between two user defined points within a track, |
35 | typically used by musicians when attempting to learn a piece of music. | 35 | typically used by musicians when attempting to learn a piece of music. |
36 | This option is more complicated to use than the others as the \dap\ | 36 | This option is more complicated to use than the others as the \dap\ |
37 | must first be placed into A-B repeat mode and then the start and end | 37 | must first be placed into A-B repeat mode and then the start and end |
@@ -91,19 +91,19 @@ related to audio playback. | |||
91 | } | 91 | } |
92 | \end{description} | 92 | \end{description} |
93 | 93 | ||
94 | \item[Play Selected First. ]This setting controls what happens when you | 94 | \item[Play Selected First]This setting controls what happens when you |
95 | select a file for playback while shuffle mode is on. If the | 95 | select a file for playback while shuffle mode is on. If the |
96 | \setting{Play Selected First} setting is \setting{Yes}, the file you | 96 | \setting{Play Selected First} setting is \setting{Yes}, the file you |
97 | selected will be played first. If this setting is \setting{No}, a random | 97 | selected will be played first. If this setting is \setting{No}, a random |
98 | file in the directory will be played first. | 98 | file in the directory will be played first. |
99 | 99 | ||
100 | \item[Fast-Forward/Rewind. ]How fast you want search (fast forward or rewind) | 100 | \item[Fast-Forward/Rewind]How fast you want search (fast forward or rewind) |
101 | to accelerate when you hold down the button. \setting{Off} means no | 101 | to accelerate when you hold down the button. \setting{Off} means no |
102 | acceleration. \setting{2x/1s} means double the search speed once every | 102 | acceleration. \setting{2x/1s} means double the search speed once every |
103 | second the button is held. \setting{2x/5s} means double the search speed | 103 | second the button is held. \setting{2x/5s} means double the search speed |
104 | once every 5 seconds the button is held. | 104 | once every 5 seconds the button is held. |
105 | 105 | ||
106 | \item[Anti-Skip Buffer. ]This setting allows you to control how much music is | 106 | \item[Anti-Skip Buffer]This setting allows you to control how much music is |
107 | stored in the \daps{} memory whilst playing a song, acting as a buffer | 107 | stored in the \daps{} memory whilst playing a song, acting as a buffer |
108 | against shock or playback problems. The \dap{} transfers the selected | 108 | against shock or playback problems. The \dap{} transfers the selected |
109 | amount of the forthcoming song into its memory at high speed whilst you are | 109 | amount of the forthcoming song into its memory at high speed whilst you are |
@@ -134,45 +134,45 @@ related to audio playback. | |||
134 | reduce your battery life. It is recommended to always use the lowest | 134 | reduce your battery life. It is recommended to always use the lowest |
135 | possible setting that allows correct and continuous playback.} | 135 | possible setting that allows correct and continuous playback.} |
136 | 136 | ||
137 | \item[Fade on Stop/Pause. ]Enables and disables a fade effect when you | 137 | \item[Fade on Stop/Pause]Enables and disables a fade effect when you |
138 | pause or stop playing a song. If the Fade on Stop/Pause option is | 138 | pause or stop playing a song. If the Fade on Stop/Pause option is |
139 | set to \setting{Yes}, your music will fade out when you stop or pause | 139 | set to \setting{Yes}, your music will fade out when you stop or pause |
140 | playback, and fade in when you resume playback. | 140 | playback, and fade in when you resume playback. |
141 | 141 | ||
142 | \item[Party Mode. ]Enables unstoppable music playback. When new songs are | 142 | \item[Party Mode]Enables unstoppable music playback. When new songs are |
143 | selected, they are queued at the end of the current dynamic playlist | 143 | selected, they are queued at the end of the current dynamic playlist |
144 | instead of being played immediately. Pausing and stopping playback is | 144 | instead of being played immediately. Pausing and stopping playback is |
145 | disabled as well as skipping songs and launching plugins. | 145 | disabled as well as skipping songs and launching plugins. |
146 | 146 | ||
147 | \opt{swcodec}{ | 147 | \opt{swcodec}{ |
148 | \item[Crossfade. ] | 148 | \item[Crossfade] |
149 | This setting enables a cross-fader. At the end of a song, the song will | 149 | This setting enables a cross-fader. At the end of a song, the song will |
150 | fade out as the next song fades in, creating a smooth transition between | 150 | fade out as the next song fades in, creating a smooth transition between |
151 | songs.\\ | 151 | songs.\\ |
152 | Options: | 152 | Options: |
153 | \begin{description} | 153 | \begin{description} |
154 | \item[Enable Crossfade. ]If set to \setting{Off}, crossfade is disabled. | 154 | \item[Enable Crossfade]If set to \setting{Off}, crossfade is disabled. |
155 | If set to \setting{Always}, songs will always crossfade into one | 155 | If set to \setting{Always}, songs will always crossfade into one |
156 | another. If set to \setting{Shuffle}, crossfade is enabled when the | 156 | another. If set to \setting{Shuffle}, crossfade is enabled when the |
157 | shuffle feature is set to \setting{Yes}, but disabled otherwise. If set | 157 | shuffle feature is set to \setting{Yes}, but disabled otherwise. If set |
158 | to track skip only, tracks will only crossfade when you manually change | 158 | to track skip only, tracks will only crossfade when you manually change |
159 | tracks. | 159 | tracks. |
160 | % | 160 | % |
161 | \item[Fade In Delay. ]The ``fade in delay'' is the length of time between | 161 | \item[Fade In Delay]The ``fade in delay'' is the length of time between |
162 | when the crossfade process begins and when the new track begins to fade | 162 | when the crossfade process begins and when the new track begins to fade |
163 | in. | 163 | in. |
164 | % | 164 | % |
165 | \item[Fade In Duration. ]The length of time, in seconds, that it takes | 165 | \item[Fade In Duration]The length of time, in seconds, that it takes |
166 | your music to fade in. | 166 | your music to fade in. |
167 | % | 167 | % |
168 | \item[Fade Out Delay. ]The ``fade out delay'' is the length of time | 168 | \item[Fade Out Delay]The ``fade out delay'' is the length of time |
169 | between when the crossfade process begins and when the old track begins | 169 | between when the crossfade process begins and when the old track begins |
170 | to fade out. | 170 | to fade out. |
171 | % | 171 | % |
172 | \item[Fade Out Duration. ]The length of time, in seconds, that it takes | 172 | \item[Fade Out Duration]The length of time, in seconds, that it takes |
173 | your music to fade out. | 173 | your music to fade out. |
174 | % | 174 | % |
175 | \item[Fade Out Mode. ]If set to \setting{Crossfade}, one song will fade | 175 | \item[Fade Out Mode]If set to \setting{Crossfade}, one song will fade |
176 | out and the next song will simultaneously fade in. If set to | 176 | out and the next song will simultaneously fade in. If set to |
177 | \setting{Mix}, the ending song will continue to play as normal until | 177 | \setting{Mix}, the ending song will continue to play as normal until |
178 | its end, while the starting song will fade in from under it. | 178 | its end, while the starting song will fade in from under it. |
@@ -185,7 +185,7 @@ related to audio playback. | |||
185 | }% | 185 | }% |
186 | 186 | ||
187 | \opt{swcodec}{ | 187 | \opt{swcodec}{ |
188 | \item[Replaygain. ]This allows you to control the replaygain function. | 188 | \item[Replaygain]This allows you to control the replaygain function. |
189 | The purpose of replaygain is to adjust the volume of the music played | 189 | The purpose of replaygain is to adjust the volume of the music played |
190 | so that all songs (or albums, depending on your settings) have the | 190 | so that all songs (or albums, depending on your settings) have the |
191 | same apparent volume. This prevents sudden changes in volume when | 191 | same apparent volume. This prevents sudden changes in volume when |
@@ -196,29 +196,29 @@ related to audio playback. | |||
196 | 196 | ||
197 | Options for replaygain are: | 197 | Options for replaygain are: |
198 | \begin{description} | 198 | \begin{description} |
199 | \item[Enable Replaygain. ]This turns on/off the replaygain function. | 199 | \item[Enable Replaygain]This turns on/off the replaygain function. |
200 | % | 200 | % |
201 | \item[Prevent Clipping. ]Avoid clipping of a song's waveform. | 201 | \item[Prevent Clipping]Avoid clipping of a song's waveform. |
202 | If a song would clip during playback, the volume is lowered for | 202 | If a song would clip during playback, the volume is lowered for |
203 | that song. Replaygain information is needed for this to work. | 203 | that song. Replaygain information is needed for this to work. |
204 | % | 204 | % |
205 | \item[Replaygain type. ]Choose the type of replaygain to apply: | 205 | \item[Replaygain Type]Choose the type of replaygain to apply: |
206 | \begin{description} | 206 | \begin{description} |
207 | \item[Album Gain. ]Maintain a constant volume level between | 207 | \item[Album Gain]Maintain a constant volume level between |
208 | albums, but keep any intentional volume variations between | 208 | albums, but keep any intentional volume variations between |
209 | songs in an album. (If album gain value is not available, | 209 | songs in an album. (If album gain value is not available, |
210 | uses track gain information). | 210 | uses track gain information). |
211 | % | 211 | % |
212 | \item[Track Gain. ]Maintain a constant volume level between | 212 | \item[Track Gain]Maintain a constant volume level between |
213 | tracks. If track gain value is not available, no replaygain | 213 | tracks. If track gain value is not available, no replaygain |
214 | is applied. | 214 | is applied. |
215 | % | 215 | % |
216 | \item[Track Gain if Shuffling. ]Maintains a constant volume | 216 | \item[Track Gain If Shuffling]Maintains a constant volume |
217 | between tracks if \setting{Shuffle} is set to \setting{Yes}. | 217 | between tracks if \setting{Shuffle} is set to \setting{Yes}. |
218 | Reverts to album mode if \setting{Shuffle} is set to \setting{No}. | 218 | Reverts to album mode if \setting{Shuffle} is set to \setting{No}. |
219 | \end{description} | 219 | \end{description} |
220 | % | 220 | % |
221 | \item[Pre-amp. ]This allows you to adjust the volume when replaygain | 221 | \item[Pre-amp]This allows you to adjust the volume when replaygain |
222 | is applied. Replaygain often lowers the volume, sometimes quite | 222 | is applied. Replaygain often lowers the volume, sometimes quite |
223 | much, so here you can compensate for that. Please note that a | 223 | much, so here you can compensate for that. Please note that a |
224 | (large) positive pre-amp setting can cause clipping, unless | 224 | (large) positive pre-amp setting can cause clipping, unless |
@@ -227,7 +227,7 @@ related to audio playback. | |||
227 | \end{description} | 227 | \end{description} |
228 | } | 228 | } |
229 | \opt{swcodec}{ | 229 | \opt{swcodec}{ |
230 | \item[Beep Volume. ]Controls the volume of the beep that is heard when | 230 | \item[Beep Volume]Controls the volume of the beep that is heard when |
231 | skipping forward or backward between tracks. The beep is disabled when | 231 | skipping forward or backward between tracks. The beep is disabled when |
232 | set to \setting{Off}. | 232 | set to \setting{Off}. |
233 | } | 233 | } |
@@ -238,22 +238,26 @@ related to audio playback. | |||
238 | optical output, set to \setting{Yes} | 238 | optical output, set to \setting{Yes} |
239 | } | 239 | } |
240 | 240 | ||
241 | \item[Auto-Change Directory. ]Control what Rockbox does when it reaches the end | 241 | \item[Auto-Change Directory]Control what Rockbox does when it reaches the end |
242 | of a directory. If \setting{Auto-Change Directory} is set to \setting{Yes}, | 242 | of a directory. If \setting{Auto-Change Directory} is set to \setting{Yes}, |
243 | Rockbox will continue to the next directory. If | 243 | Rockbox will continue to the next directory. If |
244 | \setting{Auto-Change Directory} is set to \setting{No}, playback will stop at | 244 | \setting{Auto-Change Directory} is set to \setting{No}, playback will stop at |
245 | the end of the current playlist. | 245 | the end of the current playlist. Using the \setting{Random} feature requires |
246 | you to first generate a folder list via the Random Folder Advance Configuration | ||
247 | plugin (see \reference{ref:random_folder_advance_config}). | ||
246 | \note{You must have the \setting{Repeat} option set to \setting{No} for | 248 | \note{You must have the \setting{Repeat} option set to \setting{No} for |
247 | \setting{Auto-Change Directory} to function properly.} | 249 | \setting{Auto-Change Directory} to function properly.} |
250 | \note{This feature only works when songs have been played from the file | ||
251 | browser. Using it with the database may cause unexpected behavior.} | ||
248 | 252 | ||
249 | % | 253 | % |
250 | \opt{headphone_detection}{ | 254 | \opt{headphone_detection}{ |
251 | \item[Pause on headphone unplug.] Enables and disables automatic pausing of | 255 | \item[Pause on Headphone Unplug] Enables and disables automatic pausing of |
252 | playback when the headphones are disconnected from the \daps{} headphone | 256 | playback when the headphones are disconnected from the \daps{} headphone |
253 | socket. | 257 | socket. |
254 | % | 258 | % |
255 | \begin{description} | 259 | \begin{description} |
256 | \item[Pause on headphone unplug. ]Options for automatic pause: | 260 | \item[Pause on Headphone Unplug]Options for automatic pause: |
257 | \begin{description} | 261 | \begin{description} |
258 | \item[Off.] Disables automatic pause. | 262 | \item[Off.] Disables automatic pause. |
259 | % | 263 | % |
@@ -262,10 +266,10 @@ related to audio playback. | |||
262 | \item[Pause and Resume.] Pauses when the headphones are removed, and | 266 | \item[Pause and Resume.] Pauses when the headphones are removed, and |
263 | resumes playback when they are reconnected. | 267 | resumes playback when they are reconnected. |
264 | \end{description} | 268 | \end{description} |
265 | \item[Duration to rewind.] Number of seconds (between 0 and 15) to rewind | 269 | \item[Duration to Rewind] Number of seconds (between 0 and 15) to rewind |
266 | playback when the headphones are removed. | 270 | playback when the headphones are removed. |
267 | % | 271 | % |
268 | \item[Disable auto-resume if phones not present.] This option will disable | 272 | \item[Disable Auto-Resume If Phones Not Present] This option will disable |
269 | the automatic resumption of playback at startup if the headphones are not | 273 | the automatic resumption of playback at startup if the headphones are not |
270 | connected to the \dap{}. | 274 | connected to the \dap{}. |
271 | \note{This requires \setting{Resume on Startup} to be enabled.} | 275 | \note{This requires \setting{Resume on Startup} to be enabled.} |
@@ -273,7 +277,7 @@ related to audio playback. | |||
273 | 277 | ||
274 | }% | 278 | }% |
275 | 279 | ||
276 | \item[Last.fm Log.]\index{Last.fm Log}\index{Audioscrobbler|see{Last.fm Log}} | 280 | \item[Last.fm Log]\index{Last.fm Log}\index{Audioscrobbler|see{Last.fm Log}} |
277 | Enables logging of your played tracks for submittal to | 281 | Enables logging of your played tracks for submittal to |
278 | \url{http://www.last.fm}. This service was formely known as | 282 | \url{http://www.last.fm}. This service was formely known as |
279 | \emph{Audioscrobbler}. When you enable this option, you'll have to reboot to | 283 | \emph{Audioscrobbler}. When you enable this option, you'll have to reboot to |
@@ -284,7 +288,7 @@ related to audio playback. | |||
284 | \note{See \wikilink{LastFMLog} for a further description, and for tools you | 288 | \note{See \wikilink{LastFMLog} for a further description, and for tools you |
285 | can use to submit your Last.fm log.} | 289 | can use to submit your Last.fm log.} |
286 | 290 | ||
287 | \item[Cuesheet Support.]\index{Cuesheet Support} | 291 | \item[Cuesheet Support]\index{Cuesheet Support} |
288 | Enables reading of cuesheet files for played tracks. If a cuesheet is found | 292 | Enables reading of cuesheet files for played tracks. If a cuesheet is found |
289 | for a track, track markers are displayed on the progressbar and it is | 293 | for a track, track markers are displayed on the progressbar and it is |
290 | possible to skip between the tracks within the cuesheet. Also the information | 294 | possible to skip between the tracks within the cuesheet. Also the information |