annotate DOCS/sound.html @ 9264:2c37b2fe05ee

typos
author diego
date Mon, 03 Feb 2003 22:39:01 +0000
parents 334a2d73e612
children 513e02e2e553
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>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent
arpi
parents: 9206
diff changeset
108 <TH ROWSPAN="2"><B>Max Opens</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>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
221 <TD>OK (?)</TD>
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>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
254 <TD>OK (Use the SDL driver: <CODE>-ao sdl</CODE>)</TD>
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
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7453
diff changeset
265 <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
266 and your sound card(s) worked together.</P>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
267
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
268
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
269 <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
270
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
271 <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
272 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
273 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
274 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
275 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
276 and deactivated if unnecessary. The <CODE>-af filter1,filter2,...</CODE>
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
277 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
278 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
279 they appear in the comma separated list.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
280
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
281 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
282 &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
283
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
284 <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
285 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
286
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
287 <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
288 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
289 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
290 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
291
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
292 <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
293 -srate 11025 media.avi</CODE></P>
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>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
296 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
297
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
298 <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
299 <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
300
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
301 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
302 <DT><CODE>force</CODE><DT>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
303 <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
304 speed/accuracy optimizations they use:
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
305 <DL>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
306 <DT><CODE>0</CODE></DT>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
307 <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
308 speed.</DD>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
309 <DT><CODE>1</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
310 <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
311 speed.<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
312 <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
313 and the sound quality may drop.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
314 <DT><CODE>2</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
315 <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
316 <DT><CODE>3</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
317 <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
318 <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
319 setting.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
320 <DT><CODE>4</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
321 <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
322 floating point processing when possible.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
323 <DT><CODE>5</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 1 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>6</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 2 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>7</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
330 <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
331 floating point processing when possible.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
332 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
333 </DD>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
334
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
335 <DT><CODE>list</CODE></DT>
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
336 <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
337 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
338
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
339 <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
340
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
341 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
342 <DT><CODE>-v</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
343 <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
344 status messages.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
345 <DT><CODE>-channels</CODE></DT>
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
346 <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
347 sound card to use.
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
348 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
349 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
350 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
351 default routing for the channels filter.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
352 <DT><CODE>-srate</CODE></DT>
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
353 <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
354 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
355 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
356 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
357 to compensate for the difference.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
358 <DT><CODE>-format</CODE><DT>
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
359 <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
360 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
361 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
362 rectify the difference.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
363 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
364
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
365
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
366 <H5><A NAME="af_resample">2.3.2.3.1 Up/Down-sampling</A></H5>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
367
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
368 <P>MPlayer fully supports sound up/down-sampling through the
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
369 <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
370 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
371 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
372 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
373 has three options:</P>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
374
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
375 <DL>
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
376 <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
377 <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
378 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
379 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
380 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
381 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
382 with other filters.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
383
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
384 <DT><CODE>sloppy</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
385 <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
386 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
387 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
388 default.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
389
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
390 <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
391 <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
392 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
393 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
394 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
395 <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
396 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
397 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
398 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
399 the highest CPU load.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
400 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
401
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
402 <P>Example:<BR>
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
403 &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
404
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
405 <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
406 output frequency scaling and linear interpolation.</P>
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
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
409 <H5><A NAME="af_channels">2.3.2.3.2 Changing the number of channels</A></H5>
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 <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
412 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
413 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
414 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
415 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
416
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
417 <DL>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
418 <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
419 <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
420 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
421 empty results in a runtime error.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
422
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
423 <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
424 <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
425 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
426 omitted the default routing is used.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
427
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
428 <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
429 <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
430 where each channel should be routed.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
431 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
432
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
433 <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
434 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
435 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
436 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
437 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
438 channels are truncated.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
439
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
440 <P>Example 1:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
441 &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
442
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
443 <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
444 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
445 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
446 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
447
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
448 <P>Example 2:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
449 &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
450
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
451 <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
452 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
453
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
454
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
455 <H5><A NAME="af_format">2.3.2.3.3 Sample format converter</A></H5>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
456
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
457 <P>The <CODE>format</CODE> filter converts between different sample formats. It
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
458 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
459
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
460 <DL>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
461 <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
462 <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
463 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
464 results in a runtime error.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
465
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
466 <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
467 <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
468 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
469 <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
470 <CODE>unsigned</CODE> or <CODE>signed</CODE>, <CODE>le</CODE> or
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
471 <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
472 empty results in a runtime error.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
473 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
474
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
475 <P>Example:<BR>
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
476 &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
477
8772
605f2c290b20 small fix
nicolas
parents: 8757
diff changeset
478 <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
479 data.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
480
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
481
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
482 <H5><A NAME="af_delay">2.3.2.3.4 Delay</A></H5>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
483
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
484 <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
485 the sound from the different channels arrives at the listening position
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
486 simultaneously.
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
487 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
488 variable number of parameters:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
489
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
490 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
491 <DT><CODE>d1:d2:d3...</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
492 <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
493 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
494 is 1000ms.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
495 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
496
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
497 <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
498
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
499 <OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
500 <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
501 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
502 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
503 difference anyway).</LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
504 <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
505 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
506 <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
507 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
508 </OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
509
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
510 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
511 &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
512
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
513 <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
514 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
515
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
516
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
517 <H5><A NAME="af_volume">2.3.2.3.5 Software volume control</A></H5>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
518
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
519 <P>Software volume control is implemented by the <CODE>volume</CODE> audio
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
520 filter. Use this filter with caution since
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
521 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
522 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
523 the output level to your speakers with the master volume control of the mixer.
9206
diego
parents: 9173
diff changeset
524 In case your sound card has a digital PCM mixer instead of an analog one, and
diego
parents: 9173
diff changeset
525 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
526 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
527 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
528 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
529 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
530
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
531 <DL>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
532 <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
533 <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
534 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
535
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
536 <DT><CODE>c</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
537 <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
538 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
539 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
540 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
541 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
542
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
543 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
544 &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
545
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
546 <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
547 high.</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>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
550 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
551 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
552 utilized.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
553
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
554
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
555 <H5><A NAME="af_equalizer">2.3.2.3.6 Equalizer</A></H5>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
556
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
557 <P>The <CODE>equalizer</CODE> filter represents a 10 octave band graphic
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
558 equalizer, implemented using 10 IIR
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
559 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
560 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
561
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
562 <TABLE BORDER="0" WIDTH="100%">
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
563 <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
564 <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
565 <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
566 <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
567 <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
568 <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
569 <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
570 <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
571 <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
572 <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
573 <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
574 </TABLE>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
575
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
576 <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
577 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
578 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
579 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
580 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
581 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
582
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
583 <P>This filter has 10 parameters:</P>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
584
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
585 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
586 <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
587 <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
588 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
589 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
590
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
591 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
592 &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
593
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
594 <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
595 canceling it almost completely around 1kHz.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
596
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
597
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
598 <H5><A NAME="af_panning">2.3.2.3.7 Panning filter</A></H5>
8750
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 <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
601 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
602 major uses for this filter:</P>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
603
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
604 <OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
605 <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
606 <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
607 </OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
608
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
609 <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
610 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
611 the number of output channels:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
612
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
613 <DL>
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
614 <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
615 <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
616 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
617 empty results in a runtime error.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
618
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
619 <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
620 <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
621 <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
622 output channel i.</DD>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
623 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
624
8849
9476ccf6a41d another pan example by Anders
diego
parents: 8772
diff changeset
625 <P>Example 1:<BR>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
626 &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
627
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
628 <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
629
8849
9476ccf6a41d another pan example by Anders
diego
parents: 8772
diff changeset
630 <P>Example 2:<BR>
9476ccf6a41d another pan example by Anders
diego
parents: 8772
diff changeset
631 &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
632
9476ccf6a41d another pan example by Anders
diego
parents: 8772
diff changeset
633 <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
634 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
635 example).</P>
9476ccf6a41d another pan example by Anders
diego
parents: 8772
diff changeset
636
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
637
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
638 <H5><A NAME="af_sub">2.3.2.3.8 Sub-woofer</A></H5>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
639
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
640 <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
641 The audio data
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
642 used for creating the sub-woofer channel is an average of the sound in channel
9005
gabucino
parents: 8950
diff changeset
643 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
644 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
645 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
646 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
647 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
648
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
649 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
650 <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
651 <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
652 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
653 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
654 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
655 60Hz.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
656
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
657 <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
658 <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
659 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
660 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
661 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
662 necessary.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
663 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
664
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
665 <P>Example:<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
666 &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
667
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
668 <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
669 channel 4.</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 <H5><A NAME="af_surround">2.3.2.3.9 Surround-sound decoder</A></H5>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
672
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
673 <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
674 filter. Dolby Surround is
8891
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
675 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
676 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
677 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
678
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
679 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
680 <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
681 <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
682 <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
683 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
684 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
685 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
686 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
687 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
688 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
689
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
690 <P>Example:<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
691 &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
692
8950
8fd72eae8886 Small updates for correctness and consistency.
diego
parents: 8891
diff changeset
693 <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
694 speakers.</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
695
5b73c925436e Further libaf documentation by Anders with some more updates by me.
diego
parents: 8849
diff changeset
696
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
697 <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
698
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
699 <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
700 removed soon.</STRONG></H2>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
701
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
702 <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
703 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
704 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
705 <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
706 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
707 should be executed. Example:</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
708
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
709 <P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample,format</CODE></P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
710
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
711 <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
712 plugin.</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
713
9138
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
714 <P>The plugins can also have options that change their behavior. These
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9082
diff changeset
715 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
716 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
717 to use plugins in combination with plugin specific options:</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
718
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
719 <P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
720 list=resample,format:fout=44100:format=0x8</CODE></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>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
723 output format of the format plugin to AFMT_U8.</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
724
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
725 <P>Currently audio plugins cannot be used in MEncoder.</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
726
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
727
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
728 <H5><A NAME="resample">2.3.2.4.1 Up/Downsampling</A></H5>
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
729
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7453
diff changeset
730 <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
731 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
732 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
733 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
734 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
735 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
736 48kHz.</P>
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
737
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
738 <P>Usage:<BR>
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
739 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample:fout=&lt;required
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
740 frequency in Hz, like 44100&gt;</CODE></P>
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
741
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
742 <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
743 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
744 and cause audio distortion.</P>
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
745
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
746
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
747 <H5><A NAME="surround_decoding">2.3.2.4.2 Surround Sound decoding</A></H5>
3931
ef59dc91aaaf applied Steve's patch
gabucino
parents: 3857
diff changeset
748
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7453
diff changeset
749 <P>MPlayer has an audio plugin that can decode matrix encoded
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
750 surround sound. Dolby Surround is an example of a matrix encoded format.
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
751 Many files with 2 channel audio actually contain matrixed surround sound.
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
752 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
753
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
754 <P>Usage:<BR>
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
755 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=surround</CODE></P>
3931
ef59dc91aaaf applied Steve's patch
gabucino
parents: 3857
diff changeset
756
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
757
8177
1f00a3d29b20 some TOC reorder
gabucino
parents: 7814
diff changeset
758 <H5><A NAME="format">2.3.2.3.3 Sample format converter</A></H5>
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
759
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
760 <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
761 this plugin can
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
762 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
763 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
764 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
765 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
766 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
767
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
768 <P>Usage:<BR>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
769 &nbsp;&nbsp;<CODE>mplayer media.avi -aop
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
770 list=format:format=&lt;required output format&gt;</CODE></P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
771
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
772
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
773 <H5><A NAME="delay">2.3.2.4.4 Delay</A></H5>
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 <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
776 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
777 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
778 plugin unless you are a developer.</P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
779
9082
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
780 <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
781 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
782 to make this easier.</P>
792417cde97a Some updates and rewordings as well as a much better table design by
diego
parents: 9043
diff changeset
783
7047
4f87cd0f642f Converted the docs to use proper headings tags.
diego
parents: 6998
diff changeset
784
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
785 <H5><A NAME="volume">2.3.2.4.5 Software volume control</A></H5>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
786
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
787 <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
788 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
789 used if one wants to change the output volume of MPlayer
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
790 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
791 option <CODE>volume</CODE> that is used for setting the initial
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
792 sound level. The initial sound level can be set to values between 0
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
793 and 255 and defaults to 101 which equals 0dB amplification. Use this
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
794 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
795 the sound. In most cases it is best to set the level for the PCM
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
796 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
797 your speakers with the MASTER volume control of the mixer.
9206
diego
parents: 9173
diff changeset
798 In case your sound card has a digital PCM mixer instead of an analog one, and
diego
parents: 9173
diff changeset
799 you hear distortion, use the MASTER mixer instead.
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
800 external amplifier connected to the computer (this is almost always
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
801 the case), the noise level can be minimized by adjusting the master
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
802 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
803 in the background is gone.</P>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
804
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
805 <P>Usage:<BR>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
806 &nbsp;&nbsp;<CODE>mplayer media.avi -aop
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
807 list=volume:volume=&lt;0-255&gt;</CODE></P>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
808
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
809 <P>This plugin also has compressor or "soft-clipping" capabilities.
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
810 Compression can be used if the dynamic range of the sound is very
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
811 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
812 low. Be aware that this feature creates distortion and should be
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
813 considered a last resort.</P>
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
814
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
815 <P>Usage:<BR>
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
816 &nbsp;&nbsp;<CODE>mplayer media.avi -aop
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
817 list=volume:softclip</CODE></P>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
818
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
819
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
820 <H5><A NAME="extrastereo">2.3.2.4.6 Extrastereo</A></H5>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
821
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
822 <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
823 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
824 effect to playback.</P>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
825
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
826 <P>Usage:<BR>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
827 &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
828 &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
829
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
830 <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
831 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
832 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
833 -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
834
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
835
8750
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural
diego
parents: 8260
diff changeset
836 <H5><A NAME="normalizer">2.3.2.4.7 Volume normalizer</A></H5>
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
837
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
838 <P>This plugin maximizes the volume without distorting the sound.</P>
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
839
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
840 <P>Usage:<BR>
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
841 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=volnorm</CODE><BR>
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
842
5721
b53597b930b1 more deciliters
gabucino
parents: 5123
diff changeset
843
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
844 </BODY>
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
845 </HTML>