added more audio plugin documentation

(patch submitted by Johansson <ajh@atri.curtin.edu.au>)


git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@4509 b3059339-0415-0410-9bf9-f77b7e298cf2
This commit is contained in:
gabucino 2002-02-03 13:03:09 +00:00
parent 43778fe0ac
commit fa44281fc5
4 changed files with 119 additions and 5 deletions

View File

@ -129,8 +129,11 @@
<LI><A HREF="sound.html#2.3.2.1">2.3.2.1 Ajánlott beállítások különféle hangkártyákhoz</A></LI>
<LI><A HREF="sound.html#2.3.2.2">2.3.2.2 Audio pluginek</A></LI>
<UL>
<LI><A HREF="sound.html#2.3.2.2">2.3.2.2 Bevezető</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 Térhatású hangok dekódolása</A></LI>
<LI><A HREF="sound.html#2.3.2.2.3">2.3.2.2.3 Sample formátum konvertáló</A></LI>
<LI><A HREF="sound.html#2.3.2.2.4">2.3.2.2.4 Delay</A></LI>
</UL>
</UL>
</UL>

View File

@ -130,6 +130,37 @@ is bugzik...</I></TD><TR>
<P><B><A NAME=2.3.2.2>2.3.2.2. Audio pluginek</A></B></P>
<P>Az <B>MPlayer</B> tartalmaz néhány audio plugint. Ezek a hang
tulajdonságainak megváltoztatására használhatóak. A használatuk az
<CODE>-aop</CODE> opcióval történik, amit a
<CODE>list=plugin1,plugin2,...</CODE> opció követ. A <CODE>list</CODE>
kapcsoló elhagyhatatlan, itt adható meg a használandó pluginek listája,
valamint a sorrendjük. Például a következő parancs:
</P>
<P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample,format</CODE></P>
<P>először a resample pluginen, aztán a format pluginen keresztül vezeti
a hangot.
</P>
<P>A plugineknek is vannak opcióik, amelyek befolyásolják őket. Ezek
részletesebben a következő fejezetekben vannak leírva. Ha egy pluginnak
nem adsz meg beállításokat, az alapértelmezett beállításban fognak futni.
Íme egy példa hogy hogyan használj több plugint, megadott opciókkal:
</P>
<P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop
list=resample,format:fout=48000:format=0x8</CODE>
</P>
<P>Ez 44100Hz-es kimeneti frekvenciára mixel, és a kimeneti formátumot
átállítja AFMT_U8-ra.
</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</A></B></P>
<P>Az <B>MPlayer</B> képes az audio stream frekvenciáját növelni illetve
@ -157,6 +188,24 @@ hangk
&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=surround</CODE></P>
<P><B><A NAME=2.3.2.2.3>2.3.2.2.3. Sample formátum konvertáló</A></B></P>
<P>Ha a hangkártyád nem támogatja a signed 16bit int formátumot, ezzel
a pluginnel átalakíthatod a kimeneti hangot olyanba amit visz.
Egy opciója van neki, a <CODE>format</CODE>, ami után megadandó a kívánt
formátum száma (lásd libao2/afmt.h). Ez a plugin ritkán használandó..
</P>
<P>Használat :<BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop
list=format:format=&lt;kimeneti formátum&gt;</CODE>
</P>
<P><B><A NAME=2.3.2.2.4>2.3.2.2.4. Delay</A></B></P>
<P>Példa plugin, csak developereknek. Lásd angol dox.</P>
</BODY>
</HTML>

View File

@ -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>

View File

@ -126,13 +126,48 @@ problems (losing sync, disappearing audio, etc).</LI>
<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>&nbsp;&nbsp;<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>&nbsp;&nbsp;<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
&lt;Hz&gt;.
</P>
<P>Usage :<BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample:fout=&lt;required
@ -152,5 +187,29 @@ sound.</p>
<P>Usage :<BR>
&nbsp;&nbsp;<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>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop
list=format:format=&lt;required output format&gt;</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>