annotate DOCS/sound.html @ 6906:3274d0725fde

Changed all link names from the section number to a sensible label. Section numbers were 2.3.2.1. in the section names and 2.3.2.1 in the TOC. I settled for the former everywhere. "Misc OS" is now called "Ports". Checked all internal links, some of them were falsely pointing to renumbered sections. This should no longer happen. And in case some of you think "This must have been a lot of work!", that does not even begin to describe it...
author diego
date Sun, 04 Aug 2002 22:13:09 +0000
parents f3f87f6bf5cf
children 027d2140942b
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
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
13 <P><B><A NAME="audio">2.3.2 Audio output devices</A></B></P>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
14
1892
70dbd25c128c jo sok ilyen ize.
gabucino
parents: 1704
diff changeset
15 <P><B>MPlayer</B>'s audio interface is called <I>libao2</I>. It currently
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
16 contains these drivers:</P>
1892
70dbd25c128c jo sok ilyen ize.
gabucino
parents: 1704
diff changeset
17
1905
8d773b35751e *** empty log message ***
gabucino
parents: 1892
diff changeset
18 <TABLE BORDER=0>
8d773b35751e *** empty log message ***
gabucino
parents: 1892
diff changeset
19
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
20 <TR><TD COLSPAN=4><P><B>General:</B></P></TD></TR>
1905
8d773b35751e *** empty log message ***
gabucino
parents: 1892
diff changeset
21
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
22 <TR><TD>&nbsp;&nbsp;</TD><TD VALIGN=top>oss</TD><TD>&nbsp;&nbsp;</TD><TD>OSS (ioctl) driver (supports hardware AC3 passthrough)</TD></TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
23 <TR><TD></TD><TD VALIGN=top>sdl</TD><TD></TD><TD>SDL driver (supports up/downsampling, <B>ESD</B>, <B>ARTS</B> etc)</TD></TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
24 <TR><TD></TD><TD VALIGN=top>nas</TD><TD></TD><TD>NAS (Network Audio System) driver</TD></TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
25 <TR><TD></TD><TD VALIGN=top>alsa5</TD><TD></TD><TD>native ALSA 0.5 driver</TD></TR>
6583
4b7d097a9c69 big update
gabucino
parents: 6403
diff changeset
26 <TR><TD></TD><TD VALIGN=top>alsa9</TD><TD></TD><TD>native ALSA 0.9 driver (supports hardware AC3 passthrough)</TD></TR>
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
27 <TR><TD></TD><TD VALIGN=top>sun</TD><TD></TD><TD>SUN audio driver (<CODE>/dev/audio</CODE>) for BSD and Solaris8 users</TD></TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
28 <TR><TD></TD><TD VALIGN=top>arts</TD><TD></TD><TD>native ARTS driver (mostly for KDE users)</TD></TR>
1905
8d773b35751e *** empty log message ***
gabucino
parents: 1892
diff changeset
29
8d773b35751e *** empty log message ***
gabucino
parents: 1892
diff changeset
30 </TABLE>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
31
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
32 <P>Fact is, Linux sound card drivers have compatibility problems.
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
33 It <B>may</B> take a while to find your optimal settings.</P>
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
34
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
35 <UL>
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
36 <LI>If you have an OSS driver, first try <CODE>-ao oss</CODE> (this is the default).
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
37 If you experience glitches, halts or anything out of the ordinary, try
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
38 <CODE>-ao sdl</CODE> (NOTE: you need to have SDL libraries and header files
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
39 installed). The SDL audio driver helps in a lot of cases and also supports ESD,
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
40 ARTS, and up/downsampling. (ESD is the sound daemon from GNOME, ARTS is from KDE.)</LI>
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
41 <LI>If you have ALSA version 0.5, then you almost always have to use <CODE>-ao alsa5</CODE> ,
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
42 since ALSA 0.5 has buggy OSS emulation code, and will <B>crash MPlayer</B> with
1892
70dbd25c128c jo sok ilyen ize.
gabucino
parents: 1704
diff changeset
43 a message like this:<BR>
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
44 <CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE></LI>
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
45 <LI>If you have ALSA version 0.9 you may choose between <CODE>-ao oss</CODE> and
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
46 <CODE>-ao sdl</CODE>. You can also use <CODE>-ao alsa9</CODE>. It works, but
6583
4b7d097a9c69 big update
gabucino
parents: 6403
diff changeset
47 there may be problems like lost sync and disappearing audio.</LI>
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
48 </UL>
1892
70dbd25c128c jo sok ilyen ize.
gabucino
parents: 1704
diff changeset
49
70dbd25c128c jo sok ilyen ize.
gabucino
parents: 1704
diff changeset
50 <P>On <B>Solaris/FreeBSD</B> systems, use the SUN audio driver with the
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
51 <CODE>-ao sun</CODE> option, otherwise neither video nor audio will work.</P>
1892
70dbd25c128c jo sok ilyen ize.
gabucino
parents: 1704
diff changeset
52
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
53 <P><B><A NAME="experiences">2.3.2.1 Sound Card experiences, recommendations</A></B></P>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
54
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
55 <TABLE BORDER=0 WIDTH="100%">
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
56 <TR><TD COLSPAN=3><B>VIA onboard chipset (via82cxxx) 48kHz only</B></TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
57 <TD></TD><TD>Driver:</TD><TD> from <A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&amp;release_id=59602">here</A></TD><TR>
3190
9c9a9b5f0a9e VIA 8c2qwerqwer driver added
gabucino
parents: 2999
diff changeset
58
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
59 <TD COLSPAN=3><B>Aureal Vortex 2</B></TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
60 <TD>&nbsp;&nbsp;&nbsp;&nbsp;</TD><TD>OSS:</TD><TD>no driver</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
61 <TD></TD><TD>OSS/Pro:</TD><TD>OK</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
62 <TD></TD><TD>ALSA:</TD><TD>no driver</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
63 <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
64 <TD></TD><TD>Driver:</TD><TD><A HREF="http://aureal.sourceforge.net">aureal.sourceforge.net</A></TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
65 <TD></TD><TD>Driver2:</TD><TD> from <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">here</A><BR>
2999
7a4eb5a45288 only 32k.
pontscho
parents: 2745
diff changeset
66 (<I>buffer size increased to 32k</I>)</TD><TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
67
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
68 <TD COLSPAN=3><B>GUS PnP</B></TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
69 <TD></TD><TD>OSS:</TD><TD>no driver</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
70 <TD></TD><TD>OSS/Pro:</TD><TD>OK</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
71 <TD></TD><TD>ALSA:</TD><TD>OK</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
72 <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
73
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
74 <TD COLSPAN=3><B>SB Live!</B></TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
75 <TD></TD><TD>OSS:</TD><TD>Analog OK, SP/DIF not working</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
76 <TD></TD><TD>ALSA:</TD><TD>Both OK</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
77 <TD></TD><TD>Max kHz:</TD><TD>192</TD><TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
78
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
79 <TD COLSPAN=3><B>SB AWE 64</B></TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
80 <TD></TD><TD>OSS:</TD><TD>max 44kHz</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
81 <TD></TD><TD>ALSA:</TD><TD>48kHz sounds bad</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
82 <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
1892
70dbd25c128c jo sok ilyen ize.
gabucino
parents: 1704
diff changeset
83
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
84 <TD COLSPAN=3><B>Gravis UltraSound ACE</B></TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
85 <TD></TD><TD>OSS:</TD><TD>not OK</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
86 <TD></TD><TD>ALSA:</TD><TD>OK</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
87 <TD></TD><TD>Max kHz:</TD><TD>44</TD><TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
88
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
89 <TD COLSPAN=3><B>Gravis UltraSound MAX</B></TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
90 <TD></TD><TD>OSS:</TD><TD>OK</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
91 <TD></TD><TD>ALSA:</TD><TD>OK (?)</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
92 <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
93
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
94 <TD COLSPAN=3><B>ESS 688</B></TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
95 <TD></TD><TD>OSS:</TD><TD>OK</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
96 <TD></TD><TD>ALSA:</TD><TD>OK (?)</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
97 <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
98
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
99 <TD COLSPAN=3><B>C-Media cards (which ones?)</B></TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
100 <TD></TD><TD>OSS:</TD><TD>not OK (hissing) (?)</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
101 <TD></TD><TD>ALSA:</TD><TD>OK (?)</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
102 <TD></TD><TD>Max kHz:</TD><TD>?</TD><TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
103
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
104 <TD COLSPAN=3><B>Yamaha cards (*ymf*)</B></TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
105 <TD></TD><TD>OSS:</TD><TD>not OK (?) (maybe <CODE>-ao sdl</CODE>)</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
106 <TD></TD><TD>ALSA:</TD><TD>OK only with ALSA 0.5 with OSS emulation <B>AND</B> <CODE>-ao sdl</CODE> (!) (?)</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
107 <TD></TD><TD>Max kHz:</TD><TD>?</TD><TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
108
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
109 <TD COLSPAN=3><B>Cards with envy24 chips (like Terratec EWS88MT)</B></TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
110 <TD></TD><TD>OSS:</TD><TD>?</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
111 <TD></TD><TD>OSS/Pro:</TD><TD>OK</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
112 <TD></TD><TD>ALSA:</TD><TD>?</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
113 <TD></TD><TD>Max kHz:</TD><TD>?</TD><TR>
3438
963b39283f48 fixes, and some new stuff. sorry forgot :)
gabucino
parents: 3276
diff changeset
114
6393
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
115 <TD COLSPAN=3><B>PC Speaker or DAC</B></TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
116 <TD></TD><TD>OSS:</TD><TD>OK (Use the SDL driver: <CODE>-ao sdl</CODE>)</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
117 <TD></TD><TD>ALSA:</TD><TD>no driver</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
118 <TD></TD><TD>Max kHz:</TD><TD>The driver emulates 44.1, maybe more.</TD><TR>
f9b3d010b35e FONT tags obsoleted by CSS
gabucino
parents: 6391
diff changeset
119 <TD></TD><TD>Driver:</TD><TD><A HREF="ftp://ftp.infradead.org/pub/pcsp">ftp://ftp.infradead.org/pub/pcsp</A></TD>
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
120 </TABLE>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
121
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
122 <UL>
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
123 <LI>On Linux, a 2.4.x kernel is highly recommended. Kernel 2.2 is not tested.</LI>
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
124 <LI>If sound clicks when playing from CD-ROM, turn on IRQ unmasking, e.g.
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
125 <CODE>hdparm -u1 /dev/cdrom</CODE> (<CODE>man hdparm</CODE>). This is
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
126 generally beneficial and described more detailed in the
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
127 <A HREF="cd-dvd.html#cd">CD-ROM section</A>.</LI>
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
128 <LI>Sharing your sound card with another application like XMMS is <B>strongly discouraged</B>!
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
129 If the other sound application is using ESD, start <B>MPlayer</B> with the <CODE>-vo sdl:esd</CODE> option
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
130 to combine both sound streams! In fact, the option <CODE>-vo sdl:esd</CODE> could be used with ESD
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
131 even when playing <B>Mplayer</B> alone.</LI>
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
132 <LI>Feedback to this document is welcome. Please tell us how <B>MPlayer</B> and
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
133 your sound card(s) worked together.</LI>
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
134 </UL>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
135
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
136
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
137 <P><B><A NAME="plugins">2.3.2.2 Audio plugins</A></B></P>
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
138
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
139 <P><B>MPlayer</B> has support for audio plugins. Audio plugins can be used for
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
140 changing the properties of the audio data before the sound reaches the sound
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
141 card. They are enabled using the <CODE>-aop</CODE> switch which takes a
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
142 <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
143 is required and determines which plugins should be used and in which order they
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
144 should be executed. Example:
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
145 </P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
146
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
147 <P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample,format</CODE></P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
148
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
149 <P>would run the sound through the resampling plugin followed by the format
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
150 plugin.
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
151 </P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
152
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
153 <P>The plugins can also have switches that change their behavior. These
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
154 switches are explained in detail in the sections below. A plugin will execute
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
155 using default settings if its switches are omitted. Here is an example of how
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
156 to use plugins in combination with plugin specific switches:
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
157 </P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
158
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
159 <P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
160 list=resample,format:fout=44100:format=0x8</CODE>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
161 </P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
162
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
163 <P>would set the output frequency of the resample plugin to 44100Hz and the
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
164 output format of the format plugin to AFMT_U8.
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
165 </P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
166
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
167 <P>Currently audio plugins can not be used in <B>MEncoder</B>.</P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
168
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
169
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
170 <P><B><A NAME="resample">2.3.2.2.1 Up/Downsampling</A></B></P>
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
171
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
172 <P><B>MPlayer</B> fully supports up/downsampling of the sound. This plugin can
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
173 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
174 stuck with an old sound card that is only capable of max 44.1kHz.
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
175 Limitations in your hardware are not auto detected, so you have to specify
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
176 the sample frequency explicitly. This plugin has one switch:
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
177 <CODE>fout</CODE> which is used for setting the desired output sample
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
178 frequency. It defaults to 48kHz, and is given in
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
179 &lt;Hz&gt;.
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
180 </P>
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
181
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
182 <P>Usage:<BR>
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
183 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample:fout=&lt;required
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
184 frequency in Hz, like 44100&gt;</CODE></P>
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
185
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
186 <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
187 Scaling up will cause the audio and video streams to be played in slow motion
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
188 in addition to audio distortion.</P>
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
189
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
190 <P><B><A NAME="surround_decoding">2.3.2.2.2 Surround Sound decoding</A></B></P>
3931
ef59dc91aaaf applied Steve's patch
gabucino
parents: 3857
diff changeset
191
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
192 <P><B>MPlayer</B> has an audio plugin that can decode matrix encoded
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
193 surround sound. Dolby Surround is an example of a matrix encoded format.
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
194 Many files with 2 channel audio actually contain matrixed surround sound.
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
195 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
196
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
197 <P>Usage:<BR>
3931
ef59dc91aaaf applied Steve's patch
gabucino
parents: 3857
diff changeset
198 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=surround</CODE></P>
ef59dc91aaaf applied Steve's patch
gabucino
parents: 3857
diff changeset
199
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
200
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
201 <P><B><A NAME="format">2.3.2.2.3 Sample format converter</A></B></P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
202
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
203 <P>If your sound card driver does not support signed 16bit <CODE>int</CODE> data type,
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
204 this plugin can
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
205 be used to change the format to one which your sound card can understand. It
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
206 has one switch, <CODE>format</CODE>, which can be set to one of the numbers
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
207 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
208 intended for advanced users. Keep in mind that this plugin only changes the
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
209 sample format and not the sample frequency or the number of channels.
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
210 </P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
211
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
212 <P>Usage:<BR>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
213 &nbsp;&nbsp;<CODE>mplayer media.avi -aop
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
214 list=format:format=&lt;required output format&gt;</CODE>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
215 </P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
216
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
217
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
218 <P><B><A NAME="delay">2.3.2.2.4 Delay</A></B></P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
219
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
220 <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
221 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
222 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
223 plugin unless you are a developer.</P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
224
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
225 <P><B><A NAME="volume">2.3.2.2.5 Software volume control</A></B></P>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
226
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
227 <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
228 can be used on machines with a broken mixer device. It can also be
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
229 used if one wants to change the output volume of <B>MPlayer</B>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
230 without changing the PCM volume setting in the mixer. It has one
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
231 switch <CODE>volume</CODE> that is used for setting the initial
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
232 sound level. The initial sound level can be set to values between 0
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
233 and 255 and defaults to 101 which equals 0dB amplification. Use this
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
234 plugin with caution since it can reduce the signal to noise ratio of
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
235 the sound. In most cases it is best to set the level for the PCM
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
236 sound to max, leave this plugin out and control the output level to
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
237 your speakers with the master volume control of the mixer. If there is an
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
238 external amplifier connected to the computer (this is almost always
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
239 the case), the noise level can be minimized by adjusting the master
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
240 level and the volume knob on the amplifier until the hissing noise
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
241 in the background is gone.
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
242 </P>
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
243
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
244 <P>Usage:<BR>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
245 &nbsp;&nbsp;<CODE>mplayer media.avi -aop
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
246 list=volume:volume=&lt;0-255&gt;</CODE>
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
247 </P>
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
248
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
249 <P>This plugin also has compressor or "soft-clipping" capabilities.
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
250 Compression can be used if the dynamic range of the sound is very
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
251 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
252 low. Be aware that this feature creates distortion and should be
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
253 considered a last resort.
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
254 </P>
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
255
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
256 <P>Usage:<BR>
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
257 &nbsp;&nbsp;<CODE>mplayer media.avi -aop
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
258 list=volume:softclip</CODE>
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
259 </P>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
260
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
261
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
262 <P><B><A NAME="extrastereo">2.3.2.2.6 Extrastereo</A></B></P>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
263
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
264 <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
265 channels (like the XMMS extrastereo plugin) which gives some sort of "live"
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
266 effect to playback.
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
267 </P>
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
268
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
269 <P>Usage:<BR>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
270 &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
271 &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
272
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
273 <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
274 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
275 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
276 -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
277
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
278
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
279 <P><B><A NAME="normalizer">2.3.2.2.7 Volume normalizer</A></B></P>
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
280
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
281 <P>This plugin maximizes the volume without distorting the sound.</P>
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
282
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
283 <P>Usage:<BR>
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
284 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=volnorm</CODE><BR>
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
285
5721
b53597b930b1 more deciliters
gabucino
parents: 5123
diff changeset
286
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
287 <P><B><A NAME="surround">2.3.2.2.8 Surround</A></B></P>
5721
b53597b930b1 more deciliters
gabucino
parents: 5123
diff changeset
288
b53597b930b1 more deciliters
gabucino
parents: 5123
diff changeset
289 <P>Someone should document something, sometime.</P>
b53597b930b1 more deciliters
gabucino
parents: 5123
diff changeset
290
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
291 </BODY>
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
292 </HTML>