annotate DOCS/en/sound.html @ 9481:0b0725c9f3f7

sync
author nicolas
date Sat, 22 Feb 2003 15:38:36 +0000
parents 1b3444713694
children 6c6ea2b4cfdb
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6403
c0f189e49ee4 Background color now set by CSS, added doctype and default character set,
diego
parents: 6393
diff changeset
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
2 <HTML>
4982
6cb9d9a1716d HTML: different font handling - idea from new hp dezign
gabucino
parents: 4928
diff changeset
3
6cb9d9a1716d HTML: different font handling - idea from new hp dezign
gabucino
parents: 4928
diff changeset
4 <HEAD>
6882
f3f87f6bf5cf Added a uniform title: something - MPlayer - The Movie Player for Linux.
diego
parents: 6583
diff changeset
5 <TITLE>Sound - MPlayer - The Movie Player for Linux</TITLE>
6391
4e5c236ade69 small updates
gabucino
parents: 6353
diff changeset
6 <LINK REL="stylesheet" TYPE="text/css" HREF="default.css">
6403
c0f189e49ee4 Background color now set by CSS, added doctype and default character set,
diego
parents: 6393
diff changeset
7 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
4982
6cb9d9a1716d HTML: different font handling - idea from new hp dezign
gabucino
parents: 4928
diff changeset
8 </HEAD>
6cb9d9a1716d HTML: different font handling - idea from new hp dezign
gabucino
parents: 4928
diff changeset
9
6403
c0f189e49ee4 Background color now set by CSS, added doctype and default character set,
diego
parents: 6393
diff changeset
10 <BODY>
1704
a2e1432f7ac3 Arial font
gabucino
parents: 1686
diff changeset
11
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
12
7047
4f87cd0f642f Converted the docs to use proper headings tags.
diego
parents: 6998
diff changeset
13 <H3><A NAME="audio">2.3.2 Audio output devices</A></H3>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
14
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
15 <H4><A NAME="sync">2.3.2.1 Audio/Video synchronisation</A></H4>
8177
1f00a3d29b20 some TOC reorder
gabucino
parents: 7814
diff changeset
16
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7453
diff changeset
17 <P>MPlayer's audio interface is called <I>libao2</I>. It currently
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
18 contains these drivers:</P>
1892
70dbd25c128c jo sok ilyen ize.
gabucino
parents: 1704
diff changeset
19
8751
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
20 <DL>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
21 <DT>oss</DT>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
22 <DD>OSS (ioctl) driver (supports hardware AC3 passthrough)</DD>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
23
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
24 <DT>sdl</DT>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
25 <DD>SDL driver (supports sound daemons like <B>ESD</B> and <B>ARTS</B>)</DD>
8751
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
26
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
27 <DT>nas</DT>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
28 <DD>NAS (Network Audio System) driver</DD>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
29
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
30 <DT>alsa5</DT>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
31 <DD>native ALSA 0.5 driver</DD>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
32
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
33 <DT>alsa9</DT>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
34 <DD>native ALSA 0.9 driver (supports hardware AC3 passthrough)</DD>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
35
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
36 <DT>sun</DT>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
37 <DD>SUN audio driver (<CODE>/dev/audio</CODE>) for BSD and Solaris8 users</DD>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
38
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
39 <DT>arts</DT>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
40 <DD>native ARTS driver (mostly for KDE users)</DD>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
41
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
42 <DT>esd</DT>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
43 <DD>native ESD driver (mostly for GNOME users)</DD>
f117a4150786 We now have -ao esd.
diego
parents: 8750
diff changeset
44 </DL>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
45
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
46 <P>Linux sound card drivers have compatibility problems. This is because MPlayer
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
47 relies on an in-built feature of <EM>properly</EM> coded sound drivers that
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
48 enable them to maintain correct audio/video sync. Regrettably, some driver
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
49 authors don't take the care to code this feature since it is not needed for
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
50 playing MP3s or sound effects. </P>
8177
1f00a3d29b20 some TOC reorder
gabucino
parents: 7814
diff changeset
51
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
52 <P>Other media players like <A HREF="http://avifile.sourceforge.net">aviplay</A>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
53 or <A HREF="http://xine.sourceforge.net">xine</A> possibly work
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
54 out-of-the-box with these drivers because they use "simple" methods with
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
55 internal timing. Measuring showed that their methods are not as efficient
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
56 as MPlayer's. </P>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
57
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
58 <P>Using MPlayer with a properly written audio driver will never result
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
59 in A/V desyncs related to the audio, except only with very badly created
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
60 files (check the man page for workarounds).</P>
8177
1f00a3d29b20 some TOC reorder
gabucino
parents: 7814
diff changeset
61
1f00a3d29b20 some TOC reorder
gabucino
parents: 7814
diff changeset
62 <P>If you happen to have a bad audio driver, try the <CODE>-autosync</CODE>
1f00a3d29b20 some TOC reorder
gabucino
parents: 7814
diff changeset
63 option, it should sort out your problems. See the man page for detailed
1f00a3d29b20 some TOC reorder
gabucino
parents: 7814
diff changeset
64 information.</P>
1f00a3d29b20 some TOC reorder
gabucino
parents: 7814
diff changeset
65
1f00a3d29b20 some TOC reorder
gabucino
parents: 7814
diff changeset
66 <P>Some notes:</P>
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
67
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
68 <UL>
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
69 <LI>If you have an OSS driver, first try <CODE>-ao oss</CODE> (this is the
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
70 default). If you experience glitches, halts or anything out of the
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
71 ordinary, try <CODE>-ao sdl</CODE> (NOTE: You need to have SDL libraries
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
72 and header files installed). The SDL audio driver helps in a lot of cases
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
73 and also supports ESD (GNOME) and ARTS (KDE).</LI>
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
74 <LI>If you have ALSA version 0.5, then you almost always have to use
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
75 <CODE>-ao alsa5</CODE> , since ALSA 0.5 has buggy OSS emulation code, and
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
76 will <B>crash MPlayer</B> with a message like this:<BR>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
77 <CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE></LI>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
78 <LI>On Solaris, use the SUN audio driver with the <CODE>-ao sun</CODE> option,
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
79 otherwise neither video nor audio will work.</LI>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
80 <LI>If the sound clicks when playing from CD-ROM, turn on IRQ unmasking, e.g.
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
81 <CODE>hdparm -u1 /dev/cdrom</CODE> (<CODE>man hdparm</CODE>). This is
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
82 generally beneficial and described in more detail in the
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
83 <A HREF="cd-dvd.html#drives">CD-ROM section</A>.</LI>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
84 </UL>
1892
70dbd25c128c jo sok ilyen ize.
gabucino
parents: 1704
diff changeset
85
7047
4f87cd0f642f Converted the docs to use proper headings tags.
diego
parents: 6998
diff changeset
86
8177
1f00a3d29b20 some TOC reorder
gabucino
parents: 7814
diff changeset
87 <H4><A NAME="experiences">2.3.2.2 Sound Card experiences, recommendations</A></H4>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
88
7099
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7076
diff changeset
89 <P>On Linux, a 2.4.x kernel is highly recommended. Kernel 2.2 is not tested.</P>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7076
diff changeset
90
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
91 <P>Linux sound drivers are primarily provided by the free version of OSS. These
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
92 drivers have been superceded by <A HREF="http://www.alsa-project.org">ALSA</A>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
93 (Advanced Linux Sound Architecture) in the 2.5 development series. If your
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
94 distribution does not already use ALSA you may wish to try their drivers if
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
95 you experience sound problems. ALSA drivers are generally superior to OSS in
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
96 compatibility, performance and features. But some sound cards are only
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
97 supported by the commercial OSS drivers from
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
98 <A HREF="http://www.opensound.com/">4Front Technologies</A>. They also support
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
99 several non-Linux systems.</P>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
100
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
101 <TABLE BORDER="1" WIDTH="100%">
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
102
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
103 <TR>
9153
68efb63884b2 Table headers make for nicer tables and better semantic markup.
diego
parents: 9138
diff changeset
104 <TH ROWSPAN="2"><B>SOUND CARD</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup.
diego
parents: 9138
diff changeset
105 <TH COLSPAN="4"><B>DRIVER</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup.
diego
parents: 9138
diff changeset
106 <TH ROWSPAN="2"><B>Max kHz</B></TH>
9229
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
107 <TH ROWSPAN="2"><B>Max Channels</B></TH>
9282
513e02e2e553 fixing others' 10/100liters
gabucino
parents: 9229
diff changeset
108 <TH ROWSPAN="2"><B>Max Opens<FONT SIZE="-2"><A HREF=#note1>[1]</A></FONT></B></TH>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
109 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
110
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
111 <TR>
9153
68efb63884b2 Table headers make for nicer tables and better semantic markup.
diego
parents: 9138
diff changeset
112 <TH><B>OSS/Free</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup.
diego
parents: 9138
diff changeset
113 <TH><B>ALSA</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup.
diego
parents: 9138
diff changeset
114 <TH><B>OSS/Pro</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup.
diego
parents: 9138
diff changeset
115 <TH><B>other</B></TH>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
116 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
117
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
118 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
119 <TD><B>VIA onboard (686/A/B, 8233, 8235)</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
120 <TD><A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&amp;release_id=59602">via82cxxx_audio</A></TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
121 <TD>snd-via82xx</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
122 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
123 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
124 <TD>4-48 kHz or 48 kHz only, depending on the chipset</TD>
9229
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
125 <TD>&nbsp;</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
126 <TD>&nbsp;</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
127 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
128
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
129 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
130 <TD><B>Aureal Vortex 2</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
131 <TD>none</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
132 <TD>none</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
133 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
134 <TD><A HREF="http://aureal.sourceforge.net">Linux Aureal Drivers</A><BR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
135 <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">buffer size increased to 32k</A></TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
136 <TD>48</TD>
9229
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
137 <TD>4.1</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
138 <TD>5+</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
139 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
140
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
141 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
142 <TD><B>SB Live!</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
143 <TD>Analog OK, SP/DIF not working</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
144 <TD>Both OK</TD>
9229
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
145 <TD>Both OK</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
146 <TD><A HREF="http://opensource.creative.com">Creative's OSS driver (SP/DIF support)</A></TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
147 <TD>192</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
148 <TD>4.0/5.1</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
149 <TD>32</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
150 </TR>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
151
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
152 <TR>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
153 <TD><B>SB 128 PCI (es1371)</B></TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
154 <TD>OK</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
155 <TD>?</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
156 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
157 <TD>&nbsp;</TD>
9229
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
158 <TD>48</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
159 <TD>stereo</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
160 <TD>2</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
161 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
162
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
163 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
164 <TD><B>SB AWE 64</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
165 <TD>max 44kHz</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
166 <TD>48kHz sounds bad</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
167 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
168 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
169 <TD>48</TD>
9229
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
170 <TD>&nbsp;</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
171 <TD>&nbsp;</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
172 </TR>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
173
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
174 <TR>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
175 <TD><B>GUS PnP</B></TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
176 <TD>none</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
177 <TD>OK</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
178 <TD>OK</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
179 <TD>&nbsp;</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
180 <TD>48</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
181 <TD>&nbsp;</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
182 <TD>&nbsp;</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
183 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
184
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
185 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
186 <TD><B>Gravis UltraSound ACE</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
187 <TD>not OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
188 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
189 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
190 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
191 <TD>44</TD>
9229
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
192 <TD>&nbsp;</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
193 <TD>&nbsp;</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
194 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
195
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
196 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
197 <TD><B>Gravis UltraSound MAX</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
198 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
199 <TD>OK (?)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
200 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
201 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
202 <TD>48</TD>
9229
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
203 <TD>&nbsp;</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
204 <TD>&nbsp;</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
205 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
206
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
207 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
208 <TD><B>ESS 688</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
209 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
210 <TD>OK (?)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
211 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
212 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
213 <TD>48</TD>
9229
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
214 <TD>&nbsp;</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
215 <TD>&nbsp;</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
216 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
217
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
218 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
219 <TD><B>C-Media cards (which ones?)</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
220 <TD>not OK (hissing) (?)</TD>
9302
gabucino
parents: 9288
diff changeset
221 <TD>OK</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
222 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
223 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
224 <TD>?</TD>
9229
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
225 <TD>&nbsp;</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
226 <TD>&nbsp;</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
227 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
228
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
229 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
230 <TD><B>Yamaha cards (*ymf*)</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
231 <TD>not OK (?) (maybe <CODE>-ao sdl</CODE>)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
232 <TD>OK only with ALSA 0.5 with OSS emulation <B>AND</B>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
233 <CODE>-ao sdl</CODE> (!) (?)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
234 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
235 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
236 <TD>?</TD>
9229
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
237 <TD>&nbsp;</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
238 <TD>&nbsp;</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
239 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
240
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
241 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
242 <TD><B>Cards with envy24 chips (like Terratec EWS88MT)</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
243 <TD>?</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
244 <TD>?</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
245 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
246 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
247 <TD>?</TD>
9229
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
248 <TD>&nbsp;</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
249 <TD>&nbsp;</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
250 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
251
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
252 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
253 <TD><B>PC Speaker or DAC</B></TD>
9282
513e02e2e553 fixing others' 10/100liters
gabucino
parents: 9229
diff changeset
254 <TD>OK</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
255 <TD>none</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
256 <TD>&nbsp;</TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
257 <TD><A HREF="http://www.geocities.com/stssppnn/pcsp.html">Linux PC speaker OSS driver</a></TD>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
258 <TD>The driver emulates 44.1, maybe more.</TD>
9229
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
259 <TD>mono</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
260 <TD>1</TD>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
261 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
262
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
263 </TABLE>
7099
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7076
diff changeset
264
9282
513e02e2e553 fixing others' 10/100liters
gabucino
parents: 9229
diff changeset
265 <P><A NAME="note1"><B>[1]</B></A>: the number of applications that are able to use the
513e02e2e553 fixing others' 10/100liters
gabucino
parents: 9229
diff changeset
266 device <I>at the same time</I>.</P>
513e02e2e553 fixing others' 10/100liters
gabucino
parents: 9229
diff changeset
267
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7453
diff changeset
268 <P>Feedback to this document is welcome. Please tell us how MPlayer
7099
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7076
diff changeset
269 and your sound card(s) worked together.</P>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
270
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
271
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
272 <H4><A NAME="af">2.3.2.3 Audio filters</A></H4>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
273
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
274 <P>The old audio plugins have been superseded by a new audio filter layer. Audio
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
275 filters are used for changing the properties of the audio data before the
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
276 sound reaches the sound card. The activation and deactivation of the filters
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
277 is normally automated but can be overridden. The filters are activated when
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
278 the properties of the audio data differ from those required by the sound card
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
279 and deactivated if unnecessary. The <CODE>-af filter1,filter2,...</CODE>
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
280 option is used to override the automatic activation of filters or to insert
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
281 filters that are not automatically inserted. The filters will be executed as
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
282 they appear in the comma separated list.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
283
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
284 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
285 &nbsp;&nbsp;<CODE>mplayer -af resample,pan movie.avi </CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
286
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
287 <P>would run the sound through the resampling filter followed by the pan filter.
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
288 Observe that the list must not contain any spaces, else it will fail.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
289
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
290 <P>The filters often have options that change their behavior. These options
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
291 are explained in detail in the sections below. A filter will execute using
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
292 default settings if its options are omitted. Here is an example of how to use
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
293 filters in combination with filter specific options:</P>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
294
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
295 <P>&nbsp;&nbsp;<CODE>mplayer -af resample=11025,pan=1:0.5:0.5 -channels 1
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
296 -srate 11025 media.avi</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
297
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
298 <P>would set the output frequency of the resample filter to 11025Hz and downmix
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
299 the audio to 1 channel using the pan filter.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
300
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
301 <P>The overall execution of the filter layer is controlled using the
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
302 <CODE>-af-adv</CODE> option. This option has two suboptions:</P>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
303
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
304 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
305 <DT><CODE>force</CODE><DT>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
306 <DD>is a Bit field that controls how the filters are inserted and what
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
307 speed/accuracy optimizations they use:
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
308 <DL>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
309 <DT><CODE>0</CODE></DT>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
310 <DD>Use automatic insertion of filters and optimize according to CPU
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
311 speed.</DD>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
312 <DT><CODE>1</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
313 <DD>Use automatic insertion of filters and optimize for the highest
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
314 speed.<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
315 <EM>Warning:</EM> Some features in the audio filters may silently fail,
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
316 and the sound quality may drop.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
317 <DT><CODE>2</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
318 <DD>Use automatic insertion of filters and optimize for quality.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
319 <DT><CODE>3</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
320 <DD>Use no automatic insertion of filters and no optimization.<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
321 <I>Warning:</I> It may be possible to crash MPlayer using this
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
322 setting.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
323 <DT><CODE>4</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
324 <DD>Use automatic insertion of filters according to 0 above, but use
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
325 floating point processing when possible.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
326 <DT><CODE>5</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
327 <DD>Use automatic insertion of filters according to 1 above, but use
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
328 floating point processing when possible.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
329 <DT><CODE>6</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
330 <DD>Use automatic insertion of filters according to 2 above, but use
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
331 floating point processing when possible.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
332 <DT><CODE>7</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
333 <DD>Use no automatic insertion of filters according to 3 above, and use
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
334 floating point processing when possible.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
335 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
336 </DD>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
337
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
338 <DT><CODE>list</CODE></DT>
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
339 <DD>is an alias for the -af option.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
340 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
341
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
342 <P>The filter layer is also affected by the following generic options:
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
343
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
344 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
345 <DT><CODE>-v</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
346 <DD>Increases the verbosity level and makes most filters print out extra
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
347 status messages.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
348 <DT><CODE>-channels</CODE></DT>
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
349 <DD>This option sets the number of output channels you would like your
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
350 sound card to use.
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
351 It also affects the number of channels that are being decoded from the
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
352 media. If the media contains less channels than requested the channels
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
353 filter (see below) will automatically be inserted. The routing will be the
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
354 default routing for the channels filter.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
355 <DT><CODE>-srate</CODE></DT>
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
356 <DD>This option selects the sample rate you would like your sound card to
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
357 use (of course the cards have limits on this). If the sample
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
358 frequency of your sound card is different from that of the current media,
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
359 the resample filter (see below) will be inserted into the audio filter layer
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
360 to compensate for the difference.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
361 <DT><CODE>-format</CODE><DT>
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
362 <DD>This option sets the sample format between the audio filter layer and the sound
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
363 card. If the requested sample format of your sound card is different from
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
364 that of the current media, a format filter (see below) will be inserted to
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
365 rectify the difference.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
366 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
367
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
368
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
369 <H4><A NAME="af_resample">2.3.2.3.1 Up/Down-sampling</A></H4>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
370
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
371 <P>MPlayer fully supports sound up/down-sampling through the
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
372 <CODE>resample</CODE> filter. It can be used if you
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
373 have a fixed frequency sound card or if you are stuck with an old sound card
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
374 that is only capable of max 44.1kHz. This filter is automatically enabled if
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
375 it is necessary, but it can also be explicitly enabled on the command line. It
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
376 has three options:</P>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
377
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
378 <DL>
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
379 <DT><CODE>srate &lt;8000-192000&gt;</CODE></DT>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
380 <DD>is an integer used for setting the output sample
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
381 frequency in Hz. The valid range for this parameter is 8kHz to 192kHz. If
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
382 the input and output sample frequency are the same or if this parameter is
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
383 omitted the filter is automatically unloaded. A high sample frequency
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
384 normally improves the audio quality, especially when used in combination
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
385 with other filters.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
386
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
387 <DT><CODE>sloppy</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
388 <DD>is an optional binary parameter that allows the output frequency to differ
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
389 slightly from the frequency given by <CODE>srate</CODE>. This option can be
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
390 used if the startup of the playback is extremely slow. It is enabled by
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
391 default.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
392
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
393 <DT><CODE>type &lt;0-2&gt;</CODE><DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
394 <DD>is an optional integer between <CODE>0</CODE> and <CODE>2</CODE> that
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
395 selects which resampling method to use. Here <CODE>0</CODE> represents
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
396 linear interpolation as resampling method, <CODE>1</CODE> represents
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
397 resampling using a poly-phase filter-bank and integer processing and
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
398 <CODE>2</CODE> represents resampling using a poly-phase filter-bank and
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
399 floating point processing. Linear interpolation is extremely fast, but
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
400 suffers from poor sound quality especially when used for up-sampling. The
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
401 best quality is given by <CODE>2</CODE> but this method also suffers from
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
402 the highest CPU load.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
403 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
404
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
405 <P>Example:<BR>
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
406 &nbsp;&nbsp;<CODE>mplayer -af resample=44100:0:0</CODE></P>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
407
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
408 <P>would set the output frequency of the resample filter to 44100Hz using exact
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
409 output frequency scaling and linear interpolation.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
410
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
411
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
412 <H4><A NAME="af_channels">2.3.2.3.2 Changing the number of channels</A></H4>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
413
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
414 <P>The <CODE>channels</CODE> filter can be used for adding and removing
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
415 channels, it can also be used for routing or copying channels. It is
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
416 automatically enabled when the output from the audio filter layer differs from
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
417 the input layer or when it is requested by another filter. This filter unloads
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
418 itself if not needed. The number of options is dynamic:</P>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
419
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
420 <DL>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
421 <DT><CODE>nch &lt;1-6&gt;</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
422 <DD>is an integer between <CODE>1</CODE> and <CODE>6</CODE> that is used for
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
423 setting the number of output channels. This option is required, leaving it
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
424 empty results in a runtime error.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
425
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
426 <DT><CODE>nr &lt;1-6&gt;</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
427 <DD>is an integer between <CODE>1</CODE> and <CODE>6</CODE> that is used for
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
428 specifying the number of routes. This parameter is optional. If it is
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
429 omitted the default routing is used.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
430
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
431 <DT><CODE>from1:to1:from2:to2:from3:to3...</CODE></DT>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
432 <DD>are pairs of numbers between <CODE>0</CODE> and <CODE>5</CODE> that define
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
433 where each channel should be routed.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
434 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
435
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
436 <P>If only <CODE>nch</CODE> is given the default routing is used, it works as
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
437 follows: If the number of output channels is bigger than the number of input
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
438 channels empty channels are inserted (except mixing from mono to stereo, then
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
439 the mono channel is repeated in both of the output channels). If the number of
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
440 output channels is smaller than the number of input channels the exceeding
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
441 channels are truncated.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
442
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
443 <P>Example 1:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
444 &nbsp;&nbsp;<CODE>mplayer -af channels=4:4:0:1:1:0:2:2:3:3 media.avi </CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
445
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
446 <P>would change the number of channels to 4 and set up 4 routes that swap
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
447 channel 0 and channel 1 and leave channel 2 and 3 intact. Observe that if
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
448 media containing two channels was played back, channels 2 and 3 would contain
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
449 silence but 0 and 1 would still be swapped.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
450
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
451 <P>Example 2:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
452 &nbsp;&nbsp;<CODE>mplayer -af channels=6:4:0:0:0:1:0:2:0:3 media.avi </CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
453
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
454 <P>would change the number of channels to 6 and set up 4 routes that copy
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
455 channel 0 to channels 0 to 3. Channel 4 and 5 will contain silence.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
456
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
457
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
458 <H4><A NAME="af_format">2.3.2.3.3 Sample format converter</A></H4>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
459
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
460 <P>The <CODE>format</CODE> filter converts between different sample formats. It
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
461 is automatically enabled when needed by the sound card or another filter.</P>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
462
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
463 <DL>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
464 <DT><CODE>bps &lt;number&gt;</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
465 <DD>can be <CODE>1</CODE>, <CODE>2</CODE> or <CODE>4</CODE> and denotes the
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
466 number of bytes per sample. This option is required, leaving it empty
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
467 results in a runtime error.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
468
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
469 <DT><CODE>f &lt;format&gt;</CODE></DT>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
470 <DD>is a text string describing the sample format. The string is a
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
471 concatenated mix of: <CODE>alaw</CODE>, <CODE>mulaw</CODE> or
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
472 <CODE>imaadpcm</CODE>, <CODE>float</CODE> or <CODE>int</CODE>,
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
473 <CODE>unsigned</CODE> or <CODE>signed</CODE>, <CODE>le</CODE> or
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
474 <CODE>be</CODE> (little or big endian). This option is required, leaving it
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
475 empty results in a runtime error.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
476 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
477
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
478 <P>Example:<BR>
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
479 &nbsp;&nbsp;<CODE>mplayer -af format=4:float media.avi</CODE></P>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
480
8772
605f2c290b20 small fix
nicolas
parents: 8757
diff changeset
481 <P>would set the output format to 4 bytes per sample floating point
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
482 data.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
483
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
484
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
485 <H4><A NAME="af_delay">2.3.2.3.4 Delay</A></H4>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
486
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
487 <P>The <CODE>delay</CODE> filter delays the sound to the loudspeakers such that
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
488 the sound from the different channels arrives at the listening position
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
489 simultaneously.
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
490 It is only useful if you have more than 2 loudspeakers. This filter has a
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
491 variable number of parameters:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
492
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
493 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
494 <DT><CODE>d1:d2:d3...</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
495 <DD>are floating point numbers representing the delays in ms that should be
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
496 imposed on the different channels. The minimum delay is 0ms and the maximum
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
497 is 1000ms.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
498 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
499
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
500 <P>To calculate the required delay for the different channels do as follows:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
501
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
502 <OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
503 <LI>Measure the distance to the loudspeakers in meters in relation to your
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
504 listening position, giving you the distances s1 to s5 (for a 5.1 system).
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
505 There is no point in compensating for the sub-woofer (you will not hear the
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
506 difference anyway).</LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
507 <LI>Subtract the distances s1 to s5 from the maximum distance i.e.<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
508 s[i] = max(s) - s[i]; i = 1...5</LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
509 <LI>Calculated the required delays in ms as<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
510 d[i] = 1000*s[i]/342; i = 1...5 </LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
511 </OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
512
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
513 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
514 &nbsp;&nbsp;<CODE>mplayer -af delay=10.5:10.5:0:0:7:0 media.avi</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
515
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
516 <P>would delay front left and right by 10.5ms, the two rear channels and the sub
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
517 by 0ms and the center channel by 7ms.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
518
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
519
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
520 <H4><A NAME="af_volume">2.3.2.3.5 Software volume control</A></H4>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
521
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
522 <P>Software volume control is implemented by the <CODE>volume</CODE> audio
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
523 filter. Use this filter with caution since
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
524 it can reduce the signal to noise ratio of the sound. In most cases it is best
9173
eeca9a1043cd fixing af_volume vs PCM vs MASTER issue
gabucino
parents: 9166
diff changeset
525 to set the level for the PCM sound to max, leave this filter out and control
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
526 the output level to your speakers with the master volume control of the mixer.
9206
diego
parents: 9173
diff changeset
527 In case your sound card has a digital PCM mixer instead of an analog one, and
diego
parents: 9173
diff changeset
528 you hear distortion, use the MASTER mixer instead.
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
529 If there is an external amplifier connected to the computer (this is almost
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
530 always the case), the noise level can be minimized by adjusting the master
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
531 level and the volume knob on the amplifier until the hissing noise in the
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
532 background is gone. This filter has two options:</P>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
533
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
534 <DL>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
535 <DT><CODE>v &lt;-200 - +60&gt;</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
536 <DD>is a floating point number between <CODE>-200</CODE> and <CODE>+60</CODE>
9043
1d75a7ecf3b8 Changing initial volume level to 0dB after loud intensive complaints
anders
parents: 9005
diff changeset
537 which represents the volume level in dB. The default level is 0dB.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
538
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
539 <DT><CODE>c</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
540 <DD>is a binary control that turns soft clipping on and off. Soft-clipping can
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
541 make the sound more smooth if very high volume levels are used. Enable this
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
542 option if the dynamic range of the loudspeakers is very low. Be aware that
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
543 this feature creates distortion and should be considered a last resort.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
544 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
545
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
546 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
547 &nbsp;&nbsp;<CODE>mplayer -af volume=10.1:0 media.avi</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
548
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
549 <P>would amplify the sound by 10.1dB and hard-clip if the sound level is too
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
550 high.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
551
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
552 <P>This filter has a second feature: It measures the overall maximum sound level
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
553 and prints out that level when MPlayer exits. This volume estimate can be used
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
554 for setting the sound level in MEncoder such that the maximum dynamic range is
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
555 utilized.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
556
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
557
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
558 <H4><A NAME="af_equalizer">2.3.2.3.6 Equalizer</A></H4>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
559
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
560 <P>The <CODE>equalizer</CODE> filter represents a 10 octave band graphic
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
561 equalizer, implemented using 10 IIR
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
562 band pass filters. This means that it works regardless of what type of audio
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
563 is being played back. The center frequencies for the 10 bands are:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
564
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
565 <TABLE BORDER="0" WIDTH="100%">
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
566 <TR><TD>Band No.</TD><TD>Center frequency</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
567 <TR><TD>0</TD><TD>31.25 Hz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
568 <TR><TD>1</TD><TD>62.50 Hz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
569 <TR><TD>2</TD><TD>125.0 Hz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
570 <TR><TD>3</TD><TD>250.0 Hz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
571 <TR><TD>4</TD><TD>500.0 Hz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
572 <TR><TD>5</TD><TD>1.000 kHz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
573 <TR><TD>6</TD><TD>2.000 kHz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
574 <TR><TD>7</TD><TD>4.000 kHz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
575 <TR><TD>8</TD><TD>8.000 kHz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
576 <TR><TD>9</TD><TD>16.00 kHz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
577 </TABLE>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
578
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
579 <P>If the sample rate of the sound being played back is lower than the center
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
580 frequency for a frequency band, then that band will be disabled. A known bug
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
581 with this filter is that the characteristics for the uppermost band are not
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
582 completely symmetric if the sample rate is close to the center frequency of
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
583 that band. This problem can be worked around by up-sampling the sound using
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
584 the resample filter before it reaches this filter. </P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
585
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
586 <P>This filter has 10 parameters:</P>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
587
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
588 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
589 <DT><CODE>g1:g2:g3...g10</CODE></DT>
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
590 <DD>are floating point numbers between <CODE>-12</CODE> and <CODE>+12</CODE>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
591 representing the gain in dB for each frequency band.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
592 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
593
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
594 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
595 &nbsp;&nbsp;<CODE>mplayer -af equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
596
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
597 <P>would amplify the sound in the upper and lower frequency region while
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
598 canceling it almost completely around 1kHz.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
599
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
600
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
601 <H4><A NAME="af_panning">2.3.2.3.7 Panning filter</A></H4>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
602
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
603 <P>Use the <CODE>pan</CODE> filter to mix channels arbitrarily. It is basically
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
604 a combination of the volume control and the channels filter. There are two
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
605 major uses for this filter:</P>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
606
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
607 <OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
608 <LI>Down-mixing many channels to only a few, stereo to mono for example.</LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
609 <LI>Varying the "width" of the center speaker in a surround sound system.</LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
610 </OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
611
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
612 <P>This filter is hard to use, and will require some tinkering before the
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
613 desired result is obtained. The number of options for this filter depends on
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
614 the number of output channels:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
615
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
616 <DL>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
617 <DT><CODE>nch &lt;1-6&gt;</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
618 <DD>is an integer between <CODE>1</CODE> and <CODE>6</CODE> and is used for
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
619 setting the number of output channels. This option is required, leaving it
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
620 empty results in a runtime error.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
621
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
622 <DT><CODE>l00:l01:l02:..l10:l11:l12:...ln0:ln1:ln2:...</CODE></DT>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
623 <DD>are floating point values between <CODE>0</CODE> and <CODE>1</CODE>.
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
624 <CODE>l[i][j]</CODE> determines how much of input channel j is mixed into
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
625 output channel i.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
626 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
627
8849
9476ccf6a41d another pan example by Anders
diego
parents: 8772
diff changeset
628 <P>Example 1:<BR>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
629 &nbsp;&nbsp;<CODE>mplayer -af pan=1:0.5:0.5 -channels 1 media.avi</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
630
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
631 <P>would down-mix from stereo to mono.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
632
8849
9476ccf6a41d another pan example by Anders
diego
parents: 8772
diff changeset
633 <P>Example 2:<BR>
9476ccf6a41d another pan example by Anders
diego
parents: 8772
diff changeset
634 &nbsp;&nbsp;<CODE>mplayer -af pan=3:1:0:1:0.5:0.5 -channels 3 media.avi</CODE></P>
9476ccf6a41d another pan example by Anders
diego
parents: 8772
diff changeset
635
9476ccf6a41d another pan example by Anders
diego
parents: 8772
diff changeset
636 <P>would give 3 channel output leaving channels 0 and 1 intact, and mix channels
9476ccf6a41d another pan example by Anders
diego
parents: 8772
diff changeset
637 0 and 1 into output channel 2 (which could be sent to a sub-woofer for
9476ccf6a41d another pan example by Anders
diego
parents: 8772
diff changeset
638 example).</P>
9476ccf6a41d another pan example by Anders
diego
parents: 8772
diff changeset
639
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
640
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
641 <H4><A NAME="af_sub">2.3.2.3.8 Sub-woofer</A></H4>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
642
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
643 <P>The <CODE>sub</CODE> filter adds a sub woofer channel to the audio stream.
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
644 The audio data
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
645 used for creating the sub-woofer channel is an average of the sound in channel
9005
gabucino
parents: 8950
diff changeset
646 0 and channel 1. The resulting sound is then low-pass filtered by a 4th
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
647 order Butterworth filter with a default cutoff frequency of 60Hz and added to
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
648 a separate channel in the audio stream. Warning: Disable this filter when you
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
649 are playing DVDs with Dolby Digital 5.1 sound, otherwise this filter will
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
650 disrupt the sound to the sub-woofer. This filter has two parameters:</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
651
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
652 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
653 <DT><CODE>fc &lt;20-300&gt;</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
654 <DD>is an optional floating point number used for setting the cutoff frequency
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
655 for the filter in Hz. The valid range is 20Hz to 300Hz. For the best result
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
656 try setting the cutoff frequency as low as possible. This will improve the
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
657 stereo or surround sound experience. The default cutoff frequency is
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
658 60Hz.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
659
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
660 <DT><CODE>ch &lt;0-5&gt;</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
661 <DD>is an optional integer between <CODE>0</CODE> and <CODE>5</CODE> which
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
662 determines the channel number in which to insert the sub-channel audio.
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
663 The default is channel number <CODE>5</CODE>. Observe that the number of
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
664 channels will automatically be increased to <CODE>ch</CODE> if
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
665 necessary.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
666 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
667
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
668 <P>Example:<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
669 &nbsp;&nbsp;<CODE>mplayer -af sub=100:4 -channels 5 media.avi</CODE></P>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
670
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
671 <P>would add a sub-woofer channel with a cutoff frequency of 100Hz to output
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
672 channel 4.</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
673
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
674 <H4><A NAME="af_surround">2.3.2.3.9 Surround-sound decoder</A></H4>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
675
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
676 <P>Matrix encoded surround sound can be decoded by the <CODE>surround</CODE>
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
677 filter. Dolby Surround is
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
678 an example of a matrix encoded format. Many files with 2 channel audio
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
679 actually contain matrixed surround sound. To use this feature you need a sound
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
680 card supporting at least 4 channels. This filter has one parameter:</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
681
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
682 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
683 <DT><CODE>d &lt;0-1000&gt;</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
684 <DD>is an optional floating point number between <CODE>0</CODE> and
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
685 <CODE>1000</CODE> used for setting the delay time in ms for the rear
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
686 speakers. This delay should be set as follows: if d1 is the distance from
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
687 the listening position to the front speakers and d2 is the distance from
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
688 the listening position to the rear speakers, then the delay <CODE>d</CODE>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
689 should be set to 15ms if d1 &lt;= d2 and to 15 + 5*(d1-d2) if d1 &gt; d2.
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
690 The default value for <CODE>d</CODE> is 20ms.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
691 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
692
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
693 <P>Example:<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
694 &nbsp;&nbsp;<CODE>mplayer -af surround=15 -channels 4 media.avi</CODE></P>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
695
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
696 <P>would add surround sound decoding with 15ms delay for the sound to the rear
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
697 speakers.</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
698
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
699
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
700 <H4><A NAME="plugins">2.3.2.4 Audio plugins (deprecated)</A></H4>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
701
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
702 <H2><STRONG>Note: Audio plugins have been deprecated by audio filters and will be
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
703 removed soon.</STRONG></H2>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
704
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
705 <P>MPlayer has support for audio plugins. Audio plugins can be used to
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
706 change the properties of the audio data before it reaches the sound
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
707 card. They are enabled using the <CODE>-aop</CODE> option which takes a
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
708 <CODE>list=plugin1,plugin2,...</CODE> argument. The <CODE>list</CODE> argument
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
709 is required and determines which plugins should be used and in which order they
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
710 should be executed. Example:</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
711
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
712 <P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample,format</CODE></P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
713
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
714 <P>would run the sound through the resampling plugin followed by the format
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
715 plugin.</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
716
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
717 <P>The plugins can also have options that change their behavior. These
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
718 options are explained in detail in the sections below. A plugin will execute
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
719 using default settings if its options are omitted. Here is an example of how
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
720 to use plugins in combination with plugin specific options:</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
721
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
722 <P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
723 list=resample,format:fout=44100:format=0x8</CODE></P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
724
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
725 <P>would set the output frequency of the resample plugin to 44100Hz and the
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
726 output format of the format plugin to AFMT_U8.</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
727
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
728 <P>Currently audio plugins cannot be used in MEncoder.</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
729
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
730
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
731 <H4><A NAME="resample">2.3.2.4.1 Up/Downsampling</A></H4>
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
732
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7453
diff changeset
733 <P>MPlayer fully supports up/downsampling of the sound. This plugin can
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
734 be used if you have a fixed frequency sound card or if you are
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
735 stuck with an old sound card that is only capable of max 44.1kHz.
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
736 MPlayer <EM>autodetects</EM> whether or not usage of this plugin is necessary.
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
737 This plugin has one option, <CODE>fout</CODE>, which is used for setting the
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
738 desired output sample frequency. The value is given in Hz, and defaults to
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
739 48kHz.</P>
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
740
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
741 <P>Usage:<BR>
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
742 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample:fout=&lt;required
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
743 frequency in Hz, like 44100&gt;</CODE></P>
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
744
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
745 <P>Note that the output frequency should not be scaled up from the default value.
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
746 Scaling up will cause the audio and video streams to be played in slow motion
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
747 and cause audio distortion.</P>
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
748
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
749
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
750 <H4><A NAME="surround_decoding">2.3.2.4.2 Surround Sound decoding</A></H4>
3931
ef59dc91aaaf applied Steve's patch
gabucino
parents: 3857
diff changeset
751
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7453
diff changeset
752 <P>MPlayer has an audio plugin that can decode matrix encoded
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
753 surround sound. Dolby Surround is an example of a matrix encoded format.
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
754 Many files with 2 channel audio actually contain matrixed surround sound.
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
755 To use this feature you need a sound card supporting at least 4 channels.</P>
3931
ef59dc91aaaf applied Steve's patch
gabucino
parents: 3857
diff changeset
756
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
757 <P>Usage:<BR>
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
758 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=surround</CODE></P>
3931
ef59dc91aaaf applied Steve's patch
gabucino
parents: 3857
diff changeset
759
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
760
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
761 <H4><A NAME="format">2.3.2.3.3 Sample format converter</A></H4>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
762
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
763 <P>If your sound card driver does not support signed 16bit <CODE>int</CODE> data type,
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
764 this plugin can
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
765 be used to change the format to one which your sound card can understand. It
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
766 has one option, <CODE>format</CODE>, which can be set to one of the numbers
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
767 found in <CODE>libao2/afmt.h</CODE>. This plugin is hardly ever needed and is
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
768 intended for advanced users. Keep in mind that this plugin only changes the
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
769 sample format and not the sample frequency or the number of channels.</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
770
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
771 <P>Usage:<BR>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
772 &nbsp;&nbsp;<CODE>mplayer media.avi -aop
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
773 list=format:format=&lt;required output format&gt;</CODE></P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
774
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
775
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
776 <H4><A NAME="delay">2.3.2.4.4 Delay</A></H4>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
777
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
778 <P>This plugin delays the sound and is intended as an example of how to develop
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
779 new plugins. It can not be used for anything useful from a users perspective
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
780 and is mentioned here for the sake of completeness only. Do not use this
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
781 plugin unless you are a developer.</P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
782
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
783 <P>If you have a file with a consistent A/V sync fault, use the <CODE>+/-</CODE>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
784 keys to adjust timings on-the-fly instead. Usage of the OSD is recommended
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
785 to make this easier.</P>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
786
7047
4f87cd0f642f Converted the docs to use proper headings tags.
diego
parents: 6998
diff changeset
787
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
788 <H4><A NAME="volume">2.3.2.4.5 Software volume control</A></H4>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
789
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
790 <P>This plugin is a software replacement for the volume control, and
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
791 can be used on machines with a broken mixer device. It can also be
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7453
diff changeset
792 used if one wants to change the output volume of MPlayer
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
793 without changing the PCM volume setting in the mixer. It has one
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
794 option <CODE>volume</CODE> that is used for setting the initial
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
795 sound level. The initial sound level can be set to values between 0
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
796 and 255 and defaults to 101 which equals 0dB amplification. Use this
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
797 plugin with caution since it can reduce the signal to noise ratio of
9173
eeca9a1043cd fixing af_volume vs PCM vs MASTER issue
gabucino
parents: 9166
diff changeset
798 the sound. In most cases it is best to set the level for the PCM
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
799 sound to max, leave this plugin out and control the output level to
9173
eeca9a1043cd fixing af_volume vs PCM vs MASTER issue
gabucino
parents: 9166
diff changeset
800 your speakers with the MASTER volume control of the mixer.
9206
diego
parents: 9173
diff changeset
801 In case your sound card has a digital PCM mixer instead of an analog one, and
diego
parents: 9173
diff changeset
802 you hear distortion, use the MASTER mixer instead.
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
803 external amplifier connected to the computer (this is almost always
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
804 the case), the noise level can be minimized by adjusting the master
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
805 level and the volume knob on the amplifier until the hissing noise
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
806 in the background is gone.</P>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
807
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
808 <P>Usage:<BR>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
809 &nbsp;&nbsp;<CODE>mplayer media.avi -aop
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
810 list=volume:volume=&lt;0-255&gt;</CODE></P>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
811
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
812 <P>This plugin also has compressor or "soft-clipping" capabilities.
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
813 Compression can be used if the dynamic range of the sound is very
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
814 high or if the dynamic range of the loudspeakers is very
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
815 low. Be aware that this feature creates distortion and should be
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
816 considered a last resort.</P>
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
817
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
818 <P>Usage:<BR>
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
819 &nbsp;&nbsp;<CODE>mplayer media.avi -aop
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
820 list=volume:softclip</CODE></P>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
821
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
822
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
823 <H4><A NAME="extrastereo">2.3.2.4.6 Extrastereo</A></H4>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
824
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
825 <P>This plugin (linearly) increases the difference between left and right
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
826 channels (like the XMMS extrastereo plugin) which gives some sort of "live"
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
827 effect to playback.</P>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
828
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
829 <P>Usage:<BR>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
830 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=extrastereo</CODE><BR>
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
831 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=extrastereo:mul=3.45</CODE></P>
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
832
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
833 <P>The default coefficient (<CODE>mul</CODE>) is a float number that defaults
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
834 to 2.5. If you set it to 0.0, you will have mono sound (average of both
6272
360c3b1dd1d7 -1.0 swaps channels with the extrastereo plugin.
diego
parents: 5765
diff changeset
835 channels). If you set it to 1.0, sound will be unchanged, if you set it to
360c3b1dd1d7 -1.0 swaps channels with the extrastereo plugin.
diego
parents: 5765
diff changeset
836 -1.0, left and right channels will be swapped.</P>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
837
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
838
9288
69872fa8b0e3 fixing al3x's 10l's
gabucino
parents: 9282
diff changeset
839 <H4><A NAME="normalizer">2.3.2.4.7 Volume normalizer</A></H4>
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
840
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
841 <P>This plugin maximizes the volume without distorting the sound.</P>
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
842
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
843 <P>Usage:<BR>
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
844 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=volnorm</CODE><BR>
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
845
5721
b53597b930b1 more deciliters
gabucino
parents: 5123
diff changeset
846
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
847 </BODY>
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
848 </HTML>