annotate DOCS/sound.html @ 6998:83a386e88f9e

Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> * Reduces the number of '!' chars... * Removes unnecessary spaces before ':' and '!' chars. * Changes the title of Appendix X to 'MPlayer skin format'. * Improves(?) wording in some cases. * Adds CODE tags around some options and filenames. Plus some further wording fixes by me, two dangling links and converted a few ASCII unordered lists into proper HTML ones.
author diego
date Wed, 14 Aug 2002 12:24:01 +0000
parents d2cdfb831265
children 4f87cd0f642f
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
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
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>
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
19 <TR><TD COLSPAN=4><P><B>General:</B></P></TD></TR>
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
20 <TR><TD>&nbsp;&nbsp;</TD><TD VALIGN=top>oss</TD><TD>&nbsp;&nbsp;</TD><TD>OSS (ioctl) driver (supports hardware AC3 passthrough)</TD></TR>
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
21 <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>
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
22 <TR><TD></TD><TD VALIGN=top>nas</TD><TD></TD><TD>NAS (Network Audio System) driver</TD></TR>
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
23 <TR><TD></TD><TD VALIGN=top>alsa5</TD><TD></TD><TD>native ALSA 0.5 driver</TD></TR>
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
24 <TR><TD></TD><TD VALIGN=top>alsa9</TD><TD></TD><TD>native ALSA 0.9 driver (supports hardware AC3 passthrough)</TD></TR>
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
25 <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>
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
26 <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
27 </TABLE>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
28
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
29 <P>Fact is, Linux sound card drivers have compatibility problems.
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
30 It <B>may</B> take a while to find your optimal settings.</P>
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
31
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
32 <UL>
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
33 <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
34 default). If you experience glitches, halts or anything out of the
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
35 ordinary, try <CODE>-ao sdl</CODE> (NOTE: you need to have SDL libraries
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
36 and header files installed). The SDL audio driver helps in a lot of cases
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
37 and also supports ESD, ARTS, and up/downsampling. (ESD is the sound daemon
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
38 from GNOME, ARTS is from KDE.)</LI>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
39 <LI>If you have ALSA version 0.5, then you almost always have to use
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
40 <CODE>-ao alsa5</CODE> , since ALSA 0.5 has buggy OSS emulation code, and
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
41 will <B>crash MPlayer</B> with a message like this:<BR>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
42 <CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE></LI>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
43 <LI>If you have ALSA version 0.9 you may choose between <CODE>-ao oss</CODE>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
44 and <CODE>-ao sdl</CODE>. You can also use <CODE>-ao alsa9</CODE>. It
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
45 works, but there may be problems like lost sync and disappearing
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
46 audio.</LI>
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
47 </UL>
1892
70dbd25c128c jo sok ilyen ize.
gabucino
parents: 1704
diff changeset
48
70dbd25c128c jo sok ilyen ize.
gabucino
parents: 1704
diff changeset
49 <P>On <B>Solaris/FreeBSD</B> systems, use the SUN audio driver with the
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
50 <CODE>-ao sun</CODE> option, otherwise neither video nor audio will work.</P>
1892
70dbd25c128c jo sok ilyen ize.
gabucino
parents: 1704
diff changeset
51
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
52 <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
53
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
54 <TABLE BORDER=0 WIDTH="100%">
6975
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
55 <TR><TD COLSPAN=3><B>VIA onboard chipset (via82cxxx) 48kHz only</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
56 <TR><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
57
6975
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
58 <TR><TD COLSPAN=3><B>Aureal Vortex 2</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
59 <TR><TD>&nbsp;&nbsp;&nbsp;&nbsp;</TD><TD>OSS:</TD><TD>no driver</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
60 <TR><TD></TD><TD>OSS/Pro:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
61 <TR><TD></TD><TD>ALSA:</TD><TD>no driver</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
62 <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
63 <TR><TD></TD><TD>Driver:</TD><TD><A HREF="http://aureal.sourceforge.net">aureal.sourceforge.net</A></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
64 <TR><TD></TD><TD>Driver2:</TD><TD> from <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">here</A><BR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
65 (<I>buffer size increased to 32k</I>)</TD></TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
66
6975
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
67 <TR><TD COLSPAN=3><B>GUS PnP</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
68 <TR><TD></TD><TD>OSS:</TD><TD>no driver</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
69 <TR><TD></TD><TD>OSS/Pro:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
70 <TR><TD></TD><TD>ALSA:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
71 <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
1682
dba45a1aafad *** empty log message ***
gabucino
parents: 1668
diff changeset
72
6975
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
73 <TR><TD COLSPAN=3><B>SB Live!</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
74 <TR><TD></TD><TD>OSS:</TD><TD>Analog OK, SP/DIF not working</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
75 <TR><TD></TD><TD>ALSA:</TD><TD>Both OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
76 <TR><TD></TD><TD>Max kHz:</TD><TD>192</TD></TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
77
6975
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
78 <TR><TD COLSPAN=3><B>SB AWE 64</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
79 <TR><TD></TD><TD>OSS:</TD><TD>max 44kHz</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
80 <TR><TD></TD><TD>ALSA:</TD><TD>48kHz sounds bad</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
81 <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
1892
70dbd25c128c jo sok ilyen ize.
gabucino
parents: 1704
diff changeset
82
6975
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
83 <TR><TD COLSPAN=3><B>Gravis UltraSound ACE</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
84 <TR><TD></TD><TD>OSS:</TD><TD>not OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
85 <TR><TD></TD><TD>ALSA:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
86 <TR><TD></TD><TD>Max kHz:</TD><TD>44</TD></TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
87
6975
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
88 <TR><TD COLSPAN=3><B>Gravis UltraSound MAX</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
89 <TR><TD></TD><TD>OSS:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
90 <TR><TD></TD><TD>ALSA:</TD><TD>OK (?)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
91 <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
92
6975
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
93 <TR><TD COLSPAN=3><B>ESS 688</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
94 <TR><TD></TD><TD>OSS:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
95 <TR><TD></TD><TD>ALSA:</TD><TD>OK (?)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
96 <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
97
6975
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
98 <TR><TD COLSPAN=3><B>C-Media cards (which ones?)</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
99 <TR><TD></TD><TD>OSS:</TD><TD>not OK (hissing) (?)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
100 <TR><TD></TD><TD>ALSA:</TD><TD>OK (?)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
101 <TR><TD></TD><TD>Max kHz:</TD><TD>?</TD></TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
102
6975
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
103 <TR><TD COLSPAN=3><B>Yamaha cards (*ymf*)</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
104 <TR><TD></TD><TD>OSS:</TD><TD>not OK (?) (maybe <CODE>-ao sdl</CODE>)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
105 <TR><TD></TD><TD>ALSA:</TD><TD>OK only with ALSA 0.5 with OSS emulation <B>AND</B> <CODE>-ao sdl</CODE> (!) (?)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
106 <TR><TD></TD><TD>Max kHz:</TD><TD>?</TD></TR>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
107
6975
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
108 <TR><TD COLSPAN=3><B>Cards with envy24 chips (like Terratec EWS88MT)</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
109 <TR><TD></TD><TD>OSS:</TD><TD>?</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
110 <TR><TD></TD><TD>OSS/Pro:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
111 <TR><TD></TD><TD>ALSA:</TD><TD>?</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
112 <TR><TD></TD><TD>Max kHz:</TD><TD>?</TD></TR>
3438
963b39283f48 fixes, and some new stuff. sorry forgot :)
gabucino
parents: 3276
diff changeset
113
6975
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
114 <TR><TD COLSPAN=3><B>PC Speaker or DAC</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
115 <TR><TD></TD><TD>OSS:</TD><TD>OK (Use the SDL driver: <CODE>-ao sdl</CODE>)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
116 <TR><TD></TD><TD>ALSA:</TD><TD>no driver</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
117 <TR><TD></TD><TD>Max kHz:</TD><TD>The driver emulates 44.1, maybe more.</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed.
diego
parents: 6974
diff changeset
118 <TR><TD></TD><TD>Driver:</TD><TD><A HREF="ftp://ftp.infradead.org/pub/pcsp">ftp://ftp.infradead.org/pub/pcsp</A></TD></TR>
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
119 </TABLE>
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
120
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
121 <UL>
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
122 <LI>On Linux, a 2.4.x kernel is highly recommended. Kernel 2.2 is not tested.</LI>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
123 <LI>If sound clicks when playing from CD-ROM, turn on IRQ unmasking, e.g.
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
124 <CODE>hdparm -u1 /dev/cdrom</CODE> (<CODE>man hdparm</CODE>). This is
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
125 generally beneficial and described more detailed in the <A
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
126 HREF="cd-dvd.html#drives">CD-ROM section</A>.</LI>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
127 <LI>Sharing your sound card with another application like XMMS is <B>strongly
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
128 discouraged</B>! If the other sound application is using ESD, start
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
129 <B>MPlayer</B> with the <CODE>-vo sdl:esd</CODE> option to combine both
6998
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu>
diego
parents: 6975
diff changeset
130 sound streams. In fact, the option <CODE>-vo sdl:esd</CODE> could be used
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
131 with ESD even when playing <B>Mplayer</B> alone.</LI>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
132 <LI>Feedback to this document is welcome. Please tell us how <B>MPlayer</B>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6907
diff changeset
133 and your sound card(s) worked together.</LI>
5765
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
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
144 should be executed. Example:</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
145
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
146 <P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample,format</CODE></P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
147
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
148 <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
149 plugin.</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
150
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
151 <P>The plugins can also have switches that change their behavior. These
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
152 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
153 using default settings if its switches are omitted. Here is an example of how
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
154 to use plugins in combination with plugin specific switches:</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
155
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
156 <P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
157 list=resample,format:fout=44100:format=0x8</CODE></P>
4508
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>would set the output frequency of the resample plugin to 44100Hz and the
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
160 output format of the format plugin to AFMT_U8.</P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
161
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
162 <P>Currently audio plugins can not be used in <B>MEncoder</B>.</P>
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
163
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
164
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
165 <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
166
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
167 <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
168 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
169 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
170 Limitations in your hardware are not auto detected, so you have to specify
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
171 the sample frequency explicitly. This plugin has one switch:
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
172 <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
173 frequency. It defaults to 48kHz, and is given in
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
174 &lt;Hz&gt;.</P>
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
175
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
176 <P>Usage:<BR>
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
177 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample:fout=&lt;required
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
178 frequency in Hz, like 44100&gt;</CODE></P>
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
179
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
180 <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
181 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
182 in addition to audio distortion.</P>
3671
e84d8f81a120 'Plugins' subsection in Sound section
gabucino
parents: 3438
diff changeset
183
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
184
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
185 <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
186
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
187 <P><B>MPlayer</B> has an audio plugin that can decode matrix encoded
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
188 surround sound. Dolby Surround is an example of a matrix encoded format.
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
189 Many files with 2 channel audio actually contain matrixed surround sound.
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
190 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
191
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
192 <P>Usage:<BR>
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
193 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=surround</CODE></P>
3931
ef59dc91aaaf applied Steve's patch
gabucino
parents: 3857
diff changeset
194
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
195
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
196 <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
197
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
198 <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
199 this plugin can
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
200 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
201 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
202 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
203 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
204 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
205
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
206 <P>Usage:<BR>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
207 &nbsp;&nbsp;<CODE>mplayer media.avi -aop
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
208 list=format:format=&lt;required output format&gt;</CODE></P>
4508
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
209
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
210
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
211 <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
212
fb02f169e8e2 added more audio plugin documentation
gabucino
parents: 4469
diff changeset
213 <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
214 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
215 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
216 plugin unless you are a developer.</P>
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="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
219
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
220 <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
221 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
222 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
223 without changing the PCM volume setting in the mixer. It has one
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
224 switch <CODE>volume</CODE> that is used for setting the initial
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
225 sound level. The initial sound level can be set to values between 0
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
226 and 255 and defaults to 101 which equals 0dB amplification. Use this
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
227 plugin with caution since it can reduce the signal to noise ratio of
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
228 the sound. In most cases it is best to set the level for the PCM
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
229 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
230 your speakers with the master volume control of the mixer. If there is an
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
231 external amplifier connected to the computer (this is almost always
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
232 the case), the noise level can be minimized by adjusting the master
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
233 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
234 in the background is gone.</P>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
235
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
236 <P>Usage:<BR>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
237 &nbsp;&nbsp;<CODE>mplayer media.avi -aop
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
238 list=volume:volume=&lt;0-255&gt;</CODE></P>
4913
5eb369bc0188 applied Anders' Software Volume Control patch
gabucino
parents: 4908
diff changeset
239
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
240 <P>This plugin also has compressor or "soft-clipping" capabilities.
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
241 Compression can be used if the dynamic range of the sound is very
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
242 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
243 low. Be aware that this feature creates distortion and should be
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
244 considered a last resort.</P>
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
245
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
246 <P>Usage:<BR>
5099
922258ac9cf2 softclipping (ammegmi?)
gabucino
parents: 5069
diff changeset
247 &nbsp;&nbsp;<CODE>mplayer media.avi -aop
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
248 list=volume:softclip</CODE></P>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
249
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
250
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
251 <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
252
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
253 <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
254 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
255 effect to playback.</P>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
256
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
257 <P>Usage:<BR>
4928
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
258 &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
259 &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
260
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents: 4913
diff changeset
261 <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
262 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
263 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
264 -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
265
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
266
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
267 <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
268
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
269 <P>This plugin maximizes the volume without distorting the sound.</P>
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
270
5765
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch
gabucino
parents: 5721
diff changeset
271 <P>Usage:<BR>
5109
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
272 &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=volnorm</CODE><BR>
0ac187a189a8 volume normalizer plugin added
gabucino
parents: 5099
diff changeset
273
5721
b53597b930b1 more deciliters
gabucino
parents: 5123
diff changeset
274
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
275 <P><B><A NAME="surround">2.3.2.2.8 Surround</A></B></P>
5721
b53597b930b1 more deciliters
gabucino
parents: 5123
diff changeset
276
b53597b930b1 more deciliters
gabucino
parents: 5123
diff changeset
277 <P>Someone should document something, sometime.</P>
b53597b930b1 more deciliters
gabucino
parents: 5123
diff changeset
278
1612
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
279 </BODY>
1b011d6150c7 new, splitted, etc dox
gabucino
parents:
diff changeset
280 </HTML>