Mercurial > mplayer.hg
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 |
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 | 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 | 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 | 11 |
1612 | 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 | 14 |
1892 | 15 <P><B>MPlayer</B>'s audio interface is called <I>libao2</I>. It currently |
5765 | 16 contains these drivers:</P> |
1892 | 17 |
1905 | 18 <TABLE BORDER=0> |
19 | |
6393 | 20 <TR><TD COLSPAN=4><P><B>General:</B></P></TD></TR> |
1905 | 21 |
6393 | 22 <TR><TD> </TD><TD VALIGN=top>oss</TD><TD> </TD><TD>OSS (ioctl) driver (supports hardware AC3 passthrough)</TD></TR> |
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> | |
24 <TR><TD></TD><TD VALIGN=top>nas</TD><TD></TD><TD>NAS (Network Audio System) driver</TD></TR> | |
25 <TR><TD></TD><TD VALIGN=top>alsa5</TD><TD></TD><TD>native ALSA 0.5 driver</TD></TR> | |
6583 | 26 <TR><TD></TD><TD VALIGN=top>alsa9</TD><TD></TD><TD>native ALSA 0.9 driver (supports hardware AC3 passthrough)</TD></TR> |
6393 | 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> |
28 <TR><TD></TD><TD VALIGN=top>arts</TD><TD></TD><TD>native ARTS driver (mostly for KDE users)</TD></TR> | |
1905 | 29 |
30 </TABLE> | |
1612 | 31 |
5765 | 32 <P>Fact is, Linux sound card drivers have compatibility problems. |
33 It <B>may</B> take a while to find your optimal settings.</P> | |
34 | |
35 <UL> | |
36 <LI>If you have an OSS driver, first try <CODE>-ao oss</CODE> (this is the default). | |
37 If you experience glitches, halts or anything out of the ordinary, try | |
38 <CODE>-ao sdl</CODE> (NOTE: you need to have SDL libraries and header files | |
39 installed). The SDL audio driver helps in a lot of cases and also supports ESD, | |
40 ARTS, and up/downsampling. (ESD is the sound daemon from GNOME, ARTS is from KDE.)</LI> | |
41 <LI>If you have ALSA version 0.5, then you almost always have to use <CODE>-ao alsa5</CODE> , | |
42 since ALSA 0.5 has buggy OSS emulation code, and will <B>crash MPlayer</B> with | |
1892 | 43 a message like this:<BR> |
5765 | 44 <CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE></LI> |
45 <LI>If you have ALSA version 0.9 you may choose between <CODE>-ao oss</CODE> and | |
46 <CODE>-ao sdl</CODE>. You can also use <CODE>-ao alsa9</CODE>. It works, but | |
6583 | 47 there may be problems like lost sync and disappearing audio.</LI> |
5765 | 48 </UL> |
1892 | 49 |
50 <P>On <B>Solaris/FreeBSD</B> systems, use the SUN audio driver with the | |
5765 | 51 <CODE>-ao sun</CODE> option, otherwise neither video nor audio will work.</P> |
1892 | 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 | 54 |
5765 | 55 <TABLE BORDER=0 WIDTH="100%"> |
6393 | 56 <TR><TD COLSPAN=3><B>VIA onboard chipset (via82cxxx) 48kHz only</B></TD><TR> |
57 <TD></TD><TD>Driver:</TD><TD> from <A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&release_id=59602">here</A></TD><TR> | |
3190 | 58 |
6393 | 59 <TD COLSPAN=3><B>Aureal Vortex 2</B></TD><TR> |
60 <TD> </TD><TD>OSS:</TD><TD>no driver</TD><TR> | |
61 <TD></TD><TD>OSS/Pro:</TD><TD>OK</TD><TR> | |
62 <TD></TD><TD>ALSA:</TD><TD>no driver</TD><TR> | |
63 <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR> | |
64 <TD></TD><TD>Driver:</TD><TD><A HREF="http://aureal.sourceforge.net">aureal.sourceforge.net</A></TD><TR> | |
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 | 66 (<I>buffer size increased to 32k</I>)</TD><TR> |
1612 | 67 |
6393 | 68 <TD COLSPAN=3><B>GUS PnP</B></TD><TR> |
69 <TD></TD><TD>OSS:</TD><TD>no driver</TD><TR> | |
70 <TD></TD><TD>OSS/Pro:</TD><TD>OK</TD><TR> | |
71 <TD></TD><TD>ALSA:</TD><TD>OK</TD><TR> | |
72 <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR> | |
1682 | 73 |
6393 | 74 <TD COLSPAN=3><B>SB Live!</B></TD><TR> |
75 <TD></TD><TD>OSS:</TD><TD>Analog OK, SP/DIF not working</TD><TR> | |
76 <TD></TD><TD>ALSA:</TD><TD>Both OK</TD><TR> | |
77 <TD></TD><TD>Max kHz:</TD><TD>192</TD><TR> | |
1612 | 78 |
6393 | 79 <TD COLSPAN=3><B>SB AWE 64</B></TD><TR> |
80 <TD></TD><TD>OSS:</TD><TD>max 44kHz</TD><TR> | |
81 <TD></TD><TD>ALSA:</TD><TD>48kHz sounds bad</TD><TR> | |
82 <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR> | |
1892 | 83 |
6393 | 84 <TD COLSPAN=3><B>Gravis UltraSound ACE</B></TD><TR> |
85 <TD></TD><TD>OSS:</TD><TD>not OK</TD><TR> | |
86 <TD></TD><TD>ALSA:</TD><TD>OK</TD><TR> | |
87 <TD></TD><TD>Max kHz:</TD><TD>44</TD><TR> | |
1612 | 88 |
6393 | 89 <TD COLSPAN=3><B>Gravis UltraSound MAX</B></TD><TR> |
90 <TD></TD><TD>OSS:</TD><TD>OK</TD><TR> | |
91 <TD></TD><TD>ALSA:</TD><TD>OK (?)</TD><TR> | |
92 <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR> | |
1612 | 93 |
6393 | 94 <TD COLSPAN=3><B>ESS 688</B></TD><TR> |
95 <TD></TD><TD>OSS:</TD><TD>OK</TD><TR> | |
96 <TD></TD><TD>ALSA:</TD><TD>OK (?)</TD><TR> | |
97 <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR> | |
1612 | 98 |
6393 | 99 <TD COLSPAN=3><B>C-Media cards (which ones?)</B></TD><TR> |
100 <TD></TD><TD>OSS:</TD><TD>not OK (hissing) (?)</TD><TR> | |
101 <TD></TD><TD>ALSA:</TD><TD>OK (?)</TD><TR> | |
102 <TD></TD><TD>Max kHz:</TD><TD>?</TD><TR> | |
1612 | 103 |
6393 | 104 <TD COLSPAN=3><B>Yamaha cards (*ymf*)</B></TD><TR> |
105 <TD></TD><TD>OSS:</TD><TD>not OK (?) (maybe <CODE>-ao sdl</CODE>)</TD><TR> | |
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> | |
107 <TD></TD><TD>Max kHz:</TD><TD>?</TD><TR> | |
1612 | 108 |
6393 | 109 <TD COLSPAN=3><B>Cards with envy24 chips (like Terratec EWS88MT)</B></TD><TR> |
110 <TD></TD><TD>OSS:</TD><TD>?</TD><TR> | |
111 <TD></TD><TD>OSS/Pro:</TD><TD>OK</TD><TR> | |
112 <TD></TD><TD>ALSA:</TD><TD>?</TD><TR> | |
113 <TD></TD><TD>Max kHz:</TD><TD>?</TD><TR> | |
3438 | 114 |
6393 | 115 <TD COLSPAN=3><B>PC Speaker or DAC</B></TD><TR> |
116 <TD></TD><TD>OSS:</TD><TD>OK (Use the SDL driver: <CODE>-ao sdl</CODE>)</TD><TR> | |
117 <TD></TD><TD>ALSA:</TD><TD>no driver</TD><TR> | |
118 <TD></TD><TD>Max kHz:</TD><TD>The driver emulates 44.1, maybe more.</TD><TR> | |
119 <TD></TD><TD>Driver:</TD><TD><A HREF="ftp://ftp.infradead.org/pub/pcsp">ftp://ftp.infradead.org/pub/pcsp</A></TD> | |
5765 | 120 </TABLE> |
1612 | 121 |
5765 | 122 <UL> |
123 <LI>On Linux, a 2.4.x kernel is highly recommended. Kernel 2.2 is not tested.</LI> | |
124 <LI>If sound clicks when playing from CD-ROM, turn on IRQ unmasking, e.g. | |
125 <CODE>hdparm -u1 /dev/cdrom</CODE> (<CODE>man hdparm</CODE>). This is | |
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 | 128 <LI>Sharing your sound card with another application like XMMS is <B>strongly discouraged</B>! |
129 If the other sound application is using ESD, start <B>MPlayer</B> with the <CODE>-vo sdl:esd</CODE> option | |
130 to combine both sound streams! In fact, the option <CODE>-vo sdl:esd</CODE> could be used with ESD | |
131 even when playing <B>Mplayer</B> alone.</LI> | |
132 <LI>Feedback to this document is welcome. Please tell us how <B>MPlayer</B> and | |
133 your sound card(s) worked together.</LI> | |
134 </UL> | |
1612 | 135 |
3671 | 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 | 138 |
4508 | 139 <P><B>MPlayer</B> has support for audio plugins. Audio plugins can be used for |
140 changing the properties of the audio data before the sound reaches the sound | |
5765 | 141 card. They are enabled using the <CODE>-aop</CODE> switch which takes a |
142 <CODE>list=plugin1,plugin2,...</CODE> argument. The <CODE>list</CODE> argument | |
143 is required and determines which plugins should be used and in which order they | |
144 should be executed. Example: | |
4508 | 145 </P> |
146 | |
147 <P> <CODE>mplayer media.avi -aop list=resample,format</CODE></P> | |
148 | |
149 <P>would run the sound through the resampling plugin followed by the format | |
150 plugin. | |
151 </P> | |
152 | |
5765 | 153 <P>The plugins can also have switches that change their behavior. These |
4508 | 154 switches are explained in detail in the sections below. A plugin will execute |
5765 | 155 using default settings if its switches are omitted. Here is an example of how |
156 to use plugins in combination with plugin specific switches: | |
4508 | 157 </P> |
158 | |
159 <P> <CODE>mplayer media.avi -aop | |
5765 | 160 list=resample,format:fout=44100:format=0x8</CODE> |
4508 | 161 </P> |
162 | |
163 <P>would set the output frequency of the resample plugin to 44100Hz and the | |
164 output format of the format plugin to AFMT_U8. | |
165 </P> | |
166 | |
167 <P>Currently audio plugins can not be used in <B>MEncoder</B>.</P> | |
168 | |
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 | 171 |
5765 | 172 <P><B>MPlayer</B> fully supports up/downsampling of the sound. This plugin can |
173 be used if you have a fixed frequency sound card or if you are | |
174 stuck with an old sound card that is only capable of max 44.1kHz. | |
4508 | 175 Limitations in your hardware are not auto detected, so you have to specify |
176 the sample frequency explicitly. This plugin has one switch: | |
177 <CODE>fout</CODE> which is used for setting the desired output sample | |
5765 | 178 frequency. It defaults to 48kHz, and is given in |
4508 | 179 <Hz>. |
180 </P> | |
3671 | 181 |
5765 | 182 <P>Usage:<BR> |
3671 | 183 <CODE>mplayer media.avi -aop list=resample:fout=<required |
184 frequency in Hz, like 44100></CODE></P> | |
185 | |
5765 | 186 <P>Note that the output frequency should not be scaled up from the default value. |
187 Scaling up will cause the audio and video streams to be played in slow motion | |
188 in addition to audio distortion.</P> | |
3671 | 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 | 191 |
5765 | 192 <P><B>MPlayer</B> has an audio plugin that can decode matrix encoded |
193 surround sound. Dolby Surround is an example of a matrix encoded format. | |
194 Many files with 2 channel audio actually contain matrixed surround sound. | |
195 To use this feature you need a sound card supporting at least 4 channels.</P> | |
3931 | 196 |
5765 | 197 <P>Usage:<BR> |
3931 | 198 <CODE>mplayer media.avi -aop list=surround</CODE></P> |
199 | |
4508 | 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 | 202 |
5765 | 203 <P>If your sound card driver does not support signed 16bit <CODE>int</CODE> data type, |
204 this plugin can | |
4508 | 205 be used to change the format to one which your sound card can understand. It |
5765 | 206 has one switch, <CODE>format</CODE>, which can be set to one of the numbers |
207 found in <CODE>libao2/afmt.h</CODE>. This plugin is hardly ever needed and is | |
208 intended for advanced users. Keep in mind that this plugin only changes the | |
209 sample format and not the sample frequency or the number of channels. | |
4508 | 210 </P> |
211 | |
5765 | 212 <P>Usage:<BR> |
4508 | 213 <CODE>mplayer media.avi -aop |
214 list=format:format=<required output format></CODE> | |
215 </P> | |
216 | |
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 | 219 |
220 <P>This plugin delays the sound and is intended as an example of how to develop | |
5765 | 221 new plugins. It can not be used for anything useful from a users perspective |
4508 | 222 and is mentioned here for the sake of completeness only. Do not use this |
223 plugin unless you are a developer.</P> | |
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 | 226 |
227 <P>This plugin is a software replacement for the volume control, and | |
5765 | 228 can be used on machines with a broken mixer device. It can also be |
229 used if one wants to change the output volume of <B>MPlayer</B> | |
4913 | 230 without changing the PCM volume setting in the mixer. It has one |
231 switch <CODE>volume</CODE> that is used for setting the initial | |
232 sound level. The initial sound level can be set to values between 0 | |
5099 | 233 and 255 and defaults to 101 which equals 0dB amplification. Use this |
234 plugin with caution since it can reduce the signal to noise ratio of | |
235 the sound. In most cases it is best to set the level for the PCM | |
236 sound to max, leave this plugin out and control the output level to | |
5765 | 237 your speakers with the master volume control of the mixer. If there is an |
5099 | 238 external amplifier connected to the computer (this is almost always |
239 the case), the noise level can be minimized by adjusting the master | |
240 level and the volume knob on the amplifier until the hissing noise | |
241 in the background is gone. | |
4913 | 242 </P> |
243 | |
5765 | 244 <P>Usage:<BR> |
4913 | 245 <CODE>mplayer media.avi -aop |
246 list=volume:volume=<0-255></CODE> | |
247 </P> | |
248 | |
5765 | 249 <P>This plugin also has compressor or "soft-clipping" capabilities. |
5099 | 250 Compression can be used if the dynamic range of the sound is very |
251 high or if the dynamic range of the loudspeakers is very | |
5765 | 252 low. Be aware that this feature creates distortion and should be |
5099 | 253 considered a last resort. |
254 </P> | |
255 | |
5765 | 256 <P>Usage:<BR> |
5099 | 257 <CODE>mplayer media.avi -aop |
258 list=volume:softclip</CODE> | |
259 </P> | |
4928
ecf9f93dd9b6
added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents:
4913
diff
changeset
|
260 |
5109 | 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 | 264 <P>This plugin (linearly) increases the difference between left and right |
265 channels (like the XMMS extrastereo plugin) which gives some sort of "live" | |
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 | 269 <P>Usage:<BR> |
4928
ecf9f93dd9b6
added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents:
4913
diff
changeset
|
270 <CODE>mplayer media.avi -aop list=extrastereo</CODE><BR> |
ecf9f93dd9b6
added documentation for "extrastereo" plugin (patch by pl)
gabucino
parents:
4913
diff
changeset
|
271 <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 | 274 to 2.5. If you set it to 0.0, you will have mono sound (average of both |
6272 | 275 channels). If you set it to 1.0, sound will be unchanged, if you set it to |
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 | 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 | 280 |
5765 | 281 <P>This plugin maximizes the volume without distorting the sound.</P> |
5109 | 282 |
5765 | 283 <P>Usage:<BR> |
5109 | 284 <CODE>mplayer media.avi -aop list=volnorm</CODE><BR> |
285 | |
5721 | 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 | 288 |
289 <P>Someone should document something, sometime.</P> | |
290 | |
1612 | 291 </BODY> |
292 </HTML> |