Mercurial > mplayer.hg
annotate DOCS/sound.html @ 4508:fb02f169e8e2
added more audio plugin documentation
(patch submitted by Johansson <ajh@atri.curtin.edu.au>)
| author | gabucino |
|---|---|
| date | Sun, 03 Feb 2002 13:03:09 +0000 |
| parents | ac00b30ac80f |
| children | fd65c9bdcc76 |
| rev | line source |
|---|---|
| 1612 | 1 <HTML> |
| 1704 | 2 <BODY BGCOLOR=white> |
| 3 | |
| 4 <FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
| 1612 | 5 |
| 2745 | 6 <P><B><A NAME=2.3.2>2.3.2. Audio output devices</A></P></B> |
| 1612 | 7 |
| 1892 | 8 <P><B>MPlayer</B>'s audio interface is called <I>libao2</I>. It currently |
| 9 contains these drivers :</P> | |
| 10 | |
| 1905 | 11 <TABLE BORDER=0> |
| 12 | |
| 13 <TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>General:</B></P></TD> | |
| 14 | |
| 15 <TR><TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>oss</TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS (ioctl) driver</TD></TR> | |
| 16 <TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>sdl</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>SDL driver (supports up/downsampling, <B>ESD</B>, <B>ARTS</B> etc)</TD></TR> | |
| 3276 | 17 <TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>nas</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>NAS (Network Audio System) driver</TD></TR> |
| 1905 | 18 <TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>alsa5</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>native ALSA 0.5 driver</TD></TR> |
| 2060 | 19 <TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>alsa9</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>native ALSA 0.9 driver (works, but has problems -> use OSS)</TD></TR> |
| 1905 | 20 <TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>sun</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>SUN audio driver (/dev/audio) for BSD and Solaris8 users</TD></TR> |
| 21 | |
| 22 </TABLE> | |
| 1612 | 23 |
| 3857 | 24 <P>The fact is, Linux soundcard drivers are usually bad, and always as |
| 1892 | 25 incompatible as they can be. It MAY take a while to find your optimal settings.</P> |
| 26 <P><UL> | |
| 27 <LI>if you have OSS as driver, first try with <I>-ao oss</I> (this is the default). | |
| 28 If you experience glitches, halts or anything out of the ordinary, have a | |
| 29 look at <I>-ao sdl</I> (NOTE: of course you'll have to have a new SDL library and its | |
| 30 devel pair installed). It helps in a lot of cases (it also supports ESD, ARTS, and | |
| 31 up/downsampling. /esd is GNOME's, arts is KDE's sound daemon/).</LI> | |
| 32 <LI>if you have ALSA version 0.5, then you ALMOST always have to use <I>-ao alsa5</I> , | |
| 33 since 0.5 has buggy OSS emulation code, and will <B>crash MPlayer</B> with | |
| 34 a message like this:<BR> | |
| 35 <UL> | |
| 36 <CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE></UL> | |
| 37 </LI> | |
| 38 <LI>if you have ALSA version 0.9, use <I>-ao oss</I> or <I>-ao sdl</I> as you | |
| 2060 | 39 wish. You can also use <I>-ao alsa9</I> as it works now, however it has many |
| 40 problems (losing sync, disappearing audio, etc).</LI> | |
| 1892 | 41 </UL></P> |
| 42 | |
| 43 <P>On <B>Solaris/FreeBSD</B> systems, use the SUN audio driver with the | |
| 44 <I>-ao sun</I> option, otherwise you'll have no video, nor audio playing.</P> | |
| 45 | |
| 2745 | 46 <P><B><A NAME=2.3.2.1>2.3.2.1. Soundcard experiences, recommendations</A></B></P> |
| 1612 | 47 |
| 1682 | 48 <P><TABLE BORDER=0 WIDTH=100%> |
| 3190 | 49 <TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>VIA onboard chipset (via82cxxx) 48Khz only</B></TD><TR> |
| 50 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Driver:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> from <A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&release_id=59602">here</A></TD><TR> | |
| 51 | |
| 1892 | 52 <TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Aureal Vortex 2</B></TD><TR> |
| 53 <TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>no driver</TD><TR> | |
| 54 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS/Pro:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> | |
| 55 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>no driver</TD><TR> | |
| 56 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD>48</TD><TR> | |
| 57 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Driver:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF="http://aureal.sourceforge.net">aureal.sourceforge.net</A></TD><TR> | |
| 58 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Driver2:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> from <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">here</A><BR> | |
| 2999 | 59 (<I>buffer size increased to 32k</I>)</TD><TR> |
| 1612 | 60 |
| 1892 | 61 <TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>GUS PnP</B></TD><TR> |
| 62 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>no driver</TD><TR> | |
| 63 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS/Pro:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> | |
| 64 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> | |
| 65 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR> | |
| 1682 | 66 |
| 1892 | 67 <TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>SB Live!</B></TD><TR> |
| 68 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> | |
| 69 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>(?)</TD><TR> | |
| 70 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR> | |
| 1612 | 71 |
| 1892 | 72 <TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>SB AWE 64</B></TD><TR> |
| 73 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>max 44kHz</TD><TR> | |
| 74 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48kHz sounds shit</TD><TR> | |
| 75 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR> | |
| 76 | |
| 77 <TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Gravis UltraSound ACE</B></TD><TR> | |
| 4469 | 78 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>not OK</TD><TR> |
| 1892 | 79 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> |
| 4469 | 80 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>44</TD><TR> |
| 1612 | 81 |
| 1892 | 82 <TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Gravis UltraSound MAX</B></TD><TR> |
| 83 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> | |
| 84 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK (?)</TD><TR> | |
| 85 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR> | |
| 1612 | 86 |
| 1892 | 87 <TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ESS 688</B></TD><TR> |
| 88 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> | |
| 89 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK (?)</TD><TR> | |
| 90 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR> | |
| 1612 | 91 |
| 1892 | 92 <TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>C-Media cards (which ones?)</B></TD><TR> |
| 93 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>not OK (hissing) (?)</TD><TR> | |
| 94 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK (?)</TD><TR> | |
| 95 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR> | |
| 1612 | 96 |
|
3222
71a3d16f344f
hmm many things.. (sorry now i'm a bit confused:)
gabucino
parents:
3190
diff
changeset
|
97 <TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Yamaha cards (*ymf*)</B></TD><TR> |
| 2561 | 98 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>not OK (?) (maybe -ao sdl)</TD><TR> |
| 1892 | 99 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK only with ALSA 0.5 with OSS emulation <B>AND</B> <I>-ao sdl</I> (!) (?)</TD><TR> |
| 100 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR> | |
| 1612 | 101 |
| 3438 | 102 <TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Cards with envy24 chips (like Terratec EWS88MT)</B></TD><TR> |
| 103 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR> | |
| 104 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS/Pro:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> | |
| 105 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR> | |
| 106 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR> | |
| 107 | |
| 1892 | 108 <TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>PC Speaker or DAC</B></TD><TR> |
| 109 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK (<I>use the SDL driver : -ao sdl</I>)</TD><TR> | |
| 110 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>no driver</TD><TR> | |
| 111 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>the driver emulates 44.1 maybe more</TD><TR> | |
| 112 <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Driver:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF="ftp://ftp.infradead.org/pub/pcsp">ftp://ftp.infradead.org/pub/pcsp</A></TD><TR> | |
| 1682 | 113 </TABLE></P> |
| 1612 | 114 |
| 1682 | 115 <P><UL> |
| 1892 | 116 <LI>on Linux, use at least kernel 2.4 if possible, 2.2 isn't tested |
| 117 <LI>if sound clicks when playing from CD-ROM, turn on IRQ unmasking ! | |
| 1612 | 118 for example "hdparm -u1 /dev/cdrom" (see "man hdparm" !!!) |
| 119 This is recommended anyways... (for XMMS, etc...) | |
| 1682 | 120 Read section <A HREF="cd-dvd.html#4.1">4.1</A>. |
| 1892 | 121 <LI>don't use your soundcard by other application ( for ex. XMMS ) ! |
| 2202 | 122 if you use ESD, start MPlayer with the '-vo sdl:esd' option ! |
| 1892 | 123 <LI>Please tell us how MPlayer and your soundcard(s) worked together! |
| 1682 | 124 </UL></P> |
| 1612 | 125 |
| 3671 | 126 |
| 127 <P><B><A NAME=2.3.2.2>2.3.2.2. Audio plugins</B></P> | |
| 128 | |
| 4508 | 129 <P><B>MPlayer</B> has support for audio plugins. Audio plugins can be used for |
| 130 changing the properties of the audio data before the sound reaches the sound | |
| 131 card. They are enabled using the <CODE>-aop</CODE> switch followed by the | |
| 132 <CODE>list=plugin1,plugin2,...</CODE> switch. The <CODE>list</CODE> switch is | |
| 133 required and determines which plugins that should be used and in which order | |
| 134 they should be executed, example: | |
| 135 </P> | |
| 136 | |
| 137 <P> <CODE>mplayer media.avi -aop list=resample,format</CODE></P> | |
| 138 | |
| 139 <P>would run the sound through the resampling plugin followed by the format | |
| 140 plugin. | |
| 141 </P> | |
| 142 | |
| 143 <P>The plugins can also have switches that changes their behaviour. These | |
| 144 switches are explained in detail in the sections below. A plugin will execute | |
| 145 using default settings if it's switches are omitted. Example of how to use | |
| 146 plugins in combination with plugin specific switches: | |
| 147 </P> | |
| 148 | |
| 149 <P> <CODE>mplayer media.avi -aop | |
| 150 list=resample,format:fout=48000:format=0x8</CODE> | |
| 151 </P> | |
| 152 | |
| 153 <P>would set the output frequency of the resample plugin to 44100Hz and the | |
| 154 output format of the format plugin to AFMT_U8. | |
| 155 </P> | |
| 156 | |
| 157 <P>Currently audio plugins can not be used in <B>MEncoder</B>.</P> | |
| 158 | |
| 159 | |
| 3671 | 160 <P><B><A NAME=2.3.2.2.1>2.3.2.2.1. Up/Downsampling</B></P> |
| 161 | |
| 4508 | 162 <P><B>MPlayer</B> fully supports up/down sampling of the sound. This plugin can |
| 163 for example be used if you have a fixed frequency sound card or if you are | |
| 164 stuck with an olqd sound card that is only capable of max 44.1kHz. | |
| 165 Limitations in your hardware are not auto detected, so you have to specify | |
| 166 the sample frequency explicitly. This plugin has one switch: | |
| 167 <CODE>fout</CODE> which is used for setting the desired output sample | |
| 168 frequency, it defaults to 48kHz, and is given in | |
| 169 <Hz>. | |
| 170 </P> | |
| 3671 | 171 |
| 172 <P>Usage :<BR> | |
| 173 <CODE>mplayer media.avi -aop list=resample:fout=<required | |
| 174 frequency in Hz, like 44100></CODE></P> | |
| 175 | |
| 176 | |
| 3931 | 177 <P><B><A NAME=2.3.2.2.2>2.3.2.2.2. Surround Sound decoding</B></P> |
| 178 | |
| 179 <P><B>MPlayer</b> has an audio plugin that can decode matrix encoded | |
| 180 surround sound. Dolby Surround is an example of a matrix encoded format.</p> | |
| 181 | |
| 182 <P>Many files with 2 channel audio actually contain matrixed surround | |
| 183 sound.</p> | |
| 184 | |
| 185 <P>To use this feature, you will need a sound-card supporting at least 4 channels.</P> | |
| 186 | |
| 187 <P>Usage :<BR> | |
| 188 <CODE>mplayer media.avi -aop list=surround</CODE></P> | |
| 189 | |
| 4508 | 190 |
| 191 <P><B><A NAME=2.3.2.2.3>2.3.2.2.3. Sample format converter</A></B></P> | |
| 192 | |
| 193 <P>If your sound card driver doesn't support signed 16bit int, this plugin can | |
| 194 be used to change the format to one which your sound card can understand. It | |
| 195 has one switch <CODE>format</CODE> which can be set to one of the numbers | |
| 196 found in libao2/afmt.h. This plugin is hardly ever needed and is intended for | |
| 197 advanced users. Observe that this plugin only changes the sample format and | |
| 198 not the sample frequency or the number of channels. | |
| 199 </P> | |
| 200 | |
| 201 <P>Usage :<BR> | |
| 202 <CODE>mplayer media.avi -aop | |
| 203 list=format:format=<required output format></CODE> | |
| 204 </P> | |
| 205 | |
| 206 | |
| 207 <P><B><A NAME=2.3.2.2.4>2.3.2.2.4. Delay</A></B></P> | |
| 208 | |
| 209 <P>This plugin delays the sound and is intended as an example of how to develop | |
| 210 new plugins. It can not be used for anything useful from users perspective | |
| 211 and is mentioned here for the sake of completeness only. Do not use this | |
| 212 plugin unless you are a developer.</P> | |
| 213 | |
| 1612 | 214 </BODY> |
| 215 </HTML> |