summaryrefslogtreecommitdiffstats
path: root/manual/configure_rockbox/playback_options.tex
blob: 5e8383141526f5d4455dc467183434dae0ac0975 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
% $Id$ %
\section{\label{ref:PlaybackOptions}Playback Options}
  The ``Playback Options'' submenu allows you to configure settings related to audio playback.
  \begin{description}
    \item[Shuffle: ]Alters how Rockbox will select which next song to play.\\
      Options: On/Off.
      %
    \item[Repeat: ]Configures settings related to repeating of directories or playlists.\\
      Options: Off/All/One/Shuffle/A--B:
      \begin{description}
        %
        \item[Off: ]The current directory or playlist will not repeat 
          when it is finished.
          \note{If you have the ``Auto change directory'' option set to ``Yes'', 
          Rockbox will move on to the next directory on your hard drive.  If the ``Auto 
          change directory'' option is set to ``No'', playback will stop when the current 
          directory or playlist is finished.}
        %
        \item[All: ]The current directory or playlist will repeat when it is finished.
          \note{This option does \emph{not} shuffle all files on your \dap. 
          Rockbox is playlist oriented. When you play a song, or a directory, or an album, 
          Rockbox creates a playlist and plays it. Thus, to shuffle all songs on the \dap, 
          you need to create a playlist of all songs on the player, and play that playlist 
          with shuffle mode set to ``All''.}
        %
        \item[One: ]Repeat one track over and over.
        %
        \item[Shuffle: ]When the current directory or playlist has finished playing, it 
          will be shuffled and then repeated.
        %
        \item[A--B: ]Repeats between two user defined point within a track, typically
          used by musicians when attempting to learn a piece of music.

          This option is more complicated to use that the others as the \dap\ must first be 
          placed into A--B repeat mode and then the start and end points defined.\\
              \fixme{
              Hold Play and press Left  --- Sets Start Point (A)\\
              Hold Play and press Right --- Sets End Point (B)\\
              }
      \end{description}

    \item[Play Selected First: ]This setting controls what happens when you select a file 
      for playback while shuffle mode is on. If the Play Selected First setting is 
      ``Yes'', the file you selected will be played first. If this setting is ``No'', 
      a random file in the directory will be played first.
   
    \item[Resume: ]Rockbox can be configured to start playing automatically when you turn 
      on the \dap. If the resume function is set to start automatically playing, Rockbox 
      will start at the point where you last turned off the \dap.  The options for the 
      Resume function are:
      \begin{description}
        \item[Yes: ]Rockbox will unconditionally try to resume.
        \item[No:  ]Rockbox will not resume. 
        \emph{If resume is set to ``No,'' Rockbox will start in the File Browser.}
      \end{description}
      \note{Earlier versions of Rockbox had an ``Ask'' setting, which would ask whether 
      to resume when the jukebox was turned on. This setting has been eliminated because it 
      was redundant. If resume is set to ``Yes'' pressing 
      \opt{PLAYER_PAD,RECORDER_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD}{\fixme{FixMe}}
      \opt{ONDIO_PAD}{\fixme{FixMe}}
      \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn}
      on the \dap\ will resume from the point where the \dap\ was stopped before shutdown.

    \item[FFwd/Rewind: ]How fast you want search (fast forward or rewind) to accelerate 
      when you hold down the button. ``Off'' means no acceleration. ``2x/1s'' means double 
      the search speed once every second the button is held. ``2x/5s'' means double the 
      search speed once every 5 seconds the button is held.

    \item[Anti-Skip Buffer: ]This setting allows you to control how much music is stored 
      in the \dap's memory whilst playing a song, acting as a buffer against shock or 
      playback problems.  The \dap\ transfers the selected amount of the forthcoming song 
      into its memory at high speed whilst you are playing the song. It keeps a ``rolling'' 
      buffer, which keeps feeding more of the forthcoming song into memory as it goes along. 
      If the \dap\ is knocked, shaken or jogged heavily while Rockbox is trying to read the 
      hard drive, Rockbox might not be able to read the drive.  Rockbox will retry over and 
      over again until it succeeds, but may eventually reach the end of the memory buffer.  
      When that happens, Rockbox must stop playing and wait for more data from the disk, 
      which causes your music to skip.  The anti-skip setting tells Rockbox how much extra 
      buffer memory to spare to handle this situation.  This setting therefore allows you to 
      reduce the chances of there being a gap or pause during playback of songs.

    \opt{MASCODEC}{The anti-skip buffer can be set to a value between 0 and 7 seconds.}
    \opt{SWCODEC}{The anti-skip buffer can be set to various values between 
      5 seconds and 10 minutes.}

    \note{Having a large anti-skip buffer tends to use more power, and may reduce your 
      battery life. It is recommended to always use the lowest possible setting that allows 
      correct and continuous playback.}

    \item[Fade On Stop/Pause: ]Enables and disables a fade effect when you pause or stop 
      playing a song.  If the Fade on Stop/Pause option is set to ``Yes,'' your music will 
      fade out when you press \fixme{STOP} or \fixme{PAUSE}, and fade in when
      you resume playback.

    \item[Party Mode: ]Enables unstoppable music playback.  When new songs are
      selected, they are 
      added to the end of the current dynamic playlist instead of being played immediately.  
      The \fixme{PLAY} and \fixme{STOP} buttons are disabled.

    \item[Fade On Stop/Pause: ]
      This setting enables and disables a fade effect when you pause or stop playing a song.  
      If the Fade on Stop/Pause option is set to ``Yes,'' your music will fade out when you 
      press \fixme{STOP} or \fixme{PAUSE}, and fade in when you resume playback.

    \opt{SWCODEC}{
    \item[Crossfade: ]
      This setting enables a cross-fader. At the end of a song, the song will fade out as the 
      next song fades in, creating a smooth transition between songs.\\
      Options:
    \begin{description}
      \item[Enable Crossfade: ]If set to ``Off,'' crossfade is disabled. If set to ``Always,'' 
        songs will always cross-fade into one another. If set to ``Shuffle,'' crossfade is 
        enabled when the shuffle feature is set to ``Yes,'' but disabled otherwise.
        %
      \item[Fade In Delay: ]The ``fade in delay'' and ``fade out delay'' control the offset 
        between when the first song starts to fade out and the second song starts to fade in.
        %
      \item[Fade In Duration: ]The length of time, in seconds, that it takes your music to fade in.
        %
      \item[Fade Out Delay: ]The ``fade in delay'' and ``fade out delay'' control the offset 
        between when the first song starts to fade out and the second song starts to fade in.
        %
      \item[Fade Out Duration: ]The length of time, in seconds, that it takes your music to fade out.
        %
      \item[Fade Out Mode: ]If set to ``Crossfade'', one song will fade out and the next song will 
        simultaneously fade in.  If set to ``Mix,'' the currently playing song will fade out 
        according to the fade out settings, but the next song will simply start, without fading in.
    \end{description}
  
    \note{The crossfade setting is particularly effective when the player is set on shuffle.}
    }
  
    \opt{SWCODEC}{
      \item[Replaygain: ]This allows you to control the replaygain function.
        The purpose of replaygain is to adjust the volume of the music played 
        so that all songs (or albums, depending on your settings) have the 
        same apparent volume.  This prevents sudden changes in volume when 
        changing between songs recorded at different volume levels.
        For replaygain to work, the songs must have been processed by a program
        that adds replaygain information to the ID3 tags (vorbis tags 
        respectively).
        \note{APEv2 tags are not currently supported.}

        Options for replaygain are:
        \begin{description}
          \item[Enable Replaygain: ]This turns on/off the replaygain function.
            %
          \item[Prevent Clipping: ]Avoid clipping of a song's waveform.
            If a song would clip during playback, the volume is lowered for 
            that song. Replaygain information is needed for this to work.
            %
          \item[Replaygain type: ]Choose the type of replaygain to apply:
            \begin{description}
              \item[Album Gain: ]Maintain a constant volume level between 
                albums, but keep any intentional volume variations between 
                songs in an album. (If album gain value is not available,
                uses track gain information).
                %
              \item[Track Gain: ]Maintain a constant volume level between 
                tracks. If track gain value is not available, no replaygain 
                is applied.
                %
              \item[Track Gain if Shuffling: ]Maintains a constant volume 
                between tracks if shuffle mode is selected. Reverts to album
                mode if shuffle is off.
            \end{description}
            %
          \item[Pre-Amp: ]This allows you to adjust the volume when replaygain
            is applied. Replaygain often lowers the volume, sometimes quite
            much, so here you can compensate for that. Please note that a 
            (large) positive pre-amp setting can cause clipping, unless 
            prevent clipping is enabled.  The pre-amp can be set to any 
            decibel (dB) value between -12dB and +12dB, in increments of 0.1{}dB.
        \end{description}
        }
    }
 \end{description}