[Mplayer-cvslog] CVS: main/DOCS documentation.html,1.187,1.188 sound.html,1.22,1.23
Winner of tha face compo
gabucino at mplayer.dev.hu
Sun Feb 3 14:03:11 CET 2002
Update of /cvsroot/mplayer/main/DOCS
In directory mplayer:/var/tmp.root/cvs-serv19297
Modified Files:
documentation.html sound.html
Log Message:
added more audio plugin documentation
(patch submitted by Johansson <ajh at atri.curtin.edu.au>)
Index: documentation.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/documentation.html,v
retrieving revision 1.187
retrieving revision 1.188
diff -u -r1.187 -r1.188
--- documentation.html 3 Feb 2002 11:00:38 -0000 1.187
+++ documentation.html 3 Feb 2002 13:03:08 -0000 1.188
@@ -129,8 +129,11 @@
<LI><A HREF="sound.html#2.3.2.1">2.3.2.1 Soundcard experiences, recommendations</A></LI>
<LI><A HREF="sound.html#2.3.2.2">2.3.2.2 Audio plugins</A></LI>
<UL>
+ <LI><A HREF="sound.html#2.3.2.2">2.3.2.2 Summary</A></LI>
<LI><A HREF="sound.html#2.3.2.2.1">2.3.2.2.1 Up/Downsampling</A></LI>
<LI><A HREF="sound.html#2.3.2.2.2">2.3.2.2.2 Surround Sound decoding</A></LI>
+ <LI><A HREF="sound.html#2.3.2.2.3">2.3.2.2.3 Sample format converter</A></LI>
+ <LI><A HREF="sound.html#2.3.2.2.4">2.3.2.2.4 Delay</A></LI>
</UL>
</UL>
</UL>
Index: sound.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/sound.html,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- sound.html 1 Feb 2002 19:42:53 -0000 1.22
+++ sound.html 3 Feb 2002 13:03:08 -0000 1.23
@@ -126,13 +126,48 @@
<P><B><A NAME=2.3.2.2>2.3.2.2. Audio plugins</B></P>
+<P><B>MPlayer</B> has support for audio plugins. Audio plugins can be used for
+ changing the properties of the audio data before the sound reaches the sound
+ card. They are enabled using the <CODE>-aop</CODE> switch followed by the
+ <CODE>list=plugin1,plugin2,...</CODE> switch. The <CODE>list</CODE> switch is
+ required and determines which plugins that should be used and in which order
+ they should be executed, example:
+</P>
+
+<P> <CODE>mplayer media.avi -aop list=resample,format</CODE></P>
+
+<P>would run the sound through the resampling plugin followed by the format
+ plugin.
+</P>
+
+<P>The plugins can also have switches that changes their behaviour. These
+ switches are explained in detail in the sections below. A plugin will execute
+ using default settings if it's switches are omitted. Example of how to use
+ plugins in combination with plugin specific switches:
+</P>
+
+<P> <CODE>mplayer media.avi -aop
+ list=resample,format:fout=48000:format=0x8</CODE>
+</P>
+
+<P>would set the output frequency of the resample plugin to 44100Hz and the
+ output format of the format plugin to AFMT_U8.
+</P>
+
+<P>Currently audio plugins can not be used in <B>MEncoder</B>.</P>
+
+
<P><B><A NAME=2.3.2.2.1>2.3.2.2.1. Up/Downsampling</B></P>
-<P><B>MPlayer</B> fully supports up/downsampling of audio stream.
-It is not autodetected, so you have to specify it explicitly even when
-for example you have a max 44.1Khz capable soundcard, and the audio
-is 48Khz. Also, this functionality is currently unimplemented in
-<B>MEncoder</B>.</P>
+<P><B>MPlayer</B> fully supports up/down sampling of the sound. This plugin can
+ for example be used if you have a fixed frequency sound card or if you are
+ stuck with an olqd sound card that is only capable of max 44.1kHz.
+ Limitations in your hardware are not auto detected, so you have to specify
+ the sample frequency explicitly. This plugin has one switch:
+ <CODE>fout</CODE> which is used for setting the desired output sample
+ frequency, it defaults to 48kHz, and is given in
+ <Hz>.
+</P>
<P>Usage :<BR>
<CODE>mplayer media.avi -aop list=resample:fout=<required
@@ -151,6 +186,30 @@
<P>Usage :<BR>
<CODE>mplayer media.avi -aop list=surround</CODE></P>
+
+
+<P><B><A NAME=2.3.2.2.3>2.3.2.2.3. Sample format converter</A></B></P>
+
+<P>If your sound card driver doesn't support signed 16bit int, this plugin can
+ be used to change the format to one which your sound card can understand. It
+ has one switch <CODE>format</CODE> which can be set to one of the numbers
+ found in libao2/afmt.h. This plugin is hardly ever needed and is intended for
+ advanced users. Observe that this plugin only changes the sample format and
+ not the sample frequency or the number of channels.
+</P>
+
+<P>Usage :<BR>
+ <CODE>mplayer media.avi -aop
+ list=format:format=<required output format></CODE>
+</P>
+
+
+<P><B><A NAME=2.3.2.2.4>2.3.2.2.4. Delay</A></B></P>
+
+<P>This plugin delays the sound and is intended as an example of how to develop
+ new plugins. It can not be used for anything useful from users perspective
+ and is mentioned here for the sake of completeness only. Do not use this
+ plugin unless you are a developer.</P>
</BODY>
</HTML>
More information about the MPlayer-cvslog
mailing list