"Software AC3 decoding" section. Patch by Stephen Davies <steve@daviesfam.org>

(doxized)


git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@3240 b3059339-0415-0410-9bf9-f77b7e298cf2

8 files changed, 110 insertions, 15 deletions

diff --git a/DOCS/Hungarian/codecs.html b/DOCS/Hungarian/codecs.html
index e2a7a79b2f..59c700f647 100644
--- a/DOCS/Hungarian/codecs.html
+++ b/DOCS/Hungarian/codecs.html
@@ -171,7 +171,7 @@ a Win32-es codeceket. Ezutóbbi codec nem támogat se YV12 se YUY2 kimenetet,
 csak BGR-t, ezért kizárólag X11 és OpenGL kimenetekkel működik. Remélhetőleg
 hamarosan az ffh263 is tud VIVO 2.0-ás file-okat dekódolni.</P>
 
-<P>Olvasd el a <A HREF=#2.2.2.3>VIVO audio codec</A> fejezetet is!</P>
+<P>Olvasd el a <A HREF=#2.2.2.4>VIVO audio codec</A> fejezetet is!</P>
 
 
 <P><B><A NAME=2.2.1.5>2.2.1.5.  MPEG 1/2 video</A></B></P>
@@ -212,7 +212,34 @@ a Win32 codeccel ami csak RGB-t tud.</P>
 </UL></P>
 
 
-<P><B><A NAME=2.2.2.1>2.2.2.1.  Hardveres AC3 dekódolás</B></P>
+<P><B><A NAME=2.2.2.1>2.2.2.1.  Szoftveres AC3 dekódolás</B></P>
+
+<P>Ez az alapértelmezett AC3 audio dekóder.</P>
+
+<P>Az AC3 dekóder 2, 4 vagy 6 hangszórós mixelési képességgel van ellátva.
+Ha 6 csatornára van állítva, a dekóder külön-külön adja a hangkártyának a 
+csatornákat, ami teljes térhatást eredményez, külső - hwac3 codec-kel 
+használható - AC3 dekóder nélkül.</P>
+
+<P>A <CODE>-channels</CODE> opcióval adható meg a kimeneti csatornák száma.
+A <CODE>-channels 2</CODE> stereo mixet eredményez. 4 csatornás mixhez
+(bal első, jobb első, bal térhatás és jobb térhatás) a <CODE>-channels 4</CODE>
+opció használható. Ebben az esetben minden "középső" csatorna egyenlő mértékben
+kerül az elülső csatornákra. Végül, a <CODE>-channels 6</CODE> opció
+ugyanúgy adja ki a csatornákat, ahogy azokat enkódolták - sorrendben : bal,
+jobb, bal térhatás, jobb térhatás, közép és LFE.</P>
+
+<P>Az alapértelmezett kimenet a 2 csatornás.</P>
+
+<P>Több mint két csatorna használatához OSS meghajtó kell, és egy olyan
+hangkártya (illetve meghajtó), ami támogatja is az adott mennyiségű
+csatornát a SNDCTL_DSP_CHANNELS ioctl-en keresztül. Például a 2001 augusztusinál
+újabb emu10k1 meghajtó (SB Live kártyákhoz) megfelelő.</P>
+
+<P>A több mint két csatornás mixelés kísérleti stádiumú.</P>
+
+
+<P><B><A NAME=2.2.2.2>2.2.2.2.  Hardveres AC3 dekódolás</B></P>
 
 <P>Kell egy AC3 képes hangkártya, digitális kimenettel (SP/DIF). A kártya
 meghajtójának támogatnia kell az AFMT_AC3 formátumot (ilyen például az
@@ -220,7 +247,7 @@ SB Live!). Kapcsold rá a hardveres AC3 dekódered az SP/DIF kimenetre,
 és használd az -ac hwac3 opciót. Akár működhet is. De nem fog. Tényleg. :)</P>
 
 
-<P><B><A NAME=2.2.2.2>2.2.2.2.  libmad támogatás</A></B></P>
+<P><B><A NAME=2.2.2.3>2.2.2.3.  libmad támogatás</A></B></P>
 
 <P>A <A HREF="http://mad.sourceforge.net">libmad</A> egy többplatformos MPEG
 audio dekóder. Ha nem tudod miért lenne szükséged rá, nincs szükséged rá.</P>
@@ -228,7 +255,7 @@ audio dekóder. Ha nem tudod miért lenne szükséged rá, nincs szükséged rá.</P>
 <P>A támogatást az <CODE>--enable-mad</CODE> configure opcióval lehet bekapcsolni.</P>
 
 
-<P><B><A NAME=2.2.2.3>2.2.2.3. VIVO audio</A></B></P>
+<P><B><A NAME=2.2.2.4>2.2.2.4. VIVO audio</A></B></P>
 
 <P>A VIVO file-okban használt audio codec milyensége attól függ hogy VIVO/1.0
 avagy VIVO/2.0 fileról beszélünk. Az 1.0-ás fileokban <B>g.723</B> audio van,
diff --git a/DOCS/Hungarian/documentation.html b/DOCS/Hungarian/documentation.html
index 06e1dbaafa..983298991d 100644
--- a/DOCS/Hungarian/documentation.html
+++ b/DOCS/Hungarian/documentation.html
@@ -55,9 +55,10 @@
       </UL>
       <LI><A HREF="codecs.html#2.2.2">2.2.2 Audio</A></LI>
       <UL>
-	<LI><A HREF="codecs.html#2.2.2.1">2.2.2.1 Hardveres AC3 dekódolás</A></LI>
-	<LI><A HREF="codecs.html#2.2.2.2">2.2.2.2 libmad támogatás</A></LI>
-        <LI><A HREF="codecs.html#2.2.2.3">2.2.2.3 VIVO audio</A></LI>
+	<LI><A HREF="codecs.html#2.2.2.1">2.2.2.1 Szoftveres AC3 dekódolás</A></LI>
+	<LI><A HREF="codecs.html#2.2.2.2">2.2.2.2 Hardveres AC3 dekódolás</A></LI>
+	<LI><A HREF="codecs.html#2.2.2.3">2.2.2.3 libmad támogatás</A></LI>
+        <LI><A HREF="codecs.html#2.2.2.4">2.2.2.4 VIVO audio</A></LI>
       </UL>
       <LI><A HREF="codecs.html#2.2.3">2.2.3 Hogyan használj ismeretlen Win32 codec-et</A></LI>
       <UL>
@@ -338,6 +339,15 @@ problémákba ütközni:<BR>
   kimenet</A> fejezetet is.</LI>
 </UL>
 
+<P><B><I>HANGKÁRTYÁK</I></B></P>
+
+<UL>
+<LI><B>Soundblaster Live</B> : ezekkel a kártyákkal lehetőséged van az
+  alapértelmezett 2 helyett 4 vagy 6 (<B>5.1</B>) csatornás AC3 kimenetre.
+  Olvasd el a <A HREF="codecs.html#2.2.2.1">Szoftveres AC3 dekódolás</A>
+  fejezetet.</LI>
+</UL>
+
 <P><B><I>EGYÉB FUNKCIÓK</I></B></P>
 
 <UL>
diff --git a/DOCS/Hungarian/formats.html b/DOCS/Hungarian/formats.html
index a53b7ffe17..48a2031342 100644
--- a/DOCS/Hungarian/formats.html
+++ b/DOCS/Hungarian/formats.html
@@ -160,7 +160,7 @@ fileok video codec-e egy módosított, nem szabványos <B>h.263</B> . Az audioval
 ugyanez a helyzet, <B>g.723</B> (szabvány), vagy <B>Vivo Siren</B>.</P>
 
 <P>Lásd a <A HREF=codecs.html#2.2.1.4>VIVO video codec</A>
-és <A HREF=codecs.html#2.2.2.3>VIVO audio codec</A> fejezeteket az installálási
+és <A HREF=codecs.html#2.2.2.4>VIVO audio codec</A> fejezeteket az installálási
 útmutatóhoz.</P>
 
 
diff --git a/DOCS/Hungarian/mplayer.1 b/DOCS/Hungarian/mplayer.1
index a58a6976c3..cb2388263f 100644
--- a/DOCS/Hungarian/mplayer.1
+++ b/DOCS/Hungarian/mplayer.1
@@ -80,6 +80,7 @@ mplayer \- Filmlejátszó Linuxra
 .RB [ \-bpp\ mélység ]
 .RB [ \-flip ]
 .RB [ \-playlist\ <file> ]
+.RB [ \-channels\ n ]
 .I - vagy file vagy eszköz
 .PP
 .SH LEÍRÁS
@@ -407,6 +408,15 @@ MPEG1 sztereó kimenet tipusának kiválasztása
         Jobb csatorna  2
 
 .TP
+.B \-channels n
+kimeneti audio csatornák számának kiválasztása
+
+        Sztereó        2
+        Térhatás       4
+        Teljes 5.1     6
+
+Jelenleg ez az opció csak AC3 audióhoz használható.
+.TP
 .B \-srate Hz
 audio lejátszása a megadott frekvencián. A lejátszás sebességére van
 hatással.
diff --git a/DOCS/codecs.html b/DOCS/codecs.html
index 9a8c8569e0..008542c965 100644
--- a/DOCS/codecs.html
+++ b/DOCS/codecs.html
@@ -207,7 +207,37 @@ outputs, in contrary to the Win32 codec which supports only RGB.</P>
 </UL></P>
 
 
-<P><B><A NAME=2.2.2.1>2.2.2.1.  Hardware AC3 decoding</A></B></P>
+<P><B><A NAME=2.2.2.1>2.2.2.1.  Software AC3 decoding</A></B></P>
+
+<P>This is the default decoder used for files with AC3 audio.</P>
+
+<P>The AC3 decoder can create output audio mixes for 2, 4, or 6
+speakers.  When configured for 6 speakers, this decoder provides
+separate output of all the AC3 channels to the soundcard driver,
+allowing the full "surround sound" experience without the external AC3
+decoder required to use the hwac3 codec.</P>
+
+<P>Use the <CODE>-channels</CODE> option to select the number of output channels.
+Use <CODE>-channels 2</CODE> for a stereo downmix.  For a 4 channel downmix (Left
+Front, Right Front, Left Surround and Right Surround outputs), use
+<CODE>-channels 4</CODE>.  In this case, any Centre channel will be mixed
+equally to the front channels.  Lastly, "-channels 6" will output all the AC3
+channels as they are encoded - in the order Left, Right, Left Surround, Right
+Surround, Centre and LFE.</P>
+
+<P>The default number of output channels is 2.</P>
+
+<P>To use more than 2 output channels, you'll need to be using OSS,
+and to have a soundcard driver that supports the appropriate number of
+output channels via the SNDCTL_DSP_CHANNELS ioctl.  For example, a
+version of the emu10k1 driver (used with the SB Live cards) newer than
+August 2001 should be suitable.</P>
+
+<P>Output mixes of more than 2 channels should be considered
+experimental.</P>
+
+
+<P><B><A NAME=2.2.2.2>2.2.2.2.  Hardware AC3 decoding</A></B></P>
 
 <P>You'll need an AC3 capable soundcard, with digital out (SP/DIF). The
 card's driver must support the AFMT_AC3 format (like SB Live! does).
@@ -215,7 +245,7 @@ Connect your AC3 decoder to the SP/DIF output, and use the '-ac hwac3'
 option. It may or may not work (experimental). (probably won't...)</P>
 
 
-<P><B><A NAME=2.2.2.2>2.2.2.2.  libmad support</A></B></P>
+<P><B><A NAME=2.2.2.3>2.2.2.3.  libmad support</A></B></P>
 
 <P><A HREF="http://mad.sourceforge.net">libmad</A> is a multiplatform MPEG audio
 decoding library. If you don't know why is it good, you probably don't need it.</P>
@@ -224,7 +254,7 @@ decoding library. If you don't know why is it good, you probably don't need it.<
 option.</P>
 
 
-<P><B><A NAME=2.2.2.3>2.2.2.3.  VIVO audio</A></B></P>
+<P><B><A NAME=2.2.2.4>2.2.2.4.  VIVO audio</A></B></P>
 
 <P>The audio codec used in VIVO files depends on whether it's a VIVO/1.0 or
 VIVO/2.0 file. VIVO/1.0 files have <B>g.723</B> audio, and VIVO/2.0 files
diff --git a/DOCS/documentation.html b/DOCS/documentation.html
index c0070c51ce..9f1e610c5b 100644
--- a/DOCS/documentation.html
+++ b/DOCS/documentation.html
@@ -55,9 +55,10 @@
       </UL>
       <LI><A HREF="codecs.html#2.2.2">2.2.2 Audio</A></LI>
       <UL>
-	<LI><A HREF="codecs.html#2.2.2.1">2.2.2.1 Hardware AC3 decoding</A></LI>
-	<LI><A HREF="codecs.html#2.2.2.2">2.2.2.2 libmad support</A></LI>
-	<LI><A HREF="codecs.html#2.2.2.3">2.2.2.3 VIVO audio</A></LI>
+	<LI><A HREF="codecs.html#2.2.2.1">2.2.2.1 Software AC3 decoding</A></LI>
+	<LI><A HREF="codecs.html#2.2.2.2">2.2.2.2 Hardware AC3 decoding</A></LI>
+	<LI><A HREF="codecs.html#2.2.2.3">2.2.2.3 libmad support</A></LI>
+	<LI><A HREF="codecs.html#2.2.2.4">2.2.2.4 VIVO audio</A></LI>
       </UL>
       <LI><A HREF="codecs.html#2.2.3">2.2.3 Win32 codec importing howto</A></LI>
       <UL>
@@ -334,6 +335,14 @@ supported under Linux/MPlayer. If you have a <B>Radeon</B> or <B>Rage128</B> car
 HREF="video.html#2.3.1.14">this</A> section !</LI>
 </UL>
 
+<P><B><I>SOUNDCARDS</I></B></P>
+
+<UL>
+<LI><B>Soundblaster Live!</B> : with this card you can use 4 or 6 (<B>5.1</B>)
+channels AC3 decoding instead of 2. Read the
+<A HREF="codecs.html#2.2.2.1">Software AC3 decoding</A> section.</LI>
+</UL>
+
 <P><B><I>FEATURES</I></B></P>
 
 <UL>
diff --git a/DOCS/formats.html b/DOCS/formats.html
index 42d1cf4b2a..3d8cc6e576 100644
--- a/DOCS/formats.html
+++ b/DOCS/formats.html
@@ -153,7 +153,7 @@ video codec is a modified, nonstandard <B>h.263</B> . Audio is the same,
 it may be <B>g.723</B> (standard), or <B>Vivo Siren</B> .</P>
 
 <P>See the <A HREF=codecs.html#2.2.1.4>VIVO video codec</A>
-and <A HREF=codecs.html#2.2.2.3>VIVO audio codec</A> sections for installation
+and <A HREF=codecs.html#2.2.2.4>VIVO audio codec</A> sections for installation
 instructions.</P>
 
 
diff --git a/DOCS/mplayer.1 b/DOCS/mplayer.1
index 2e0c6b48eb..4a3630a7e7 100644
--- a/DOCS/mplayer.1
+++ b/DOCS/mplayer.1
@@ -48,6 +48,7 @@ mplayer \- Movie Player for Linux
 .RB [ \-nodouble ]
 .RB [ \-double ]
 .RB [ \-stereo\ mode ]
+.RB [ \-channels\ n ]
 .RB [ \-srate\ Hz ]
 .RB [ \-osdlevel\ level ]
 .RB [ \-config\ file ]
@@ -403,7 +404,15 @@ select type of MPEG1 stereo output.
         Stereo         0
         Left channel   1
         Right channel  2
+.TP
+.B \-channels n
+select number of audio output channels to be used
+
+        Stereo         2
+        Surround       4
+        Full 5.1       6
 
+Currently this option is only honoured for AC3 audio.
 .TP
 .B \-srate Hz
 specifies Hz to playback audio on. Has effect on playback speed!