9675
|
1 <?xml version="1.0" encoding="iso-8859-1"?>
|
|
2 <sect2 id="audio-dev">
|
|
3 <title>Audio output devices</title>
|
|
4 <sect3 id="sync">
|
|
5 <title>Audio/Video synchronisation</title>
|
|
6
|
|
7 <para>
|
|
8 <application>MPlayer</application>'s audio interface is called
|
|
9 <emphasis>libao2</emphasis>. It currently contains these drivers:
|
|
10 </para>
|
|
11
|
|
12 <informaltable>
|
|
13 <tgroup cols="2">
|
|
14 <thead>
|
|
15 <row><entry>Driver</entry><entry>Comment</entry></row>
|
|
16 </thead>
|
|
17 <tbody>
|
|
18 <row><entry>oss</entry><entry>
|
|
19 OSS (ioctl) driver (supports hardware AC3 passthrough)
|
|
20 </entry></row>
|
|
21 <row><entry>sdl</entry><entry>
|
|
22 SDL driver (supports sound daemons like <emphasis role="bold">ESD</emphasis>
|
|
23 and <emphasis role="bold">ARTS</emphasis>)
|
|
24 </entry></row>
|
|
25 <row><entry>nas</entry><entry>
|
|
26 NAS (Network Audio System) driver
|
|
27 </entry></row>
|
|
28 <row><entry>alsa5</entry><entry>
|
|
29 native ALSA 0.5 driver
|
|
30 </entry></row>
|
|
31 <row><entry>alsa9</entry><entry>
|
|
32 native ALSA 0.9 driver (supports hardware AC3 passthrough)
|
|
33 </entry></row>
|
|
34 <row><entry>sun</entry><entry>
|
|
35 SUN audio driver (<filename>/dev/audio</filename>) for BSD and Solaris8 users
|
|
36 </entry></row>
|
10178
|
37 <row><entry>macosx</entry><entry>
|
|
38 native MacOSX driver
|
|
39 </entry></row>
|
|
40 <row><entry>win32</entry><entry>
|
|
41 native Win32 driver
|
|
42 </entry></row>
|
9675
|
43 <row><entry>arts</entry><entry>
|
|
44 native ARTS driver (mostly for KDE users)
|
|
45 </entry></row>
|
|
46 <row><entry>esd</entry><entry>
|
|
47 native ESD driver (mostly for GNOME users)
|
|
48 </entry></row>
|
|
49 </tbody>
|
|
50 </tgroup>
|
|
51 </informaltable>
|
|
52
|
|
53 <para>
|
|
54 Linux sound card drivers have compatibility problems. This is because
|
|
55 <application>MPlayer</application> relies on an in-built feature of
|
|
56 <emphasis>properly</emphasis> coded sound drivers that enable them to
|
|
57 maintain correct audio/video sync. Regrettably, some driver authors
|
|
58 don't take the care to code this feature since it is not needed for
|
|
59 playing MP3s or sound effects.
|
|
60 </para>
|
|
61
|
|
62 <para>
|
|
63 Other media players like <ulink url="http://avifile.sourceforge.net">aviplay</ulink>
|
10144
|
64 or <ulink url="http://xine.sourceforge.net">xine</ulink> possibly work
|
9675
|
65 out-of-the-box with these drivers because they use "simple" methods
|
|
66 with internal timing. Measuring showed that their methods are not as
|
|
67 efficient as <application>MPlayer</application>'s.
|
|
68 </para>
|
|
69
|
|
70 <para>
|
|
71 Using <application>MPlayer</application> with a properly written audio
|
|
72 driver will never result in A/V desyncs related to the audio, except
|
|
73 only with very badly created files (check the man page for workarounds).
|
|
74 </para>
|
|
75
|
|
76 <para>
|
|
77 If you happen to have a bad audio driver, try the <option>-autosync</option>
|
|
78 option, it should sort out your problems. See the man page for detailed
|
|
79 information.
|
|
80 </para>
|
|
81
|
|
82 <itemizedlist>
|
|
83 <title>Some notes:</title>
|
|
84 <listitem><para>
|
|
85 If you have an OSS driver, first try <option>-ao oss</option> (this is
|
|
86 the default). If you experience glitches, halts or anything out of the
|
|
87 ordinary, try <option>-ao sdl</option> (NOTE: you need to have SDL libraries
|
|
88 and header files installed). The SDL audio driver helps in a lot of cases
|
|
89 and also supports ESD (GNOME) and ARTS (KDE).
|
|
90 </para></listitem>
|
|
91 <listitem><para>
|
|
92 If you have ALSA version 0.5, then you almost always have to use
|
|
93 <option>-ao alsa5</option>, since ALSA 0.5 has buggy OSS emulation code,
|
|
94 and will <emphasis role="bold">crash <application>MPlayer</application></emphasis>
|
|
95 with a message like this:
|
|
96 <screen>
|
|
97 DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!<!--
|
|
98 --></screen>
|
|
99 </para></listitem>
|
|
100 <listitem><para>
|
|
101 On Solaris, use the SUN audio driver with the <option>-ao sun</option> option,
|
|
102 otherwise neither video nor audio will work.
|
|
103 </para></listitem>
|
|
104 <listitem><para>
|
|
105 If the sound clicks when playing from CD-ROM, turn on IRQ unmasking, e.g.
|
|
106 <command>hdparm -u1 /dev/cdrom</command> (<command>man hdparm</command>).
|
|
107 This is generally beneficial and described in more detail in the
|
|
108 <link linkend="drives">CD-ROM section</link>.
|
|
109 </para></listitem>
|
|
110 </itemizedlist>
|
|
111 </sect3>
|
|
112
|
|
113 <sect3 id="experiences">
|
|
114 <title>Soundcard experiences, recommendations</title>
|
|
115 <para>
|
|
116 On Linux, a 2.4.x kernel is highly recommended. Kernel 2.2 is not tested.
|
|
117 </para>
|
|
118
|
|
119 <para>
|
|
120 Linux sound drivers are primarily provided by the free version of OSS.
|
|
121 These drivers have been superceded by <ulink url="http://www.alsa-project.org">ALSA</ulink>
|
|
122 (Advanced Linux Sound Architecture) in the 2.5 development series. If
|
|
123 your distribution does not already use ALSA you may wish to try their
|
|
124 drivers if you experience sound problems. ALSA drivers are generally
|
|
125 superior to OSS in compatibility, performance and features. But some
|
|
126 sound cards are only supported by the commercial OSS drivers from
|
|
127 <ulink url="http://www.opensound.com/">4Front Technologies</ulink>.
|
|
128 They also support several non-Linux systems.
|
|
129 </para>
|
|
130
|
|
131 <informaltable>
|
|
132 <tgroup cols="8">
|
|
133 <colspec colname="c1"/>
|
|
134 <colspec colname="c2"/>
|
|
135 <colspec colname="c3"/>
|
|
136 <colspec colname="c4"/>
|
|
137 <colspec colname="c5"/>
|
|
138 <colspec colname="c6"/>
|
|
139 <colspec colname="c7"/>
|
|
140 <colspec colname="c8"/>
|
|
141 <spanspec spanname="driver" namest="c2" nameend="c5"/>
|
|
142 <spanspec spanname="ossfree" namest="c2" nameend="c2"/>
|
|
143 <spanspec spanname="alsa" namest="c3" nameend="c3"/>
|
|
144 <spanspec spanname="osspro" namest="c4" nameend="c4"/>
|
|
145 <spanspec spanname="others" namest="c5" nameend="c5"/>
|
|
146 <thead>
|
|
147 <row>
|
|
148 <entry morerows="2" valign="middle">SOUND CARD</entry>
|
|
149 <entry spanname="driver">DRIVER</entry>
|
|
150 <entry morerows="2" valign="middle">Max kHz</entry>
|
|
151 <entry morerows="2" valign="middle">Max Channels</entry>
|
|
152 <entry morerows="2" valign="middle">Max Opens
|
|
153 <footnote id="maxopens">
|
|
154 <para>the number of applications that are able to use
|
|
155 the device <emphasis>at the same time</emphasis>.</para>
|
|
156 </footnote>
|
|
157 </entry>
|
|
158 </row>
|
|
159
|
|
160 <row>
|
|
161 <entry spanname="ossfree">OSS/Free</entry>
|
|
162 <entry spanname="alsa">ALSA</entry>
|
|
163 <entry spanname="osspro">OSS/Pro</entry>
|
|
164 <entry spanname="others">other</entry>
|
|
165 </row>
|
|
166 </thead>
|
|
167
|
|
168 <tbody>
|
|
169 <row>
|
|
170 <entry>VIA onboard (686/A/B, 8233, 8235)</entry>
|
|
171 <entry>
|
|
172 <ulink url="http://sourceforge.net/project/showfiles.php?group_id=3242&release_id=59602">via82cxxx_audio</ulink>
|
|
173 </entry>
|
|
174 <entry>snd-via82xx</entry>
|
|
175 <entry></entry>
|
|
176 <entry></entry>
|
|
177 <entry>4-48 kHz or 48 kHz only, depending on the chipset</entry>
|
|
178 <entry></entry>
|
|
179 <entry></entry>
|
|
180 </row>
|
|
181
|
|
182 <row>
|
|
183 <entry>Aureal Vortex 2</entry>
|
|
184 <entry>none</entry>
|
|
185 <entry>none</entry>
|
|
186 <entry>OK</entry>
|
|
187 <entry>
|
|
188 <ulink url="http://aureal.sourceforge.net">Linux Aureal Drivers</ulink>
|
|
189 <ulink url="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">buffer size increased to 32k</ulink>
|
|
190 </entry>
|
|
191 <entry>48</entry>
|
|
192 <entry>4.1</entry>
|
|
193 <entry>5+</entry>
|
|
194 </row>
|
|
195
|
|
196 <row>
|
|
197 <entry>SB Live!</entry>
|
|
198 <entry>Analog OK, SP/DIF not working</entry>
|
|
199 <entry>Both OK</entry>
|
|
200 <entry>Both OK</entry>
|
|
201 <entry>
|
|
202 <ulink url="http://opensource.creative.com">Creative's OSS driver (SP/DIF support)</ulink>
|
|
203 </entry>
|
|
204 <entry>192</entry>
|
|
205 <entry>4.0/5.1</entry>
|
|
206 <entry>32</entry>
|
|
207 </row>
|
|
208
|
|
209 <row>
|
|
210 <entry>SB 128 PCI (es1371)</entry>
|
|
211 <entry>OK</entry>
|
|
212 <entry>?</entry>
|
|
213 <entry></entry>
|
|
214 <entry></entry>
|
|
215 <entry>48</entry>
|
|
216 <entry>stereo</entry>
|
|
217 <entry>2</entry>
|
|
218 </row>
|
|
219
|
|
220 <row>
|
|
221 <entry>SB AWE 64</entry>
|
|
222 <entry>max 44kHz</entry>
|
|
223 <entry>48kHz sounds bad</entry>
|
|
224 <entry></entry>
|
|
225 <entry></entry>
|
|
226 <entry>48</entry>
|
|
227 <entry></entry>
|
|
228 <entry></entry>
|
|
229 </row>
|
|
230
|
|
231 <row>
|
|
232 <entry>GUS PnP</entry>
|
|
233 <entry>none</entry>
|
|
234 <entry>OK</entry>
|
|
235 <entry>OK</entry>
|
|
236 <entry></entry>
|
|
237 <entry>48</entry>
|
|
238 <entry></entry>
|
|
239 <entry></entry>
|
|
240 </row>
|
|
241
|
|
242 <row>
|
|
243 <entry>Gravis UltraSound ACE</entry>
|
|
244 <entry></entry>
|
|
245 <entry></entry>
|
|
246 <entry></entry>
|
|
247 <entry></entry>
|
|
248 <entry></entry>
|
|
249 <entry></entry>
|
|
250 <entry></entry>
|
|
251 </row>
|
|
252
|
|
253 <row>
|
|
254 <entry>Gravis UltraSound MAX</entry>
|
|
255 <entry>OK</entry>
|
|
256 <entry>OK (?)</entry>
|
|
257 <entry></entry>
|
|
258 <entry></entry>
|
|
259 <entry>48</entry>
|
|
260 <entry></entry>
|
|
261 <entry></entry>
|
|
262 </row>
|
|
263
|
|
264 <row>
|
|
265 <entry>ESS 688</entry>
|
|
266 <entry>OK</entry>
|
|
267 <entry>OK (?)</entry>
|
|
268 <entry></entry>
|
|
269 <entry></entry>
|
|
270 <entry>48</entry>
|
|
271 <entry></entry>
|
|
272 <entry></entry>
|
|
273 </row>
|
|
274
|
|
275 <row>
|
|
276 <entry>C-Media cards (which ones?)</entry>
|
|
277 <entry>not OK (hissing) (?)</entry>
|
|
278 <entry>OK</entry>
|
|
279 <entry></entry>
|
|
280 <entry></entry>
|
|
281 <entry>?</entry>
|
|
282 <entry></entry>
|
|
283 <entry></entry>
|
|
284 </row>
|
|
285
|
|
286 <row>
|
|
287 <entry>Yamaha cards (*ymf*)</entry>
|
|
288 <entry>not OK (?) (maybe <option>-ao sdl</option>)</entry>
|
|
289 <entry>OK only with ALSA 0.5 with OSS emulation
|
|
290 <emphasis role="bold">AND</emphasis> <option>-ao sdl</option> (!) (?)</entry>
|
|
291 <entry></entry>
|
|
292 <entry></entry>
|
|
293 <entry></entry>
|
|
294 <entry></entry>
|
|
295 <entry></entry>
|
|
296 </row>
|
|
297
|
|
298 <row>
|
|
299 <entry>Cards with envy24 chips (like Terratec EWS88MT)</entry>
|
|
300 <entry>?</entry>
|
|
301 <entry>?</entry>
|
|
302 <entry>OK</entry>
|
|
303 <entry></entry>
|
|
304 <entry>?</entry>
|
|
305 <entry></entry>
|
|
306 <entry></entry>
|
|
307 </row>
|
|
308
|
|
309 <row>
|
|
310 <entry>PC Speaker or DAC</entry>
|
|
311 <entry>OK</entry>
|
|
312 <entry>none</entry>
|
|
313 <entry></entry>
|
|
314 <entry>
|
|
315 <ulink url="http://www.geocities.com/stssppnn/pcsp.html">Linux PC speaker OSS driver</ulink>
|
|
316 </entry>
|
|
317 <entry>The driver emulates 44.1, maybe more.</entry>
|
|
318 <entry>mono</entry>
|
|
319 <entry>1</entry>
|
|
320 </row>
|
|
321
|
|
322 </tbody>
|
|
323 </tgroup>
|
|
324 </informaltable>
|
|
325
|
|
326 <para>
|
|
327 Feedback to this document is welcome. Please tell us how
|
|
328 <application>MPlayer</application> and your sound card(s) worked together.
|
|
329 </para>
|
|
330 </sect3>
|
|
331
|
|
332 <sect3 id="af">
|
|
333 <title>Audio filters</title>
|
|
334 <para>
|
|
335 The old audio plugins have been superseded by a new audio filter layer. Audio
|
|
336 filters are used for changing the properties of the audio data before the
|
|
337 sound reaches the sound card. The activation and deactivation of the filters
|
|
338 is normally automated but can be overridden. The filters are activated when
|
|
339 the properties of the audio data differ from those required by the sound card
|
|
340 and deactivated if unnecessary. The <option>-af filter1,filter2,...</option>
|
|
341 option is used to override the automatic activation of filters or to insert
|
|
342 filters that are not automatically inserted. The filters will be executed as
|
|
343 they appear in the comma separated list.
|
|
344 </para>
|
|
345
|
|
346 <para>
|
|
347 Example:
|
|
348 <screen>mplayer -af resample,pan movie.avi</screen>
|
|
349 would run the sound through the resampling filter followed by the pan filter.
|
|
350 Observe that the list must not contain any spaces, else it will fail.
|
|
351 </para>
|
|
352
|
|
353 <para>
|
|
354 The filters often have options that change their behavior. These options
|
|
355 are explained in detail in the sections below. A filter will execute using
|
|
356 default settings if its options are omitted. Here is an example of how to use
|
|
357 filters in combination with filter specific options:
|
|
358 <screen>mplayer -af resample=11025,pan=1:0.5:0.5 -channels 1 -srate 11025 media.avi</screen>
|
|
359 would set the output frequency of the resample filter to 11025Hz and downmix
|
|
360 the audio to 1 channel using the pan filter.
|
|
361 </para>
|
|
362
|
|
363
|
|
364 <para>
|
|
365 The overall execution of the filter layer is controlled using the
|
|
366 <option>-af-adv</option> option. This option has two suboptions:
|
|
367 </para>
|
|
368
|
|
369 <para>
|
|
370 <option>force</option> is a bit field that controls how the filters
|
|
371 are inserted and what speed/accuracy optimizations they use:
|
|
372 </para>
|
|
373
|
|
374 <variablelist>
|
|
375 <varlistentry>
|
|
376 <term><option>0</option></term>
|
|
377 <listitem><para>
|
|
378 Use automatic insertion of filters and optimize according to CPU speed.
|
|
379 </para></listitem>
|
|
380 </varlistentry>
|
|
381
|
|
382 <varlistentry>
|
|
383 <term><option>1</option></term>
|
|
384 <listitem><para>
|
|
385 Use automatic insertion of filters and optimize for the highest speed.
|
|
386 <emphasis>Warning:</emphasis> Some features in the audio filters may
|
|
387 silently fail, and the sound quality may drop.
|
|
388 </para></listitem>
|
|
389 </varlistentry>
|
|
390
|
|
391 <varlistentry>
|
|
392 <term><option>2</option></term>
|
|
393 <listitem><para>
|
|
394 Use automatic insertion of filters and optimize for quality.
|
|
395 </para></listitem>
|
|
396 </varlistentry>
|
|
397
|
|
398 <varlistentry>
|
|
399 <term><option>3</option></term>
|
|
400 <listitem><para>
|
|
401 Use no automatic insertion of filters and no optimization.
|
|
402 <emphasis>Warning:</emphasis> It may be possible to crash MPlayer
|
|
403 using this setting.
|
|
404 </para></listitem>
|
|
405 </varlistentry>
|
|
406
|
|
407 <varlistentry>
|
|
408 <term><option>4</option></term>
|
|
409 <listitem><para>
|
|
410 Use automatic insertion of filters according to 0 above,
|
|
411 but use floating point processing when possible.
|
|
412 </para></listitem>
|
|
413 </varlistentry>
|
|
414
|
|
415 <varlistentry>
|
|
416 <term><option>5</option></term>
|
|
417 <listitem><para>
|
|
418 Use automatic insertion of filters according to 1 above,
|
|
419 but use floating point processing when possible.
|
|
420 </para></listitem>
|
|
421 </varlistentry>
|
|
422
|
|
423 <varlistentry>
|
|
424 <term><option>6</option></term>
|
|
425 <listitem><para>
|
|
426 Use automatic insertion of filters according to 2 above,
|
|
427 but use floating point processing when possible.
|
|
428 </para></listitem>
|
|
429 </varlistentry>
|
|
430
|
|
431 <varlistentry>
|
|
432 <term><option>7</option></term>
|
|
433 <listitem><para>
|
|
434 Use no automatic insertion of filters according to 3 above,
|
|
435 and use floating point processing when possible.
|
|
436 </para></listitem>
|
|
437 </varlistentry>
|
|
438 </variablelist>
|
|
439
|
|
440 <para>
|
|
441 <option>list</option> is an alias for the -af option.
|
|
442 </para>
|
|
443
|
|
444 <para>
|
|
445 The filter layer is also affected by the following generic options:
|
|
446 </para>
|
|
447
|
|
448 <variablelist>
|
|
449 <varlistentry>
|
|
450 <term><option>-v</option></term>
|
|
451 <listitem><para>
|
|
452 Increases the verbosity level and makes most filters print out extra
|
|
453 status messages.
|
|
454 </para></listitem>
|
|
455 </varlistentry>
|
|
456
|
|
457 <varlistentry>
|
|
458 <term><option>-channels</option></term>
|
|
459 <listitem><para>
|
|
460 This option sets the number of output channels you would like your
|
|
461 sound card to use. It also affects the number of channels that are
|
|
462 being decoded from the media. If the media contains less channels
|
|
463 than requested the channels filter (see below) will automatically
|
|
464 be inserted. The routing will be the default routing for the channels
|
|
465 filter.
|
|
466 </para></listitem>
|
|
467 </varlistentry>
|
|
468
|
|
469 <varlistentry>
|
|
470 <term><option>-srate</option></term>
|
|
471 <listitem><para>
|
|
472 This option selects the sample rate you would like your sound card
|
|
473 to use (of course the cards have limits on this). If the sample frequency
|
|
474 of your sound card is different from that of the current media, the resample
|
|
475 filter (see below) will be inserted into the audio filter layer to compensate
|
|
476 for the difference.
|
|
477 </para></listitem>
|
|
478 </varlistentry>
|
|
479 <varlistentry>
|
|
480 <term><option>-format</option></term>
|
|
481 <listitem><para>
|
|
482 This option sets the sample format between the audio filter layer and the
|
|
483 sound card. If the requested sample format of your sound card is different
|
|
484 from that of the current media, a format filter (see below) will be inserted
|
|
485 to rectify the difference.
|
|
486 </para></listitem>
|
|
487 </varlistentry>
|
|
488 </variablelist>
|
|
489
|
|
490 <sect4 id="af_resample">
|
|
491 <title>Up/Downsampling</title>
|
|
492
|
|
493 <para>
|
|
494 MPlayer fully supports sound up/down-sampling through the
|
|
495 <systemitem>resample</systemitem> filter. It can be used if you
|
|
496 have a fixed frequency sound card or if you are stuck with an old sound card
|
|
497 that is only capable of max 44.1kHz. This filter is automatically enabled if
|
|
498 it is necessary, but it can also be explicitly enabled on the command line. It
|
|
499 has three options:
|
|
500 </para>
|
|
501
|
|
502 <variablelist>
|
|
503 <varlistentry>
|
|
504 <term><option>srate <8000-192000></option></term>
|
|
505 <listitem><para>
|
|
506 is an integer used for setting the output sample
|
|
507 frequency in Hz. The valid range for this parameter is 8kHz to 192kHz. If
|
|
508 the input and output sample frequency are the same or if this parameter is
|
|
509 omitted the filter is automatically unloaded. A high sample frequency
|
|
510 normally improves the audio quality, especially when used in combination
|
|
511 with other filters.
|
|
512 </para></listitem>
|
|
513 </varlistentry>
|
|
514
|
|
515 <varlistentry>
|
|
516 <term><option>sloppy</option></term>
|
|
517 <listitem><para>
|
|
518 is an optional binary parameter that allows the output frequency to differ
|
|
519 slightly from the frequency given by <option>srate</option>. This option
|
|
520 can be used if the startup of the playback is extremely slow. It is enabled
|
|
521 by default.
|
|
522 </para></listitem>
|
|
523 </varlistentry>
|
|
524
|
|
525 <varlistentry>
|
|
526 <term><option>type <0-2></option></term>
|
|
527 <listitem><para>
|
|
528 is an optional integer between <literal>0</literal> and <literal>2</literal> that
|
|
529 selects which resampling method to use. Here <literal>0</literal> represents
|
|
530 linear interpolation as resampling method, <literal>1</literal> represents
|
|
531 resampling using a poly-phase filter-bank and integer processing and
|
|
532 <literal>2</literal> represents resampling using a poly-phase filter-bank and
|
|
533 floating point processing. Linear interpolation is extremely fast, but
|
|
534 suffers from poor sound quality especially when used for up-sampling. The
|
|
535 best quality is given by <literal>2</literal> but this method also suffers from
|
|
536 the highest CPU load.
|
|
537 </para></listitem>
|
|
538 </varlistentry>
|
|
539 </variablelist>
|
|
540
|
|
541 <para>Example:
|
|
542 <screen>mplayer -af resample=44100:0:0</screen>
|
|
543 would set the output frequency of the resample filter to 44100Hz using exact output
|
|
544 frequency scaling and linear interpolation.
|
|
545 </para>
|
|
546 </sect4>
|
|
547
|
|
548 <sect4 id="af_channels">
|
|
549 <title>Changing the number of channels</title>
|
|
550 <para>
|
|
551 The <option>channels</option> filter can be used for adding and removing
|
|
552 channels, it can also be used for routing or copying channels. It is
|
|
553 automatically enabled when the output from the audio filter layer differs from
|
|
554 the input layer or when it is requested by another filter. This filter unloads
|
|
555 itself if not needed. The number of options is dynamic:
|
|
556 </para>
|
|
557
|
|
558 <variablelist>
|
|
559 <varlistentry>
|
|
560 <term><option>nch <1-6></option></term>
|
|
561 <listitem><para>
|
|
562 is an integer between <literal>1</literal> and <literal>6</literal> that is used
|
|
563 for setting the number of output channels. This option is required, leaving it
|
|
564 empty results in a runtime error.
|
|
565 </para></listitem>
|
|
566 </varlistentry>
|
|
567
|
|
568 <varlistentry>
|
|
569 <term><option>nr <1-6></option></term>
|
|
570 <listitem><para>
|
|
571 is an integer between <literal>1</literal> and <literal>6</literal> that is used
|
|
572 for specifying the number of routes. This parameter is optional. If it is
|
|
573 omitted the default routing is used.
|
|
574 </para></listitem>
|
|
575 </varlistentry>
|
|
576
|
|
577 <varlistentry>
|
|
578 <term><option>from1:to1:from2:to2:from3:to3...</option></term>
|
|
579 <listitem><para>
|
|
580 are pairs of numbers between <literal>0</literal> and <literal>5</literal>
|
|
581 that define where each channel should be routed.
|
|
582 </para></listitem>
|
|
583 </varlistentry>
|
|
584 </variablelist>
|
|
585
|
|
586 <para>
|
|
587 If only <option>nch</option> is given the default routing is used, it works
|
|
588 as follows: If the number of output channels is bigger than the number of input
|
|
589 channels empty channels are inserted (except mixing from mono to stereo, then
|
|
590 the mono channel is repeated in both of the output channels). If the number of
|
|
591 output channels is smaller than the number of input channels the exceeding
|
|
592 channels are truncated.
|
|
593 </para>
|
|
594
|
|
595 <para>
|
|
596 Example 1:
|
|
597 <screen>mplayer -af channels=4:4:0:1:1:0:2:2:3:3 media.avi</screen>
|
|
598 would change the number of channels to 4 and set up 4 routes that swap
|
|
599 channel 0 and channel 1 and leave channel 2 and 3 intact. Observe that
|
|
600 if media containing two channels was played back, channels 2 and 3 would
|
|
601 contain silence but 0 and 1 would still be swapped.
|
|
602 </para>
|
|
603
|
|
604 <para>
|
10111
|
605 Example 2:
|
9675
|
606 <screen>mplayer -af channels=6:4:0:0:0:1:0:2:0:3 media.avi</screen>
|
|
607 would change the number of channels to 6 and set up 4 routes that copy
|
|
608 channel 0 to channels 0 to 3. Channel 4 and 5 will contain silence.
|
|
609 </para>
|
|
610 </sect4>
|
|
611
|
|
612 <sect4 id="af_format">
|
|
613 <title>Sample format converter</title>
|
|
614 <para>
|
|
615 The <option>format</option> filter converts between different sample formats. It
|
|
616 is automatically enabled when needed by the sound card or another filter.
|
|
617 </para>
|
|
618
|
|
619 <variablelist>
|
|
620 <varlistentry>
|
|
621 <term><option>bps <number></option></term>
|
|
622 <listitem><para>
|
|
623 can be <literal>1</literal>, <literal>2</literal> or <literal>4</literal> and
|
|
624 denotes the number of bytes per sample. This option is required, leaving it empty
|
|
625 results in a runtime error.
|
|
626 </para></listitem>
|
|
627 </varlistentry>
|
|
628
|
|
629 <varlistentry>
|
|
630 <term><option>f <format></option></term>
|
|
631 <listitem><para>
|
|
632 is a text string describing the sample format. The string is a
|
|
633 concatenated mix of: <option>alaw</option>, <option>mulaw</option> or
|
|
634 <option>imaadpcm</option>, <option>float</option> or <option>int</option>,
|
|
635 <option>unsigned</option> or <option>signed</option>, <option>le</option> or
|
|
636 <option>be</option> (little or big endian). This option is required,
|
|
637 leaving it empty results in a runtime error.
|
|
638 </para></listitem>
|
|
639 </varlistentry>
|
|
640 </variablelist>
|
|
641
|
|
642 <para>
|
|
643 Example:
|
|
644 <screen>mplayer -af format=4:float media.avi</screen>
|
|
645 would set the output format to 4 bytes per sample floating point data.
|
|
646 </para>
|
|
647 </sect4>
|
|
648
|
|
649 <sect4 id="af_delay">
|
|
650 <title>Delay</title>
|
|
651 <para>
|
10111
|
652 The <option>delay</option> filter delays the sound to the loudspeakers such that
|
9675
|
653 the sound from the different channels arrives at the listening position
|
|
654 simultaneously.
|
|
655 It is only useful if you have more than 2 loudspeakers. This filter has a
|
|
656 variable number of parameters:
|
|
657 </para>
|
|
658
|
|
659 <variablelist>
|
|
660 <varlistentry>
|
|
661 <term><option>d1:d2:d3...</option></term>
|
|
662 <listitem><para>
|
|
663 are floating point numbers representing the delays in ms that should be
|
|
664 imposed on the different channels. The minimum delay is 0ms and the maximum
|
|
665 is 1000ms.
|
|
666 </para></listitem>
|
|
667 </varlistentry>
|
|
668 </variablelist>
|
|
669
|
|
670 <para>
|
|
671 To calculate the required delay for the different channels do as follows:
|
|
672 </para>
|
|
673
|
|
674 <orderedlist>
|
|
675 <listitem><para>
|
|
676 Measure the distance to the loudspeakers in meters in relation to your
|
|
677 listening position, giving you the distances s1 to s5 (for a 5.1 system).
|
|
678 There is no point in compensating for the sub-woofer (you will not hear the
|
|
679 difference anyway).
|
|
680 </para></listitem>
|
|
681 <listitem><para>
|
|
682 Subtract the distances s1 to s5 from the maximum distance i.e.
|
|
683 s[i] = max(s) - s[i]; i = 1...5
|
|
684 </para></listitem>
|
|
685 <listitem><para>
|
10111
|
686 Calculated the required delays in ms as
|
9675
|
687 d[i] = 1000*s[i]/342; i = 1...5
|
|
688 s[i] = max(s) - s[i]; i = 1...5
|
|
689 </para></listitem>
|
|
690 </orderedlist>
|
|
691
|
|
692 <para>
|
|
693 Example:
|
|
694 <screen>mplayer -af delay=10.5:10.5:0:0:7:0 media.avi</screen>
|
|
695 would delay front left and right by 10.5ms, the two rear channels and the sub
|
|
696 by 0ms and the center channel by 7ms.
|
|
697 </para>
|
|
698
|
|
699 </sect4>
|
|
700
|
|
701 <sect4 id="af_volume">
|
|
702 <title>Software volume control</title>
|
|
703 <para>Software volume control is implemented by the <option>volume</option>
|
|
704 audio filter. Use this filter with caution since it can reduce the signal to
|
|
705 noise ratio of the sound. In most cases it is best to set the level for the
|
|
706 PCM sound to max, leave this filter out and control the output level to your
|
|
707 speakers with the master volume control of the mixer. In case your sound card
|
|
708 has a digital PCM mixer instead of an analog one, and you hear distortion,
|
|
709 use the MASTER mixer instead. If there is an external amplifier connected to
|
|
710 the computer (this is almost always the case), the noise level can be minimized
|
|
711 by adjusting the master level and the volume knob on the amplifier until the
|
|
712 hissing noise in the background is gone. This filter has two options:
|
|
713 </para>
|
|
714
|
|
715 <variablelist>
|
|
716 <varlistentry>
|
|
717 <term><option>v <-200 - +60></option></term>
|
|
718 <listitem><para>
|
|
719 is a floating point number between <literal>-200</literal> and <literal>+60</literal>
|
|
720 which represents the volume level in dB. The default level is 0dB.
|
|
721 </para></listitem>
|
|
722 </varlistentry>
|
|
723
|
|
724 <varlistentry>
|
|
725 <term><option>c</option></term>
|
|
726 <listitem><para>
|
|
727 is a binary control that turns soft clipping on and off. Soft-clipping can
|
|
728 make the sound more smooth if very high volume levels are used. Enable this
|
|
729 option if the dynamic range of the loudspeakers is very low. Be aware that
|
|
730 this feature creates distortion and should be considered a last resort.
|
|
731 </para></listitem>
|
|
732 </varlistentry>
|
|
733 </variablelist>
|
|
734
|
|
735 <para>
|
|
736 Example:
|
|
737 <screen>mplayer -af volume=10.1:0 media.avi</screen>
|
|
738 would amplify the sound by 10.1dB and hard-clip if the sound level is too high.
|
|
739 </para>
|
|
740
|
|
741 <para>
|
|
742 This filter has a second feature: It measures the overall maximum sound level
|
|
743 and prints out that level when MPlayer exits. This volume estimate can be used
|
|
744 for setting the sound level in MEncoder such that the maximum dynamic range is
|
|
745 utilized.
|
|
746 </para>
|
|
747 </sect4>
|
|
748
|
|
749 <sect4 id="af_equalizer">
|
|
750 <title>Equalizer</title>
|
|
751 <para>
|
|
752 The <option>equalizer</option> filter represents a 10 octave band graphic
|
|
753 equalizer, implemented using 10 IIR band pass filters. This means that
|
|
754 it works regardless of what type of audio is being played back. The center
|
|
755 frequencies for the 10 bands are:
|
|
756 </para>
|
|
757
|
|
758 <informaltable>
|
|
759 <tgroup cols="2">
|
|
760 <thead>
|
|
761 <row>
|
|
762 <entry>Band No.</entry><entry>Center frequency</entry>
|
|
763 </row>
|
|
764 </thead>
|
|
765 <tbody>
|
|
766 <row><entry>0</entry><entry>31.25 Hz</entry></row>
|
|
767 <row><entry>1</entry><entry>62.50 Hz</entry></row>
|
|
768 <row><entry>2</entry><entry>125.0 Hz</entry></row>
|
|
769 <row><entry>3</entry><entry>250.0 Hz</entry></row>
|
|
770 <row><entry>4</entry><entry>500.0 Hz</entry></row>
|
|
771 <row><entry>5</entry><entry>1.000 kHz</entry></row>
|
|
772 <row><entry>6</entry><entry>2.000 kHz</entry></row>
|
|
773 <row><entry>7</entry><entry>4.000 kHz</entry></row>
|
|
774 <row><entry>8</entry><entry>8.000 kHz</entry></row>
|
|
775 <row><entry>9</entry><entry>16.00 kHz</entry></row>
|
|
776 </tbody>
|
|
777 </tgroup>
|
|
778 </informaltable>
|
|
779
|
|
780 <para>
|
|
781 If the sample rate of the sound being played back is lower than the center
|
|
782 frequency for a frequency band, then that band will be disabled. A known
|
|
783 bug with this filter is that the characteristics for the uppermost band
|
|
784 are not completely symmetric if the sample rate is close to the center
|
|
785 frequency of that band. This problem can be worked around by up-sampling
|
|
786 the sound using the resample filter before it reaches this filter.
|
|
787 </para>
|
|
788
|
|
789 <para>
|
|
790 This filter has 10 parameters:
|
|
791 </para>
|
|
792
|
|
793 <variablelist>
|
|
794 <varlistentry>
|
|
795 <term><option>g1:g2:g3...g10</option></term>
|
|
796 <listitem><para>
|
|
797 are floating point numbers between <literal>-12</literal> and <literal>+12</literal>
|
|
798 representing the gain in dB for each frequency band.
|
|
799 </para></listitem>
|
|
800 </varlistentry>
|
|
801 </variablelist>
|
|
802
|
|
803 <para>
|
|
804 Example:
|
|
805 <screen>mplayer -af equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi</screen>
|
|
806 would amplify the sound in the upper and lower frequency region while
|
|
807 canceling it almost completely around 1kHz.
|
|
808 </para>
|
|
809 </sect4>
|
|
810
|
|
811 <sect4 id="af_panning">
|
|
812 <title>Panning filter</title>
|
|
813 <para>
|
|
814 Use the <option>pan</option> filter to mix channels arbitrarily. It is
|
|
815 basically a combination of the volume control and the channels filter.
|
|
816 There are two major uses for this filter:
|
|
817 </para>
|
|
818
|
|
819 <orderedlist>
|
|
820 <listitem><para>
|
|
821 Down-mixing many channels to only a few, stereo to mono for example.
|
|
822 </para></listitem>
|
|
823 <listitem><para>
|
|
824 Varying the "width" of the center speaker in a surround sound system.
|
|
825 </para></listitem>
|
|
826 </orderedlist>
|
|
827
|
|
828 <para>
|
|
829 This filter is hard to use, and will require some tinkering before the
|
|
830 desired result is obtained. The number of options for this filter
|
|
831 depends on the number of output channels:
|
|
832 </para>
|
|
833
|
|
834 <variablelist>
|
|
835 <varlistentry>
|
|
836 <term><option>nch <1-6></option></term>
|
|
837 <listitem><para>
|
|
838 is an integer between <literal>1</literal> and <literal>6</literal> and is used
|
|
839 for setting the number of output channels. This option is required, leaving it
|
|
840 empty results in a runtime error.
|
|
841 </para></listitem>
|
|
842 </varlistentry>
|
|
843
|
|
844 <varlistentry>
|
|
845 <term><option>l00:l01:l02:..l10:l11:l12:...ln0:ln1:ln2:...</option></term>
|
|
846 <listitem><para>
|
|
847 are floating point values between <literal>0</literal> and <literal>1</literal>.
|
|
848 <option>l[i][j]</option> determines how much of input channel j is mixed into
|
|
849 output channel i.
|
|
850 </para></listitem>
|
|
851 </varlistentry>
|
|
852 </variablelist>
|
|
853
|
|
854 <para>
|
|
855 Example 1:
|
|
856 <screen>mplayer -af pan=1:0.5:0.5 -channels 1 media.avi</screen>
|
|
857 would down-mix from stereo to mono.
|
|
858 </para>
|
|
859
|
|
860 <para>
|
|
861 Example 2:
|
|
862 <screen>mplayer -af pan=3:1:0:1:0.5:0.5 -channels 3 media.avi</screen>
|
|
863 would give 3 channel output leaving channels 0 and 1 intact, and mix
|
|
864 channels 0 and 1 into output channel 2 (which could be sent to a
|
|
865 sub-woofer for example).
|
|
866 </para>
|
|
867 </sect4>
|
|
868
|
|
869 <sect4 id="af_sub">
|
|
870 <title>Sub-woofer</title>
|
|
871 <para>
|
10111
|
872 The <option>sub</option> filter adds a sub woofer channel to the audio
|
9675
|
873 stream. The audio data used for creating the sub-woofer channel is an
|
|
874 average of the sound in channel 0 and channel 1. The resulting sound is
|
|
875 then low-pass filtered by a 4th order Butterworth filter with a default
|
|
876 cutoff frequency of 60Hz and added to a separate channel in the audio
|
|
877 stream. Warning: Disable this filter when you are playing DVDs with Dolby
|
|
878 Digital 5.1 sound, otherwise this filter will disrupt the sound to the
|
|
879 sub-woofer. This filter has two parameters:
|
|
880 </para>
|
|
881
|
|
882 <variablelist>
|
|
883 <varlistentry>
|
|
884 <term><option>fc <20-300></option></term>
|
|
885 <listitem><para>
|
|
886 is an optional floating point number used for setting the cutoff frequency
|
|
887 for the filter in Hz. The valid range is 20Hz to 300Hz. For the best result
|
|
888 try setting the cutoff frequency as low as possible. This will improve the
|
|
889 stereo or surround sound experience. The default cutoff frequency is 60Hz.
|
|
890 </para></listitem>
|
|
891 </varlistentry>
|
|
892
|
|
893 <varlistentry>
|
|
894 <term><option>ch <0-5></option></term>
|
|
895 <listitem><para>
|
|
896 is an optional integer between <literal>0</literal> and <literal>5</literal>
|
|
897 which determines the channel number in which to insert the sub-channel audio.
|
|
898 The default is channel number <literal>5</literal>. Observe that the number of
|
|
899 channels will automatically be increased to <replaceable>ch</replaceable> if
|
|
900 necessary.
|
|
901 </para></listitem>
|
|
902 </varlistentry>
|
|
903 </variablelist>
|
|
904
|
|
905 <para>
|
|
906 Example:
|
|
907 <screen>mplayer -af sub=100:4 -channels 5 media.avi</screen>
|
|
908 would add a sub-woofer channel with a cutoff frequency of
|
|
909 100Hz to output channel 4.
|
|
910 </para>
|
|
911 </sect4>
|
|
912
|
|
913 <sect4 id="af_surround">
|
|
914 <title>Surround-sound decoder</title>
|
|
915 <para>
|
|
916 Matrix encoded surround sound can be decoded by the <option>surround</option>
|
|
917 filter. Dolby Surround is an example of a matrix encoded format. Many files
|
|
918 with 2 channel audio actually contain matrixed surround sound. To use this
|
|
919 feature you need a sound card supporting at least 4 channels. This filter has
|
|
920 one parameter:
|
|
921 </para>
|
|
922
|
|
923 <variablelist>
|
|
924 <varlistentry>
|
|
925 <term><option>d <0-1000></option></term>
|
|
926 <listitem><para>
|
|
927 is an optional floating point number between <literal>0</literal> and
|
|
928 <literal>1000</literal> used for setting the delay time in ms for the
|
|
929 rear speakers. This delay should be set as follows: if d1 is the distance
|
|
930 from the listening position to the front speakers and d2 is the distance
|
|
931 from the listening position to the rear speakers, then the delay d should
|
|
932 be set to 15ms if d1 <= d2 and to 15 + 5*(d1-d2) if d1 > d2. The default
|
|
933 value for d is 20ms.
|
|
934 </para></listitem>
|
|
935 </varlistentry>
|
|
936 </variablelist>
|
|
937
|
|
938 <para>
|
|
939 Example:
|
|
940 <screen>mplayer -af surround=15 -channels 4 media.avi</screen>
|
|
941 would add surround sound decoding with 15ms delay for the sound to the
|
|
942 rear speakers.
|
|
943 </para>
|
|
944 </sect4>
|
|
945 </sect3>
|
|
946
|
|
947 <sect3 id="audio-plugins">
|
|
948 <title>Audio plugins (deprecated)</title>
|
|
949 <note><para><emphasis role="bold">Audio plugins have been deprecated by audio filters and will
|
|
950 be removed soon.</emphasis></para></note>
|
|
951
|
|
952 <para>
|
|
953 <application>MPlayer</application> has support for audio plugins. Audio
|
|
954 plugins can be used for changing the properties of the audio data before
|
|
955 the sound reaches the sound card. They are enabled using the
|
|
956 <option>-aop</option> switch which takes a
|
|
957 <option>list=plugin1,plugin2,...</option> argument. The
|
|
958 <option>list</option> argument is required and determines which plugins
|
|
959 should be used and in which order they should be executed. Example:
|
|
960
|
|
961 <screen>mplayer media.avi -aop list=resample,format</screen>
|
|
962
|
|
963 would run the sound through the resampling plugin followed by the format
|
|
964 plugin.
|
|
965 </para>
|
|
966
|
|
967 <para>
|
|
968 The plugins can also have switches that change their behavior. These
|
|
969 switches are explained in detail in the sections below. A plugin will
|
|
970 execute using default settings if its switches are omitted. Here is an
|
|
971 example of how to use plugins in combination with plugin specific switches:
|
|
972
|
|
973 <screen>mplayer media.avi -aop list=resample,format:fout=44100:format=0x8</screen>
|
|
974
|
|
975 would set the output frequency of the resample plugin to 44100 Hz and the
|
|
976 output format of the format plugin to AFMT_U8.
|
|
977 </para>
|
|
978
|
|
979 <para>
|
|
980 Currently audio plugins can not be used in
|
|
981 <application>MEncoder</application>.
|
|
982 </para>
|
|
983
|
|
984
|
|
985 <sect4 id="updn-sampling">
|
|
986 <title>Up/Downsampling</title>
|
|
987
|
|
988 <para>
|
|
989 <application>MPlayer</application> fully supports up/downsampling of the sound. This plugin can be
|
|
990 used if you have a fixed frequency sound card or if you are stuck with an
|
|
991 old sound card that is only capable of max 44.1 kHz. Limitations in your
|
|
992 hardware are not auto detected, so you have to specify the sample frequency
|
|
993 explicitly. This plugin has one switch: <option>fout</option> which is used for setting the
|
|
994 desired output sample frequency. It defaults to 48 kHz, and is given in
|
|
995 Hz.
|
|
996 </para>
|
|
997
|
|
998 <para>
|
|
999 Usage:
|
|
1000
|
|
1001 <screen>
|
|
1002 mplayer <replaceable>media.avi</replaceable> -aop list=resample:fout=<replaceable>freq</replaceable></screen>
|
|
1003
|
|
1004 where <literal><replaceable>freq</replaceable></literal> is the frequency
|
|
1005 in Hz, like <literal>44100</literal>.
|
|
1006 </para>
|
|
1007
|
|
1008 <note>
|
|
1009 <para>
|
|
1010 The output frequency should not be scaled up from the default value.
|
|
1011 Scaling up will cause the audio and video streams to be played in slow
|
|
1012 motion in addition to audio distortion.
|
|
1013 </para>
|
|
1014 </note>
|
|
1015 </sect4>
|
|
1016
|
|
1017
|
|
1018 <sect4 id="surround-decode">
|
|
1019 <title>Surround Sound decoding</title>
|
|
1020
|
|
1021 <para>
|
|
1022 <application>MPlayer</application> has an audio plugin that can decode
|
|
1023 matrix encoded surround sound. Dolby Surround is an example of a matrix
|
|
1024 encoded format. Many files with 2 channel audio actually contain matrixed
|
|
1025 surround sound. To use this feature you need a sound card supporting at
|
|
1026 least 4 channels.
|
|
1027 </para>
|
|
1028
|
|
1029 <para>
|
|
1030 Usage:
|
|
1031 <screen>mplayer <replaceable>media.avi</replaceable> -aop list=surround</screen>
|
|
1032 </para>
|
|
1033 </sect4>
|
|
1034
|
|
1035
|
|
1036 <sect4 id="sample-format-conv">
|
|
1037 <title>Sample format converter</title>
|
|
1038
|
|
1039 <para>
|
|
1040 If your sound card driver does not support signed 16-bit int data type,
|
|
1041 this plugin can be used to change the format to one which your sound card
|
|
1042 can understand. It has one switch, <option>format</option>, which can be
|
|
1043 set to one of the numbers found in <filename>libao2/afmt.h</filename>. This
|
|
1044 plugin is hardly ever needed and is intended for advanced users. Keep in
|
|
1045 mind that this plugin only changes the sample format and not the sample
|
|
1046 frequency or the number of channels.
|
|
1047 </para>
|
|
1048
|
|
1049 <para>
|
|
1050 Usage:
|
|
1051
|
|
1052 <screen>
|
|
1053 mplayer <replaceable>media.avi</replaceable> -aop list=format:format=<replaceable>outfmt</replaceable></screen>
|
|
1054
|
|
1055 where <literal><replaceable>outfmt</replaceable></literal> is the
|
|
1056 required output format.
|
|
1057 </para>
|
|
1058 </sect4>
|
|
1059
|
|
1060
|
|
1061 <sect4 id="audio-delay">
|
|
1062 <title>Delay</title>
|
|
1063 <para>
|
|
1064 This plugin delays the sound and is intended as an example of how to
|
|
1065 develop new plugins. It can not be used for anything useful from a users
|
|
1066 perspective and is mentioned here for the sake of completeness only. Do not
|
|
1067 use this plugin unless you are a developer.
|
|
1068 </para>
|
|
1069 </sect4>
|
|
1070
|
|
1071
|
|
1072 <sect4 id="sw-volume">
|
|
1073 <title>Software volume control</title>
|
|
1074
|
|
1075 <para>
|
|
1076 This plugin is a software replacement for the volume control, and can be
|
|
1077 used on machines with a broken mixer device. It can also be used if one
|
|
1078 wants to change the output volume of <application>MPlayer</application>
|
|
1079 without changing the PCM volume setting in the mixer. It has one switch
|
|
1080 <option>volume</option> that is used for setting the initial sound level.
|
|
1081 The initial sound level can be set to values between 0 and 255 and defaults
|
|
1082 to 101 which equals 0dB amplification. Use this plugin with caution since
|
|
1083 it can reduce the signal to noise ratio of the sound. In most cases it is
|
|
1084 best to set the level for the PCM sound to max, leave this plugin out and
|
|
1085 control the output level to your speakers with the master volume control of
|
|
1086 the mixer. If there is an external amplifier connected to the computer
|
|
1087 (this is almost always the case), the noise level can be minimized by
|
|
1088 adjusting the master level and the volume knob on the amplifier until the
|
|
1089 hissing noise in the background is gone.
|
|
1090 </para>
|
|
1091
|
|
1092 <para>
|
|
1093 Usage:
|
|
1094 <screen>
|
|
1095 mplayer <replaceable>media.avi</replaceable> -aop list=volume:volume=<replaceable>0-255</replaceable></screen>
|
|
1096 </para>
|
|
1097
|
|
1098 <para>
|
|
1099 This plugin also has compressor or "soft-clipping" capabilities.
|
|
1100 Compression can be used if the dynamic range of the sound is very high or
|
|
1101 if the dynamic range of the loudspeakers is very low. Be aware that this
|
|
1102 feature creates distortion and should be considered a last resort.
|
|
1103 </para>
|
|
1104
|
|
1105 <para>
|
|
1106 Usage:
|
|
1107 <screen>
|
|
1108 mplayer <replaceable>media.avi</replaceable> -aop list=volume:softclip</screen>
|
|
1109 </para>
|
|
1110 </sect4>
|
|
1111
|
|
1112 <sect4 id="extrastereo">
|
|
1113 <title>Extrastereo</title>
|
|
1114
|
|
1115 <para>
|
|
1116 This plugin (linearly) increases the difference between left and right
|
10111
|
1117 channels (like the <application>XMMS</application> extrastereo plugin) which gives some
|
|
1118 sort of "live" effect to playback.
|
9675
|
1119 </para>
|
|
1120
|
|
1121 <para>
|
|
1122 Usage:
|
|
1123 <screen>
|
|
1124 mplayer <replaceable>media.avi</replaceable> -aop list=extrastereo
|
|
1125 mplayer <replaceable>media.avi</replaceable> -aop list=extrastereo:mul=3.45<!--
|
|
1126 --></screen>
|
|
1127
|
|
1128 The default coefficient (<option>mul</option>) is a float number that
|
|
1129 defaults to 2.5. If you set it to <literal>0.0</literal>, you will have
|
|
1130 mono sound (average of both channels). If you set it to
|
|
1131 <literal>1.0</literal>, sound will be unchanged, if you set it to
|
|
1132 <literal>-1.0</literal>, left and right channels will be swapped.
|
|
1133 </para>
|
|
1134 </sect4>
|
|
1135
|
|
1136
|
|
1137 <sect4 id="volnorm">
|
|
1138 <title>Volume normalizer</title>
|
|
1139
|
|
1140 <para>
|
|
1141 This plugin maximizes the volume without distorting the sound.
|
|
1142 </para>
|
|
1143
|
|
1144 <para>
|
|
1145 Usage:
|
|
1146 <screen>mplayer <replaceable>media.avi</replaceable> -aop list=volnorm</screen>
|
|
1147 </para>
|
|
1148 </sect4>
|
|
1149 </sect3>
|
|
1150 </sect2>
|