changeset 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 dcf46e65bd29
children 90386125ec1f
files DOCS/Hungarian/documentation.html DOCS/Hungarian/sound.html DOCS/documentation.html DOCS/sound.html
diffstat 4 files changed, 119 insertions(+), 5 deletions(-) [+]
line wrap: on
line diff
--- a/DOCS/Hungarian/documentation.html	Sun Feb 03 12:43:18 2002 +0000
+++ b/DOCS/Hungarian/documentation.html	Sun Feb 03 13:03:09 2002 +0000
@@ -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>
--- a/DOCS/Hungarian/sound.html	Sun Feb 03 12:43:18 2002 +0000
+++ b/DOCS/Hungarian/sound.html	Sun Feb 03 13:03:09 2002 +0000
@@ -130,6 +130,37 @@
 
 <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 @@
 &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>
--- a/DOCS/documentation.html	Sun Feb 03 12:43:18 2002 +0000
+++ b/DOCS/documentation.html	Sun Feb 03 13:03:09 2002 +0000
@@ -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>
--- a/DOCS/sound.html	Sun Feb 03 12:43:18 2002 +0000
+++ b/DOCS/sound.html	Sun Feb 03 13:03:09 2002 +0000
@@ -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>&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 @@
 <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>