annotate DOCS/xml/en/audio.xml @ 13975:3057f70f5295

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