blob: 17b8059846c8e2f7f6aafd54cb9536f95e5abf46 [file] [log] [blame]
Dominik Riebeling87d55362006-04-09 11:42:56 +00001% $Id$ %
Martin Arver70295bf2006-04-27 12:25:08 +00002\screenshot{configure_rockbox/images/ss-sound-settings}{The sound settings screen}{}
Michael DiFebbo25f9cec2006-03-27 19:30:05 +00003
Thom Johansen3a742082008-07-14 22:47:40 +00004The sound settings menu offers a selection of sound settings you may
Martin Arverf8e2f3e2006-10-17 12:18:51 +00005change to customise your listening experience.
Michael DiFebbo25f9cec2006-03-27 19:30:05 +00006
Marc Guay6f2613f2008-07-07 13:22:14 +00007\section{\label{ref:volume}Volume}
Nils Wallménius5fab9fc2007-01-29 17:03:56 +00008 This setting adjusts the volume of your music. Like most professional
9 audio gear and many consumer audio products, Rockbox uses a decibel scale
Andree Buschmann1248e9c2010-04-14 20:38:21 +000010 where 0~dB is a reference that indicates the maximum volume that the \dap{}
Nils Wallménius5fab9fc2007-01-29 17:03:56 +000011 can produce without possible distortion (clipping). All values lower than
12 this reference will be negative and yield a progressively softer volume.
Marianne Arnoldb43b4932011-01-17 18:30:18 +000013 \nopt{iriverh100,iriverh300,ondavx777}{%
Marianne Arnold5b47b892010-08-16 09:43:48 +000014 Values higher than 0~dB are available and can be used to raise the
15 volume more than would otherwise be possible. These volume levels will
16 ordinarily lead to distorted sound, but might work nicely for music that has
17 an otherwise low volume level.
18 }
Thom Johansen89e411b2006-08-18 16:12:29 +000019 The volume can be adjusted from a
Andree Buschmann1248e9c2010-04-14 20:38:21 +000020 \opt{player}{minimum of -78~dB to a maximum of +18~dB.}%
21 \opt{recorder,recorderv2fm,ondio}{minimum of -100~dB to a maximum of +12~dB.}%
Marianne Arnoldb43b4932011-01-17 18:30:18 +000022 \opt{iriverh100,iriverh300}{minimum of -84~dB to a maximum of 0~dB.}%
Marcin Bukata434a0d2010-11-09 22:10:38 +000023 \opt{iaudiom3,iaudiom5,iaudiox5,ipod3g,ipod4g,gigabeatf,mrobe100,mpiohd200}{%
Marianne Arnold5b47b892010-08-16 09:43:48 +000024 minimum of -73~dB to a maximum of +6~dB.}%
Andree Buschmann1248e9c2010-04-14 20:38:21 +000025 \opt{ipodnano}{minimum of -72~dB to a maximum of +6~dB.}%
Andree Buschmannf0e1cf02010-05-30 18:29:04 +000026 \opt{ipodvideo,cowond2}{minimum of -89~dB to a maximum of +6~dB.}%
Marianne Arnoldb43b4932011-01-17 18:30:18 +000027 \opt{ipodnano2g,ipodcolor,ipod1g2g,iriverh10,iriverh10_5gb,sansa,sansaAMS}{minimum of
Marianne Arnold5b47b892010-08-16 09:43:48 +000028 -74~dB to a maximum of +6~dB.}%
Andree Buschmann1248e9c2010-04-14 20:38:21 +000029 \opt{gigabeats}{minimum of -90~dB to a maximum of +6~dB.}%
Szymon Dzioka09152b2010-04-15 18:35:41 +000030 \opt{gigabeatf,vibe500}{minimum of -74~dB to a maximum of +6~dB.}%
Andree Buschmann1248e9c2010-04-14 20:38:21 +000031 \opt{ipodvideo}{\\Remark: Lowering the volume below -57~dB will also affect the line-out
Andree Buschmann934e6f02010-01-23 19:28:26 +000032 and the recording gain.}
Andree Buschmannf0e1cf02010-05-30 18:29:04 +000033 \opt{cowond2}{\\Remark: Lowering the volume below -57~dB will also affect the line-out.}
Alex Parker011bece2010-09-16 18:54:24 +000034
35\nopt{gigabeats}{
Michael DiFebboc1ecc632006-04-01 15:41:21 +000036\section{Bass}
Thom Johansen3a742082008-07-14 22:47:40 +000037 This setting emphasises
Marianne Arnoldb43b4932011-01-17 18:30:18 +000038 \nopt{iriverh100,iriverh300}{or suppresses}
Andree Buschmann1248e9c2010-04-14 20:38:21 +000039 the lower (bass) frequencies in the sound. A value of 0~dB means that bass
Thom Johansen3a742082008-07-14 22:47:40 +000040 sounds are unaltered (flat response).
Andree Buschmann1248e9c2010-04-14 20:38:21 +000041 \opt{masd}{The minimum setting is -15~dB and the maximum is 15~dB.}%
42 \opt{masf}{The minimum setting is -12~dB and the maximum is 12~dB.}%
Marianne Arnoldb43b4932011-01-17 18:30:18 +000043 \opt{iriverh100,iriverh300}{The minimum setting is 0~dB and the maximum is 24~dB.}%
Marcin Bukata434a0d2010-11-09 22:10:38 +000044 \opt{ipodnano,ipodnano2g,ipodcolor,mpiohd200}{%
45 The minimum setting is -6~dB and the maximum is 9~dB.}%
Andree Buschmann1248e9c2010-04-14 20:38:21 +000046 \opt{ipodvideo}{The minimum setting is -12~dB and the maximum is 12~dB.}%
Marianne Arnoldb43b4932011-01-17 18:30:18 +000047 \opt{iaudiom3,iaudiom5,iaudiox5,sansa,sansaAMS,iriverh10,iriverh10_5gb,vibe500}{%
Marianne Arnold5b47b892010-08-16 09:43:48 +000048 The minimum setting is -24~dB and the maximum is 24~dB.}
Michael DiFebboc1ecc632006-04-01 15:41:21 +000049
Dan Everton7da37b82007-11-24 11:07:44 +000050\opt{ipodvideo}{
51\section{Bass Cutoff}
Thom Johansenc8ea4cc2007-12-14 00:10:41 +000052 This setting controls the frequency below which the bass adjustment applies.
53 The setting has a range from 1 to 4, where a bigger number affects a bigger
54 range of bass frequencies. The actual cutoff frequency used for each setting
55 value will vary with sample rate.
Dan Everton7da37b82007-11-24 11:07:44 +000056}
57
Michael DiFebboc1ecc632006-04-01 15:41:21 +000058\section{Treble}
Thom Johansen3a742082008-07-14 22:47:40 +000059 This setting emphasises
Marianne Arnoldb43b4932011-01-17 18:30:18 +000060 \nopt{iriverh100,iriverh300}{or suppresses}
Andree Buschmann1248e9c2010-04-14 20:38:21 +000061 the higher (treble) frequencies in the sound. A value of 0~dB means that
Thom Johansen3a742082008-07-14 22:47:40 +000062 treble sounds are unaltered (flat response).
Andree Buschmann1248e9c2010-04-14 20:38:21 +000063 \opt{masd}{The minimum setting is -15~dB and the maximum is 15~dB.}%
64 \opt{masf}{The minimum setting is -12~dB and the maximum is 12~dB.}%
Marianne Arnoldb43b4932011-01-17 18:30:18 +000065 \opt{iriverh100,iriverh300}{The minimum setting is 0~dB and the maximum is 6~dB.}%
Marcin Bukata434a0d2010-11-09 22:10:38 +000066 \opt{ipodnano,ipodnano2g,ipodcolor,mpiohd200}{%
67 The minimum setting is -6~dB and the maximum is 9~dB.}%
Andree Buschmann1248e9c2010-04-14 20:38:21 +000068 \opt{ipodvideo}{The minimum setting is -12~dB and the maximum is 12~dB.}%
Marianne Arnoldb43b4932011-01-17 18:30:18 +000069 \opt{iaudiom3,iaudiom5,iaudiox5,sansa,sansaAMS,iriverh10,iriverh10_5gb,vibe500}{%
Marianne Arnold5b47b892010-08-16 09:43:48 +000070 The minimum setting is -24~dB and the maximum is 24~dB.}
Michael DiFebboc1ecc632006-04-01 15:41:21 +000071
Dan Everton7da37b82007-11-24 11:07:44 +000072\opt{ipodvideo}{
73\section{Treble Cutoff}
Thom Johansenc8ea4cc2007-12-14 00:10:41 +000074 This setting controls the frequency above which the treble adjustment applies.
Marianne Arnold5d1287c2008-07-15 18:26:30 +000075 The setting has a range from 1 to 4, where a bigger number affects a smaller
Thom Johansenc8ea4cc2007-12-14 00:10:41 +000076 range of treble frequencies. The actual cutoff frequency used for each setting
77 value will vary with sample rate.
Dan Everton7da37b82007-11-24 11:07:44 +000078}
Alex Parker011bece2010-09-16 18:54:24 +000079}
80
81\opt{gigabeats}{
82\section{Tone Controls}
83 There is a five-band equalizer built into your \dap{} that allows you to
84 control various different parameters for each band. This equalizer is
85 implemented in hardware, and therefore does not tax the processor when in use.
86 Rockbox also features a more advanced five-band equalizer (see
87 \reference{ref:EQ}) that is implemented in software and allows more fine
88 grained control, but also requires more processor time.
89
90 \begin{description}
91 \item[Band 1 Gain.]
92 This band acts as a low shelf filter that boosts or lowers all
93 frequencies below a certain frequency limit, much as a ``bass''
94 control found on ordinary stereo systems does. The ``gain'' parameter
95 controls how much the loudness of the band is adjusted. Positive
96 numbers make the EQ band louder, while negative numbers make that EQ
97 band quieter.
98 \item[Bands 2-4 Gain.]
99 These bands act as peaking filters that boost or lower a frequency
100 range centered at a certain frequency. Graphic equalizers in home
101 stereos are usually peaking filters. The ``gain'' parameter controls
102 how much each band is adjusted as with the the low shelf filter.
103 \item[Band 5 Gain.]
104 Band 5 acts as a high shelf filter, boosting or lowering all
105 frequencies above a certain frequency limit, much like a ``treble''
106 control found on ordinary stereo systems does. As with the other bands,
107 ``gain'' controls how much each band is adjusted.
108 \item[Advanced Tone Control Settings.]
109 This submenu allows you to change advanced parameters for each band.
110 \end{description}
111
112 As a general guide, EQ band 1 should be used for low frequencies, EQ bands 2
113 to 4 should be used for mids, and EQ band 5 should be used for highs.\\*
114
115 \subsection{Advanced Tone Control Settings}
116 As in the previous menu, the ``gain'' setting controls how much the
117 loudness of the band is adjusted. In addition the following parameters
118 can be adjusted:
119
120 \begin{description}
121 \item[Band 1 Frequency.]
122 The ``frequency'' parameter sets where the shelving starts to take
123 effect. For example, a cutoff frequency of 80~Hz will adjust only very
124 low frequencies. A cutoff frequency of 175~Hz, on the other hand, will
125 adjust a much wider range of bass frequencies.
126 \item[Bands 2-4 Frequency.]
127 The ``frequency'' parameter for these bands sets the centre frequency of
128 the range that is affected by the gain set.
129 \item[Bands 2-4 Width.]
130 This parameter sets the width of the range around the centre frequency
131 that is affected by the tone control. The possible settings are
132 ``wide'' or ``narrow''.
133 \item[Band 5 Frequency.]
134 This works just as for band 1 frequency, except that it affects the
135 high frequency end of the spectrum instead of the low.
136 \end{description}
137
138}
Dan Everton7da37b82007-11-24 11:07:44 +0000139
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000140\section{Balance}
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000141 This setting controls the balance between the left and right channels. The
142 default, 0, means that the left and right outputs are equal in volume.
Dominik Riebeling87d55362006-04-09 11:42:56 +0000143 Negative numbers increase the volume of the left channel relative to the
144 right, positive numbers increase the volume of the right channel relative
145 to the left.
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000146
147\section{Channels}
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000148 A stereo audio signal consists of two channels, left and right. The
Thom Johansen3a742082008-07-14 22:47:40 +0000149 \setting{Channels} setting determines if these channels are to be combined in
Thom Johansen89e411b2006-08-18 16:12:29 +0000150 any way, and if so, in what manner they will be combined.
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000151 Available options are:
Dominik Riebeling87d55362006-04-09 11:42:56 +0000152 %
Marianne Arnold197b4402010-06-11 20:23:34 +0000153 \begin{description}
154 \item[Stereo.]
155 Leave the audio signal unmodified.
156 \item[Mono.]
157 Combine both channels and send the resulting signal to both stereo
158 channels, resulting in a monophonic output.
159 \item[Custom.]
160 Allows you to manually specify a stereo width with the
161 \setting{Stereo Width} setting described later in this chapter.
162 \item[Mono Left.]
163 Plays the left channel in both stereo channels.
164 \item[Mono Right.]
165 Plays the right channel in both stereo channels.
166 \item[Karaoke.]
167 Removes all sound that is common to both channels. Since most
Thom Johansen89e411b2006-08-18 16:12:29 +0000168 music is recorded with vocals being equally present in both channels
Martin Arverb1099692006-10-17 09:31:18 +0000169 to make the singer sound centrally placed, this often (but not
170 always) has the effect of removing the voice track from a song. This
Marianne Arnold197b4402010-06-11 20:23:34 +0000171 setting also very often has other undesirable effects on the sound.
172 \end{description}
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000173
Thom Johansen1903fab2006-04-19 15:38:26 +0000174\section{Stereo Width}
Thom Johansen89e411b2006-08-18 16:12:29 +0000175 Stereo width allows you to manually specify the effect that is applied
Thom Johansen42995a32007-12-13 01:11:26 +0000176 when the \setting{Channels} setting is set to ``custom''.
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000177 All values below 100\% will progressively mix the contents of one channel
178 into the other. This has the effect of gradually centering the stereo image,
Martin Arverb1099692006-10-17 09:31:18 +0000179 until you have monophonic sound at 0\%. Values above 100\% will progressively
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000180 remove components in one channel that is also present in the other. This has
181 the effect of widening the stereo field. A value of 100\% will leave the
Martin Arverb1099692006-10-17 09:31:18 +0000182 stereo field unaltered.
Thom Johansen1903fab2006-04-19 15:38:26 +0000183
Marianne Arnold5d1287c2008-07-15 18:26:30 +0000184\opt{masf}{
Dominik Riebeling87d55362006-04-09 11:42:56 +0000185 \section{Loudness}
Thom Johansenc8ea4cc2007-12-14 00:10:41 +0000186 When listening at low volumes, the ear will tend to make bass and treble
187 frequencies sound quieter than they really are. To compensate for this,
188 \setting{Loudness} is an effect which emphasises bass and treble in a fashion
189 suited to the human ear. Frequencies in the vocal range are unaffected, since
190 the human ear picks these up very easily at any sound level.
191 It is of course also possible to use this effect at higher volumes for
192 enhanced bass and treble.
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000193}
194
Marianne Arnold5d1287c2008-07-15 18:26:30 +0000195\opt{masf}{
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000196\section{Auto Volume}
Dominik Riebeling87d55362006-04-09 11:42:56 +0000197 Auto volume is a feature that automatically lowers the volume on loud parts,
198 and then slowly restores the volume to the previous level over a time
Thom Johansenc8ea4cc2007-12-14 00:10:41 +0000199 interval. This setting allows this time interval to be configured. Short
Andree Buschmann1248e9c2010-04-14 20:38:21 +0000200 values like 20~ms are useful for ensuring a constant volume for in-car use and
Thom Johansenc8ea4cc2007-12-14 00:10:41 +0000201 other applications where background noise makes a constant loudness desirable.
Dominik Riebeling87d55362006-04-09 11:42:56 +0000202 A longer timeout means that the change in volume back to the previous level
Thom Johansen3a742082008-07-14 22:47:40 +0000203 will be smoother, so there will be fewer sharp changes in volume level.
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000204}
Marianne Arnold5d1287c2008-07-15 18:26:30 +0000205
206\opt{masf}{
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000207\section{Super Bass}
Dominik Riebeling87d55362006-04-09 11:42:56 +0000208 This setting changes the threshold at which bass frequencies are affected by
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000209 the \setting{Loudness} setting, making the sound of drums and bass guitar
Thom Johansen3a742082008-07-14 22:47:40 +0000210 louder in comparison to the rest of the sound. This setting only has an
Andree Buschmann1248e9c2010-04-14 20:38:21 +0000211 effect if \setting{Loudness} is set to a value larger than 0~dB.
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000212}
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000213
Marianne Arnold5d1287c2008-07-15 18:26:30 +0000214\opt{masf}{
Thom Johansen3a742082008-07-14 22:47:40 +0000215\section{MDB {}-- Micronas Dynamic Bass}
Thom Johansenc8ea4cc2007-12-14 00:10:41 +0000216 The rest of the parameters in this menu relate to the Micronas Dynamic
217 Bass (MDB) function. MDB is designed to enable the user to hear bass
Dominik Riebeling87d55362006-04-09 11:42:56 +0000218 notes that the headphones and/or speakers are not capable of reproducing.
219 Every tone has a fundamental frequency (the ``main tone'') and also several
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000220 harmonics, which are related to that tone. The human brain has a mechanism
Dominik Riebeling87d55362006-04-09 11:42:56 +0000221 whereby it can actually infer the presence of bass notes from the higher
222 harmonics that they would generate.
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000223
Dominik Riebeling87d55362006-04-09 11:42:56 +0000224 The practical upshot of this is that MDB produces a more authentic sounding
Thom Johansen10d03442007-12-13 22:51:27 +0000225 bass by tricking the brain into believing it is hearing tones that the
Thom Johansen3a742082008-07-14 22:47:40 +0000226 headphones or speakers are not capable of reproducing.
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000227
Thom Johansenc8ea4cc2007-12-14 00:10:41 +0000228 The MDB parameters are as follows:
Dominik Riebeling87d55362006-04-09 11:42:56 +0000229 %
230 \begin{description}
Tomer Shaleve04acd82009-10-05 16:40:27 +0000231 \item[MDB enable.]
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000232 This turns the MDB feature on or off. For many users this will be the
Dominik Riebeling87d55362006-04-09 11:42:56 +0000233 only setting they need, since Rockbox picks sensible defaults for the
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000234 other parameters. MDB is turned off by default.
Tomer Shaleve04acd82009-10-05 16:40:27 +0000235 \item[MDB strength.]
Thom Johansenc8ea4cc2007-12-14 00:10:41 +0000236 How loud the harmonics generated by MDB will be.
Tomer Shaleve04acd82009-10-05 16:40:27 +0000237 \item[MDB Harmonics.]
Dominik Riebeling87d55362006-04-09 11:42:56 +0000238 The percentage of the low notes that is converted into harmonics.
239 If low notes are causing speaker distortion, this can be set to 100\%
240 to eliminate the fundamental completely and only produce harmonics in the
Thom Johansenc8ea4cc2007-12-14 00:10:41 +0000241 signal. If set to 0\% this is the same as turning the MDB feature off.
Tomer Shaleve04acd82009-10-05 16:40:27 +0000242 \item[MDB Centre Frequency.]
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000243 The cutoff frequency of your headphones or speakers. This is usually
Dominik Riebeling87d55362006-04-09 11:42:56 +0000244 given in the specification for the headphones/speakers.
Tomer Shaleve04acd82009-10-05 16:40:27 +0000245 \item[MDB shape.]
Dominik Riebeling87d55362006-04-09 11:42:56 +0000246 It is recommended that this parameter be set to 1.5 times the centre frequency.
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000247
248 This is the frequency up to which harmonics are generated. Some of the
Dominik Riebeling87d55362006-04-09 11:42:56 +0000249 lower fundamentals near the cut{}-off range will have their lower
Thom Johansenc8ea4cc2007-12-14 00:10:41 +0000250 harmonics cut, since they will be below the range of the speakers.
Dominik Riebeling87d55362006-04-09 11:42:56 +0000251 Fundamentals between the cut{}-off frequency and the lower frequency
252 will have their harmonics proportionally boosted to compensate and restore
253 the `loudness' of these notes.
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000254
Dominik Riebeling87d55362006-04-09 11:42:56 +0000255 For most users, the defaults should provide an improvement in sound
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000256 quality and can be safely left as they are. For reference, the defaults
Dominik Riebeling87d55362006-04-09 11:42:56 +0000257 Rockbox uses are:
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000258 %
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000259 \begin{table}[h!]
Alexander Levinfb87e892009-08-24 21:22:18 +0000260 \begin{rbtabular}{0.5\textwidth}{Xc}{Setting & Value}{}{}
Andree Buschmann1248e9c2010-04-14 20:38:21 +0000261 MDB Strength & 50~dB \\
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000262 MDB Harmonics & 48\% \\
Andree Buschmann1248e9c2010-04-14 20:38:21 +0000263 MDB Centre Frequency & 60~Hz \\
264 MDB Shape & 90~Hz \\
Alexander Levinfb87e892009-08-24 21:22:18 +0000265 \end{rbtabular}
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000266 \end{table}
267
Dominik Riebeling87d55362006-04-09 11:42:56 +0000268 \end{description}
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000269}
270
Nils Wallménius12eb0582008-03-23 22:07:09 +0000271\opt{swcodec}{
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000272\section{Crossfeed}
Dominik Riebeling87d55362006-04-09 11:42:56 +0000273 Crossfeed attempts to make the experience of listening to music on
Thom Johansen89e411b2006-08-18 16:12:29 +0000274 headphones more similar to listening to music with stereo speakers. When you
275 listen to music through speakers, each ear will hear sound originating from
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000276 both speakers. However, the sound from the left speaker reaches your right
Alex Parker51743412009-08-25 21:51:55 +0000277 ear slightly later than it does your left ear, and vice versa.\\
Thom Johansend01d65f2006-04-11 21:42:09 +0000278
Thom Johansenc8ea4cc2007-12-14 00:10:41 +0000279 The human ear and brain together are very good at interpreting the time
Thom Johansen89e411b2006-08-18 16:12:29 +0000280 differences between direct sounds and reflected sounds and using that
281 information to identify the direction that the sound is coming from. On the
282 other hand, when listening to headphones, each ear hears only the stereo
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000283 channel corresponding to it. The left ear hears only the left channel and
Dominik Riebeling87d55362006-04-09 11:42:56 +0000284 the right ear hears only the right channel. The result is that sound from
285 headphones does not provide the same spatial cues to your ear and brain as
Alex Parker51743412009-08-25 21:51:55 +0000286 speakers, and might for that reason sound unnatural to some listeners.\\
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000287
Dominik Riebeling87d55362006-04-09 11:42:56 +0000288 The crossfeed function uses an algorithm to feed a delayed and filtered
289 portion of the signal from the right channel into the left channel and vice
290 versa in order to simulate the spatial cues that the ear and brain receive
Thom Johansend01d65f2006-04-11 21:42:09 +0000291 when listening to a set of loudspeakers placed in front of the listener. The
292 result is a more natural stereo image that can be especially appreciated in
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000293 older rock and jazz records, where one instrument is often hard-panned to
Martin Arverb1099692006-10-17 09:31:18 +0000294 just one of the speakers. Many people will find such records tiring to listen
Alex Parker51743412009-08-25 21:51:55 +0000295 to using earphones and no crossfeed effect.\\
Thom Johansend01d65f2006-04-11 21:42:09 +0000296
Thom Johansenc8ea4cc2007-12-14 00:10:41 +0000297 Crossfeed has the following settings:
Thom Johansend01d65f2006-04-11 21:42:09 +0000298 \begin{description}
Tomer Shaleve04acd82009-10-05 16:40:27 +0000299 \item[Crossfeed.]
Thom Johansend01d65f2006-04-11 21:42:09 +0000300 Selects whether the crossfeed effect is to be enabled or not.
Tomer Shaleve04acd82009-10-05 16:40:27 +0000301 \item[Direct Gain.]
Thom Johansend01d65f2006-04-11 21:42:09 +0000302 How much the level of the audio that travels the direct path from a speaker
303 to the corresponding ear is supposed to be decreased.
Tomer Shaleve04acd82009-10-05 16:40:27 +0000304 \item[Cross Gain.]
Thom Johansend01d65f2006-04-11 21:42:09 +0000305 How much the level of the audio that travels the cross path from a speaker
306 to the opposite ear is to be decreased.
Tomer Shaleve04acd82009-10-05 16:40:27 +0000307 \item[High-Frequency Attenuation.]
Thom Johansend01d65f2006-04-11 21:42:09 +0000308 How much the upper frequencies of the cross path audio will be dampened.
309 Note that the total level of the higher frequencies will be a combination
Thom Johansen103ebf72006-04-27 19:25:42 +0000310 of both this setting and the \setting{Cross Gain} setting.
Tomer Shaleve04acd82009-10-05 16:40:27 +0000311 \item[High-Frequency Cutoff.]
Thom Johansend01d65f2006-04-11 21:42:09 +0000312 Decides at which frequency the cross path audio will start to be cut
Martin Arverb1099692006-10-17 09:31:18 +0000313 by the amount described by the \setting{High-Frequency Attenuation}
314 setting.
Thom Johansend01d65f2006-04-11 21:42:09 +0000315 \end{description}
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000316
Thom Johansend01d65f2006-04-11 21:42:09 +0000317 Most users will find the default settings to yield satisfactory results, but
318 for the more adventurous user the settings can be fine-tuned to provide a
319 virtual speaker placement suited to ones preference.
320 % TODO: adapt the guidelines for crossfeed settings found here?
321 % http://www.ohl.to/interests-in-audio/crossfeed-and-eq-for-headphones/
Thom Johansend01d65f2006-04-11 21:42:09 +0000322 Beware that the crossfeed function is capable of making the audio distort
323 if you choose settings which result in a too high output level.
Michael DiFebboc1ecc632006-04-01 15:41:21 +0000324}
Michael DiFebbo25f9cec2006-03-27 19:30:05 +0000325
Nils Wallménius12eb0582008-03-23 22:07:09 +0000326\opt{swcodec}{
Nils Wallméniusa374ca92006-09-09 17:59:51 +0000327\section{\label{ref:EQ}Equalizer}
Dominik Riebeling87d55362006-04-09 11:42:56 +0000328 \screenshot{configure_rockbox/images/ss-equalizer}{The graphical equalizer}{}
Thom Johansen42995a32007-12-13 01:11:26 +0000329 Rockbox features a parametric equalizer (EQ). As the name suggests, a
330 parametric EQ lets you control several different parameters for each
Alex Parker011bece2010-09-16 18:54:24 +0000331 band of the EQ. \nopt{gigabeats}{In some ways the EQ is similar to the
332 \setting{Bass} and \setting{Treble} settings described earlier, but the EQ
333 allows you to control the sound much more carefully.} \opt{gigabeats}{The EQ
334 is similar to the \setting{Tone Controls} described above, but allows more
335 delicate control.}\\
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000336
Thom Johansen42995a32007-12-13 01:11:26 +0000337 Rockbox's parametric EQ is composed of five different bands:
338 \begin{description}
Tomer Shaleve04acd82009-10-05 16:40:27 +0000339 \item[Band 0: Low shelf filter.]
Thom Johansen42995a32007-12-13 01:11:26 +0000340 The low shelf filter boosts or lowers all frequencies below a certain
Alex Parker011bece2010-09-16 18:54:24 +0000341 frequency limit, much as the ``bass'' control found on ordinary
Thom Johansen42995a32007-12-13 01:11:26 +0000342 stereo systems does.
343 Adjust the ``cutoff'' frequency parameter to decide where the shelving
Andree Buschmann1248e9c2010-04-14 20:38:21 +0000344 starts to take effect. For example, a cutoff frequency of 50~Hz will
345 adjust only very low frequencies. A cutoff frequency of 200~Hz, on the
Thom Johansen42995a32007-12-13 01:11:26 +0000346 other hand, will adjust a much wider range of bass frequencies.
347 The ``gain'' parameter controls how much the loudness of the band is
348 adjusted. Positive numbers make the EQ band louder, while negative
349 numbers make that EQ band quieter.
350 The ``Q'' parameter should always be set to 0.7 for the shelving
351 filters. Higher values will add a small boost around the cutoff
352 frequency that is almost always undesirable.
Tomer Shaleve04acd82009-10-05 16:40:27 +0000353 \item[Bands 1-3: Peaking filters.]
Thom Johansen42995a32007-12-13 01:11:26 +0000354 Peaking EQ filters boost or lower a frequency range centered at the
Alex Parker1925cd12009-11-22 11:36:07 +0000355 centre frequency chosen.
Thom Johansen42995a32007-12-13 01:11:26 +0000356 Graphic equalizers in home stereos are usually peaking
357 filters. The peaking filters in Rockbox's EQ lets you adjust three
Alex Parker1925cd12009-11-22 11:36:07 +0000358 different parameters for EQ bands 1 through 3. The ``centre'' parameter
359 controls the centre frequency of the frequency range that is affected
Thom Johansen42995a32007-12-13 01:11:26 +0000360 as described above.
361 The ``gain'' parameter controls how much each band is adjusted, and
362 works as for the low shelf filter.
363 Finally, the ``Q'' parameter controls how wide or narrow the affected
364 frequency range is. Higher Q values will affect a narrower band of
365 frequencies, while lower Q values will affect a wider band of
366 frequencies.
Tomer Shaleve04acd82009-10-05 16:40:27 +0000367 \item[Band 4: High shelf filter.]
Thom Johansen42995a32007-12-13 01:11:26 +0000368 A high shelf filter boosts or lowers all frequencies above a certain
Alex Parker011bece2010-09-16 18:54:24 +0000369 frequency limit, much as the ``treble'' control found on ordinary
Thom Johansen42995a32007-12-13 01:11:26 +0000370 stereo systems does.
371 The high shelf filter is adjusted the same way as the low shelf filter,
372 except that it works on the high end of the frequency spectrum rather
373 than the low end.
374 \end{description}
Thom Johansen3a742082008-07-14 22:47:40 +0000375 As a general guide, EQ band 0 should be used for low frequencies, EQ bands 1
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000376 through 3 should be used for mids, and EQ band 4 should be used for highs.
377
Michael DiFebboa7acf132006-10-14 15:27:17 +0000378\begin {description}
Tomer Shaleve04acd82009-10-05 16:40:27 +0000379 \item[Enable EQ.]
Michael DiFebboa7acf132006-10-14 15:27:17 +0000380 This option controls whether the EQ is on or off.
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000381
Tomer Shaleve04acd82009-10-05 16:40:27 +0000382 \item[Graphical EQ.]
Martin Arverb1099692006-10-17 09:31:18 +0000383 This option brings up a graphic EQ screen, which allows adjustment of each of
Alex Parker1925cd12009-11-22 11:36:07 +0000384 the three parameters described above (gain, centre frequency, and Q) for each
Martin Arverb1099692006-10-17 09:31:18 +0000385 of the five EQ bands.
Michael DiFebboa7acf132006-10-14 15:27:17 +0000386
Alexander Levin97365802010-05-20 17:38:38 +0000387 \begin{btnmap}
Marianne Arnoldc3ee2262010-06-07 21:14:42 +0000388 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,GIGABEAT_PAD%
Alex Parker40ec7b92010-10-12 19:34:38 +0000389 ,GIGABEAT_S_PAD,SANSA_C200_PAD,IAUDIO_M3_PAD,MROBE100_PAD%
390 ,SANSA_CLIP_PAD}{\ButtonRight}
Marianne Arnoldc3ee2262010-06-07 21:14:42 +0000391 \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollFwd}
392 \opt{IRIVER_H10_PAD}{\ButtonScrollUp}
393 \opt{PBELL_VIBE500_PAD}{\ButtonUp}
Marcin Bukata434a0d2010-11-09 22:10:38 +0000394 \opt{MPIO_HD200_PAD}{\ButtonVolUp}
Marcin Bukat4bbc9f62012-01-26 10:11:18 +0100395 \opt{MPIO_HD300_PAD}{\ButtonScrollUp}
Marianne Arnoldc3ee2262010-06-07 21:14:42 +0000396 \opt{touchscreen}{\TouchMidRight}
397 &
398 \opt{HAVEREMOTEKEYMAP}{
399 \opt{GIGABEAT_RC_PAD}{\ButtonRCFF}
400 \opt{IAUDIO_RC_PAD}{\ButtonRCRight}
401 &}
402 Raises the highlighted parameter.
403 \\
Michael DiFebboa7acf132006-10-14 15:27:17 +0000404 %
Marianne Arnoldc3ee2262010-06-07 21:14:42 +0000405 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,GIGABEAT_PAD%
Alex Parker40ec7b92010-10-12 19:34:38 +0000406 ,GIGABEAT_S_PAD,SANSA_C200_PAD,IAUDIO_M3_PAD,MROBE100_PAD%
407 ,SANSA_CLIP_PAD}{\ButtonLeft}
Marianne Arnoldc3ee2262010-06-07 21:14:42 +0000408 \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollBack}
409 \opt{IRIVER_H10_PAD}{\ButtonScrollDown}
410 \opt{PBELL_VIBE500_PAD}{\ButtonDown}
Marcin Bukata434a0d2010-11-09 22:10:38 +0000411 \opt{MPIO_HD200_PAD}{\ButtonVolDown}
Marcin Bukat4bbc9f62012-01-26 10:11:18 +0100412 \opt{MPIO_HD300_PAD}{\ButtonScrollDown}
Tomer Shalev93afea02009-12-15 19:56:03 +0000413 \opt{touchscreen}{\TouchMidLeft}
Marianne Arnoldc3ee2262010-06-07 21:14:42 +0000414 &
415 \opt{HAVEREMOTEKEYMAP}{
416 \opt{GIGABEAT_RC_PAD}{\ButtonRCRew}
417 \opt{IAUDIO_RC_PAD}{\ButtonRCLeft}
418 &}
419 Lowers the highlighted parameter.
420 \\
Michael DiFebboa7acf132006-10-14 15:27:17 +0000421 %
Marianne Arnoldc3ee2262010-06-07 21:14:42 +0000422 \opt{IPOD_4G_PAD,IPOD_3G_PAD,PBELL_VIBE500_PAD}{\ButtonLeft}
423 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_C200_PAD%
Alex Parker40ec7b92010-10-12 19:34:38 +0000424 ,SANSA_FUZE_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,IAUDIO_M3_PAD,MROBE100_PAD%
425 ,SANSA_CLIP_PAD}{\ButtonUp}
Marcin Bukat4bbc9f62012-01-26 10:11:18 +0100426 \opt{IRIVER_H10_PAD,MPIO_HD200_PAD,MPIO_HD300_PAD}{\ButtonRew}
Marianne Arnoldc3ee2262010-06-07 21:14:42 +0000427 \opt{touchscreen}{\ActionStdPrev}
428 &
429 \opt{HAVEREMOTEKEYMAP}{
430 \opt{IRIVER_RC_H100_PAD}{\ButtonRCRew}
431 \opt{GIGABEAT_RC_PAD}{\ButtonRCVolUp}
432 \opt{IAUDIO_RC_PAD}{\ButtonRCUp}
433 &}
434 Moves to the previous EQ band.
435 \\
Michael DiFebboa7acf132006-10-14 15:27:17 +0000436 %
Marianne Arnoldc3ee2262010-06-07 21:14:42 +0000437 \opt{IPOD_4G_PAD,IPOD_3G_PAD,PBELL_VIBE500_PAD}{\ButtonRight}
438 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_C200_PAD%
Alex Parker40ec7b92010-10-12 19:34:38 +0000439 ,SANSA_FUZE_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,IAUDIO_M3_PAD,MROBE100_PAD%
440 ,SANSA_CLIP_PAD}{\ButtonDown}
Marcin Bukat4bbc9f62012-01-26 10:11:18 +0100441 \opt{IRIVER_H10_PAD,MPIO_HD200_PAD,MPIO_HD300_PAD}{\ButtonFF}
Marianne Arnoldc3ee2262010-06-07 21:14:42 +0000442 \opt{touchscreen}{\ActionStdNext}
443 &
444 \opt{HAVEREMOTEKEYMAP}{
445 \opt{IRIVER_RC_H100_PAD}{\ButtonRCFF}
446 \opt{GIGABEAT_RC_PAD}{\ButtonRCVolDown}
447 \opt{IAUDIO_RC_PAD}{\ButtonRCDown}
448 &}
449 Moves to the next EQ band.
450 \\
Martin Arverb1099692006-10-17 09:31:18 +0000451 %
Alex Parker40ec7b92010-10-12 19:34:38 +0000452 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,IAUDIO_X5_PAD%
453 ,SANSA_C200_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IPOD_VIDEO_PAD,SANSA_E200_PAD%
454 ,SANSA_FUZE_PAD,MROBE100_PAD,SANSA_CLIP_PAD}{\ButtonSelect}
Marcin Bukata434a0d2010-11-09 22:10:38 +0000455 \opt{MPIO_HD200_PAD}{\ButtonFunc}
Marcin Bukat4bbc9f62012-01-26 10:11:18 +0100456 \opt{MPIO_HD300_PAD}{\ButtonEnter}
Szymon Dzioka09152b2010-04-15 18:35:41 +0000457 \opt{PBELL_VIBE500_PAD}{\ButtonOK}
Marianne Arnoldc3ee2262010-06-07 21:14:42 +0000458 \opt{IRIVER_H10_PAD}{\ButtonRight}
459 \opt{IAUDIO_M3_PAD}{\ButtonPlay}
460 \opt{touchscreen}{\TouchCenter
461 \opt{COWON_D2_PAD}{/ \ButtonMenu}}
462 &
463 \opt{HAVEREMOTEKEYMAP}{
464 \opt{IRIVER_RC_H100_PAD}{\ButtonRCSelect}
465 \opt{GIGABEAT_RC_PAD,IAUDIO_RC_PAD}{\ButtonRCPlay}
466 &}
467 Toggles the cursor among the three parameters (gain, centre frequency,
468 Q) for the selected EQ band
469 \\
Martin Arverb1099692006-10-17 09:31:18 +0000470 %
Michael DiFebboa7acf132006-10-14 15:27:17 +0000471 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode}
Marcin Bukat4bbc9f62012-01-26 10:11:18 +0100472 \opt{IPOD_4G_PAD,IPOD_3G_PAD,MPIO_HD300_PAD}{\ButtonMenu}
Tom Ross56162032007-01-20 00:43:50 +0000473 \opt{IAUDIO_X5_PAD}{\ButtonPower/\ButtonRec}
Marcin Bukata434a0d2010-11-09 22:10:38 +0000474 \opt{IAUDIO_M3_PAD,MPIO_HD200_PAD}{\ButtonRec}
Marianne Arnoldc3ee2262010-06-07 21:14:42 +0000475 \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IRIVER_H10_PAD}{\ButtonLeft}
Alex Parker40ec7b92010-10-12 19:34:38 +0000476 \opt{GIGABEAT_PAD,GIGABEAT_S_PAD,SANSA_C200_PAD,MROBE100_PAD,SANSA_CLIP_PAD}{\ButtonPower}
Szymon Dzioka09152b2010-04-15 18:35:41 +0000477 \opt{PBELL_VIBE500_PAD}{\ButtonCancel}
Marianne Arnoldc3ee2262010-06-07 21:14:42 +0000478 \opt{touchscreen}{\TouchTopLeft
479 \opt{COWON_D2_PAD}{/ \ButtonPower}}
480 &
481 \opt{HAVEREMOTEKEYMAP}{
482 \opt{IRIVER_RC_H100_PAD}{\ButtonRCStop}
483 \opt{GIGABEAT_RC_PAD}{\ButtonRCDsp}
484 \opt{IAUDIO_RC_PAD}{\ButtonRCRec}
485 &}
486 Exits the graphic EQ screen.
487 \\
Michael DiFebboa7acf132006-10-14 15:27:17 +0000488 \end{btnmap}
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000489
Tomer Shaleve04acd82009-10-05 16:40:27 +0000490 \item[Pre-cut.]
Michael Giacomelliab759da2011-07-27 16:02:43 +0000491 If too much positive gain is added through the graphical EQ, your music may
492 distort. The \setting{Precut} setting allows you to apply a global negative
493 gain to decoded audio, cancelling out positive gain from the EQ. This will
494 prevent distortion when boosting certain frequency ranges, at the expense of
495 making audio quieter.
496
497 Alternatively, precut can be used with a flat EQ curve to implement a volume
498 cap. For example, on a player that allows overdriving the headphone output
499 to +6dB, maximum volume can be capped to +0dB by applying 6dB of precut. Note
500 that precut is not applied if EQ is disabled.
Michael DiFebboa7acf132006-10-14 15:27:17 +0000501
Tomer Shaleve04acd82009-10-05 16:40:27 +0000502\item[Simple EQ.]
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000503This option provides an easier alternative for those who are daunted by all of
504the parameters that can be adjusted using the graphical EQ. With the
Martin Arverb1099692006-10-17 09:31:18 +0000505\setting{Simple EQ}, the only parameter that can be adjusted is the gain.
Michael DiFebboa7acf132006-10-14 15:27:17 +0000506
Tomer Shaleve04acd82009-10-05 16:40:27 +0000507\item[Advanced EQ.]
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000508This sub menu provides options for adjusting the same parameters as the
509\setting{Graphical EQ}. The only difference is that the parameters are
Martin Arverb1099692006-10-17 09:31:18 +0000510adjusted through textual menus rather than through a graphic interface.
511
Tomer Shaleve04acd82009-10-05 16:40:27 +0000512\item[Save EQ Preset.]
Martin Arverb1099692006-10-17 09:31:18 +0000513This option saves the current EQ configuration in a \fname{.cfg} file.
514
Tomer Shaleve04acd82009-10-05 16:40:27 +0000515\item[Browse EQ Presets.]
Thom Johansenc8ea4cc2007-12-14 00:10:41 +0000516This menu displays a list of EQ presets, as well as any EQ configurations saved
Nils Wallménius5fab9fc2007-01-29 17:03:56 +0000517using the \setting{Save EQ Preset} option. Users unfamiliar with the
518operation of a parametric EQ may wish to use the presets instead of trying to
519configure the EQ, or use the presets for designing their own custom EQ
Martin Arverb1099692006-10-17 09:31:18 +0000520settings.
521
Michael DiFebboa7acf132006-10-14 15:27:17 +0000522\end{description}
523}
524
Nils Wallménius12eb0582008-03-23 22:07:09 +0000525\opt{swcodec}{
Thom Johansen7ec37772006-11-22 18:21:39 +0000526\section{Dithering}
527This setting controls the dithering and noise shaping functionality of Rockbox.
528
529Most of Rockbox' audio file decoders work at a higher bit depth than the 16 bits
Thom Johansenc8ea4cc2007-12-14 00:10:41 +0000530used for output on the \daps{} audio connectors. The simplest way to
Thom Johansen7ec37772006-11-22 18:21:39 +0000531convert from one bit depth to another is simply discarding all the surplus bits.
532This is the default behaviour, and adds distortion to the signal that will
533vary in character along with the desired sound.
534
535Dithering adds low-level noise to the signal prior to throwing away the surplus
536bits, which gives the resulting signal a uniform noise floor which is
537independent of the signal. Most people find this noise preferable to the
538time-varying noise heard when not performing dithering.
539
540After dithering, noise shaping is performed. This basically just pushes the
541dithering noise to the parts of the frequency spectrum humans cannot hear so
Andree Buschmann1248e9c2010-04-14 20:38:21 +0000542easily. In Rockbox' case, some of the noise is pushed up to above 10~kHz.
Thom Johansen7ec37772006-11-22 18:21:39 +0000543
544This setting will be put to its best use when listening to dynamic music with
545frequently occuring quiet parts, classical music being a typical example. It is
546worth noting that the effects of dithering and noise shaping are very subtle,
547and not easily noticable.
548
549Rockbox uses highpass triangular distribution noise as the dithering noise
550source, and a third order noise shaper.
551}
Steve Bavinfb238072009-06-12 07:20:50 +0000552
Alexander Levin72964f22010-11-03 18:02:26 +0000553\opt{swcodec}{%
554\opt{pitchscreen}{%
Steve Bavinfb238072009-06-12 07:20:50 +0000555\section{Timestretch}
Alex Parker51743412009-08-25 21:51:55 +0000556Enabling \setting{Timestretch} allows you to change the playback speed without
557it affecting the pitch of the recording. After enabling this feature and
558rebooting, you can access this via the \setting{Pitch Screen}. This function is
559intended for speech playback and may significantly dilute your listening
Alexander Levin029eb882010-11-01 19:16:42 +0000560experience with more complex audio. See \reference{sec:pitchscreen} for more
561details about how to use the feature.
Jeffrey Goodea0341df2009-08-26 02:23:46 +0000562}
Alexander Levin72964f22010-11-03 18:02:26 +0000563}
Jeffrey Goodea0341df2009-08-26 02:23:46 +0000564
565\opt{swcodec}{
Jeffrey Goode95e2d722009-11-04 18:14:36 +0000566\section{Compressor}
567The \setting{Compressor} reduces, or compresses, the dynamic range of the audio
568signal. This makes the quieter and louder sections closer to the same volume
569level by progressively reducing the gain of louder signals. When subsequently
570amplified, this has the effect of making the quieter sections louder while
571keeping the louder sections from clipping. This allows listening to the quiet
572sections of dynamic material in noisy environments while preventing sudden loud
573sections from being overbearing.
Jeffrey Goodea0341df2009-08-26 02:23:46 +0000574
Jeffrey Goode95e2d722009-11-04 18:14:36 +0000575There are several settings associated with the compressor. The first, and most
576important, is the \setting{Threshold}. The threshold is the audio input level
577at which the compressor begins to act. Any level louder than the threshold
578will be compressed to some extent. The maximum amount of compression, or the
Andree Buschmannba0f8312010-05-06 18:41:41 +0000579quietest level at which the compressor will operate, is -24~dB. The default of
Jeffrey Goode95e2d722009-11-04 18:14:36 +0000580Off disables the compressor.
Jeffrey Goodea0341df2009-08-26 02:23:46 +0000581
Jeffrey Goode95e2d722009-11-04 18:14:36 +0000582The \setting{Makeup Gain} setting has two options: Off and Auto. Off means
583that the compressed audio will not be amplified after compression. The default
584of Auto will amplify the signal so that the loudest possible signal after
585compression will be just under the clipping limit. This is desirable because
586the compressed signal without makeup gain is quieter than the input signal.
587Makeup Gain in Auto restores the signal to the maximum possible level and
588brings the quieter audio up with it. This is what makes it possible to hear
589the quieter audio in noisy environments.
590
591The \setting{Ratio} setting determines how aggressively the compressor reduces
592gain above the threshold. For example, the 2:1 setting means that for each
593two decibels of input signal above the threshold, the compressor will only
594allow the output to appear as one decibel. The higher the ratio, the harder
595the signal is compressed. The ratio setting of Limit means essentially a ratio
596of infinity to one. In this case, the output signal is not allowed to exceed
597the threshold at all.
598
599The \setting{Knee} setting determines how abrupt the transition is from a
600non-compressed signal to a compressed signal. Hard Knee means that the
601transition occurs precisely at the threshold. The Soft Knee setting smoothes
602the transition from plus or minus three decibels around the threshold.
603
604The \setting{Release Time} setting sets the recovery time after the signal is
605compressed. Once the compressor determines that compression is necessary,
606the input signal is reduced appropriately, but the gain isn't allowed to
607immediately return to normal levels. This is necessary to reduce artifacts
Alexander Levine8c72b62010-05-09 18:33:31 +0000608such as ``pumping.'' Instead, the gain is allowed to return to normal at the
Andree Buschmann1248e9c2010-04-14 20:38:21 +0000609chosen rate. Release Time is the time for the gain to recover by 10~dB.
Tomer Shaleve04acd82009-10-05 16:40:27 +0000610}