3-pass encoding dox

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

4 files changed, 158 insertions, 28 deletions

diff --git a/DOCS/Hungarian/documentation.html b/DOCS/Hungarian/documentation.html
index 259fcf9465..72400f3f35 100644
--- a/DOCS/Hungarian/documentation.html
+++ b/DOCS/Hungarian/documentation.html
@@ -140,7 +140,7 @@
         <LI><A HREF="encoding.html#2.4.3">2.4.3 Funkciók</A></LI>
           <UL>
             <LI><A HREF="encoding.html#2.4.3">2.4.3 Áttekintés</A></LI>
-            <LI><A HREF="encoding.html#2.4.3.1">2.4.3.1 2 menetes DivX4 enkódolása</A></LI>
+            <LI><A HREF="encoding.html#2.4.3.1">2.4.3.1 2 vagy 3 menetes DivX4 enkódolása</A></LI>
             <LI><A HREF="encoding.html#2.4.3.2">2.4.3.2 Átméretezés</A></LI>
             <LI><A HREF="encoding.html#2.4.3.3">2.4.3.3 Stream másolása</A></LI>
             <LI><A HREF="encoding.html#2.4.3.4">2.4.3.4 Hibás index-ű AVI-k rendbehozása</A></LI>
diff --git a/DOCS/Hungarian/encoding.html b/DOCS/Hungarian/encoding.html
index 30d8d54c93..30d604055e 100644
--- a/DOCS/Hungarian/encoding.html
+++ b/DOCS/Hungarian/encoding.html
@@ -11,10 +11,10 @@
 enkóder, az MPlayer által lejátszható formátumok
 (<B>AVI/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET</B>) más - MPlayerrel lejátszható -
 formátumokba kódolására.
-Jelenleg béta verzió, és csak <B>DivX4</B> (1 vagy 2 menet) videoba, és
-<B>PCM</B>/<B>MP3</B>/<B>VBRMP3</B> audioba tud kódolni. Rendelkezik továbbá
-stream másoló képességgel. A közeljövőben tervezzük vágó, átméretező filterek
-beépítését, és hasonlókat.</P>
+Sokféle codec-kel tud enkódolni, például <B>DivX4</B>-gyel (1 vagy 2 menetes),
+a libavcodec-et alkotó codec-ekkel, audiot tekintve pedig
+<B>PCM</B>/<B>MP3</B>/<B>VBR MP3</B> a választék. Rendelkezik továbbá stream
+másoló, és video átméretező képességgel.</P>
 
 <P><B><A NAME=2.4.2>2.4.2.  Fordítás</B></P>
 
@@ -56,7 +56,7 @@ beépítését, és hasonlókat.</P>
       is</LI>
     <LI>enkódolás <B>V4L kompatibilis TV tunerekről</B></LI>
     <LI>enkódolása/multiplexelése interleaved AVI-knak, megfelelő index-szel</LI>
-    <LI>1 vagy 2 menetes <B>DivX4</B> video</LI>
+    <LI>1, 2 vagy 3 menetes <B>DivX4</B> video</LI>
     <LI><B>VBR</B> MP3 audio - <B>FONTOS</B> : a VBR-es mp3-ak nem minden
       körülmények között lejátszhatóak windows rendszereken! Ha windows-on
       (is) lejátszandó AVI-t akarsz létrehozni, csinálj CBR-es mp3-at!</LI>
@@ -80,21 +80,90 @@ beépítését, és hasonlókat.</P>
   </UL>
 </P>
 
-<P><B><A NAME=2.4.3.1>2.4.3.1.  2 menetes DivX4 enkódolása</B></P>
+<P><B><A NAME=2.4.3.1>2.4.3.1.  2, 3 menetes DivX4 enkódolása</B></P>
 
-<P>Az elnevezés onnan jön, hogy ezzel a módszerrel a file <I>kétszer</I> lesz
-enkódolva. Az első menet néhány pár Mb-os ideiglenes (*.log) file-t hoz létre,
-amiket egyelőre nem szabad törölni (az AVI törölhető, ugyanolyan mintha -pass
-opciók nélkül keletkezett volna). A második menetben keletkezik a tényleges
-2 menetes DivX, az ideiglenes file-ok adataiből. A keletkező file az
-egy menetesekhez képest sokkal jobb minőséggel és kisebb mérettel bír. Ha most
-hallassz erről először, jobb ha keresel a neten egy útmutatót.</P>
+<P><U><B>2 menetes enkódolás :</B></U> az elnevezés onnan jön, hogy ezzel a
+  módszerrel a file <I>kétszer</I> lesz enkódolva. Az első menet néhány pár
+  Mb-os ideiglenes (*.log) file-t hoz létre, amiket egyelőre nem szabad törölni
+  (az AVI törölhető, ugyanolyan mintha -pass opciók nélkül keletkezett volna).
+  A második menetben keletkezik a tényleges 2 menetes DivX, az ideiglenes
+  file-ok adataiből. A keletkező file az egy menetesekhez képest sokkal jobb
+  minőséggel és kisebb mérettel bír. Ha most hallassz erről először, jobb ha
+  keresel a neten egy útmutatót.</P>
 
 <P>A következő példa egy DVD 2 menetes DivX4 AVI-ba történő enkódolását
 mutatja be. Csak két parancs szükséges :<BR>
-<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100
--o movie.avi -pass 1<BR>
-&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 -o movie.avi -pass 2</CODE></P>
+<CODE>&nbsp;&nbsp;&nbsp;&nbsp;rm frameno.avi</CODE> - töröld ezt a file-t,
+  ami egy esetleges előző 3 menetes enkódolásból származhat<BR>
+<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -divx4opts br=1100
+  -o movie.avi -pass 1<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -divx4opts br=1100 
+  -o movie.avi -pass 2</CODE></P>
+
+<P><U><B>3 menetes enkódolás :</B></U> ez egyfajta bővített kétmenetes
+  enkódolás. A különbség abban áll hogy itt az audio enkódolása külön
+  menetben történik, ezáltal lehetővé válik annak megbecslése hogy az adott
+  filmet milyen bitrátával kell tömöríteni hogy ráférjen egy 650, 700 vagy
+  800Mb-os CD-re, és ezt a <B>MEncoder</B> ki is számolja. Továbbá, ilyenkor
+  az audio csak egyszer kerül enkódolásra, ellentétben a 2 menetes móddal.
+  A használata a következő :</P>
+
+<P>
+  <TABLE>
+  <TR>   
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <CODE>rm frameno.avi</CODE></TD>
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <B>egy esetleges előző 3 menetes enkódolásból származó file törlése,
+      mely konfliktolhat a most következővel</B></TD>
+  </TR>
+  <TR> 
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <CODE>mencoder &lt;file/DVD&gt; -ovc frameno -o
+        frameno.avi</CODE></TD>
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <B><U>Első menet</U> : egy csak audiot tartalmazó AVI file jön létre,
+      ami a kért formátumban tartalmazza az audio streamet. Ha akarod
+      használhatod a <CODE>-lameopts</CODE> opciót. Ha ez egy hosszabb film,
+      e menet végén a MEncoder kiírja hogy mekkora bitrate-tel tömöríts
+      a következő menetekben hogy a film ráférjen egy 650, 700 vagy 800Mb-os
+      CD-re.</B></TD>
+  </TR>
+  <TR> 
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <CODE>mencoder &lt;file/DVD&gt; -oac copy -pass 1
+        -divx4opts br=&lt;bitrate&gt;</CODE></TD>
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <B><U>Második menet</U> : alias a DivX4 video enkódolás első menete.
+      Opcionálisan megadhatod azt a bitrate-et amit a MEncoder az előző
+      menet végén kiírt, lásd feljebb.</B></TD>
+  </TR>
+  <TR> 
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <CODE>mencoder &lt;file/DVD&gt; -oac copy -pass 2
+        -divx4opts br=&lt;bitrate&gt;</CODE></TD>
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <B><U>Harmadik menet</U> : alias a DivX4 video enkódolás második menete.
+      Opcionálisan megadhatod azt a bitrate-et amit a MEncoder az előző
+      menet végén kiírt, lásd feljebb. Ebben a menetben a
+      <CODE>frameno.avi</CODE>-ban levő audio belekerül a célfileba..
+      és kész is az egész!</B></TD>
+  </TR>
+  </TABLE>
+</P>
+
+<P><B>Példa a 3 menetes enkódolásra :</B></P>
+
+<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;rm frameno.avi</CODE> - esetlegesen egy előző
+  enkódolásbol származó file törlése (bezavar a most következőnek)<BR>
+<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc frameno
+  -o frameno.avi<BR>
+<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2
+  -divx4opts br=1100 -oac copy -o movie.avi -pass 1<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -divx4opts
+  br=1100 -oac copy -o movie.avi -pass 2</CODE>
+</P>
+
 
 <P><B><A NAME=2.4.3.2>2.4.3.2.  Átméretezés</B></P>
 
diff --git a/DOCS/documentation.html b/DOCS/documentation.html
index f3aa502518..a98684a3b2 100644
--- a/DOCS/documentation.html
+++ b/DOCS/documentation.html
@@ -140,7 +140,7 @@
         <LI><A HREF="encoding.html#2.4.3">2.4.3 Features</A></LI>
           <UL>
             <LI><A HREF="encoding.html#2.4.3">2.4.3 Summary</A></LI>
-            <LI><A HREF="encoding.html#2.4.3.1">2.4.3.1 Encoding 2-pass DivX4</A></LI>
+            <LI><A HREF="encoding.html#2.4.3.1">2.4.3.1 Encoding 2 or 3-pass DivX4</A></LI>
             <LI><A HREF="encoding.html#2.4.3.2">2.4.3.2 Rescaling movies</A></LI>
             <LI><A HREF="encoding.html#2.4.3.3">2.4.3.3 Streamcopy</A></LI>
             <LI><A HREF="encoding.html#2.4.3.4">2.4.3.4 Fixing AVIs with broken index</A></LI>
diff --git a/DOCS/encoding.html b/DOCS/encoding.html
index c5885aec35..65a13c2ae7 100644
--- a/DOCS/encoding.html
+++ b/DOCS/encoding.html
@@ -9,11 +9,10 @@
 
 <P><B>MEncoder</B> (<B>MPlayer</B>'s Movie Encoder) is a simple movie encoder,
 designed to encode MPlayer-playable movies
-(<B>AVI/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET</B>) to other MPlayer-playable formats (see
-below). Currently it's in beta stage, and encodes only to <B>DivX4</B> (1 or 2
-passes) video, <B>PCM</B>/<B>MP3</B>/<B>VBRMP3</B> audio. Also has stream
-copying abilities. In the future, there will be cropping, resizing filters, and
-other interesting stuff.</P>
+(<B>AVI/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET</B>) to other MPlayer-playable
+formats (see below). It can encode with various codecs, like <B>DivX4</B> (1 or
+2 passes), libavcodec, <B>PCM</B>/<B>MP3</B>/<B>VBRMP3</B> audio. Also has
+stream copying and video resizing abilities.</P>
 
 <P><B><A NAME=2.4.2>2.4.2.  Compiling</B></P>
 
@@ -54,7 +53,7 @@ other interesting stuff.</P>
       <A HREF=codecs.html#2.2.1.2>libavcodec</A></LI>
     <LI>video encoding from <B>V4L compatible TV tuners</B></LI>
     <LI>encoding/multiplexing to interleaved AVI files with proper index</LI>
-    <LI>1 or 2 pass <B>DivX4</B> video</LI>
+    <LI>1, 2 or 3 pass <B>DivX4</B> video</LI>
     <LI><B>VBR</B> MP3 audio - <B>IMPORTANT NOTE</B> : VBR MP3 audio doesn't
       always play nicely on windows players! If you intend to encode AVIs
       mainly for windows, encode with CBR!</LI>
@@ -77,9 +76,9 @@ other interesting stuff.</P>
   </UL>
 </P>
 
-<P><B><A NAME=2.4.3.1>2.4.3.1.  Encoding 2-pass DivX4</B></P>
+<P><B><A NAME=2.4.3.1>2.4.3.1.  Encoding 2 or 3-pass DivX4</B></P>
 
-<P>The name comes from the fact that this method encodes the file <I>twice</I>.
+<P><U><B>2-pass encoding :</B></U> the name comes from the fact that this method encodes the file <I>twice</I>.
 The first encoding (dubbed <I>pass</I>) creates some temporary files (*.log) with a
 size of few megabytes, do not delete them yet (you can delete the AVI). In the second pass, the
 2-pass output file is created, using the bitrate data from the temporary files. The resulting
@@ -88,9 +87,71 @@ about this, you should consult some guides available on the Net.</P>
 
 <P>This example shows how to encode a DVD to a 2-pass DivX4 AVI. Just two
 commands are needed :<BR>
-<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100
+<CODE>&nbsp;&nbsp;&nbsp;&nbsp;rm frameno.avi</CODE> - remove this file, which
+  can come from a previous 3-pass encoding (it interferes with current one)<BR>
+<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -divx4opts br=1100
 -o movie.avi -pass 1<BR>
-&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 -o movie.avi -pass 2</CODE></P>
+&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -divx4opts br=1100 -o movie.avi -pass 2</CODE></P>
+
+<P><U><B>3-pass encoding :</B></U> this is an extension of 2-pass encoding,
+  where the audio encoding takes place in a separate pass. This method enables
+  estimation of recommended video bitrate in order to fit on a CD. Also, the
+  audio is encoded only once, unlike in 2-pass mode. The schematics :</P>
+
+<P>
+  <TABLE>
+  <TR>
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <CODE>rm frameno.avi</CODE></TD>
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <B>remove conflicting temporary file</B></TD>
+  </TR>
+  <TR>
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <CODE>mencoder &lt;file/DVD&gt; -ovc frameno -o
+        frameno.avi</CODE></TD>
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <B><U>First pass</U> : an audio-only avi file will be created, containing
+      ONLY the requested audio stream. Don't forget <CODE>-lameopts</CODE>, if
+      you need to set it. If you were encoding a long movie, MEncoder prints
+      the recommended bitrate values for 650Mb, 700Mb, and 800Mb destination
+      sizes, after this pass finishes.</B></TD>
+  </TR>
+  <TR>
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <CODE>mencoder &lt;file/DVD&gt; -oac copy -pass 1
+        -divx4opts br=&lt;bitrate&gt;</CODE></TD>
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <B><U>Second pass</U> : alias the first pass of DivX4 video encoding. 
+      Optionally specify the video bitrate MEncoder printed at the end of the
+      previous pass.</B></TD>
+  </TR>
+  <TR>
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <CODE>mencoder &lt;file/DVD&gt; -oac copy -pass 2
+        -divx4opts br=&lt;bitrate&gt;</CODE></TD>
+    <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+      <B><U>Third pass</U> : alias the second pass of DivX4 video encoding. 
+      Optionally specify the video bitrate MEncoder printed at the end of the
+      previous pass. In this pass, audio from <CODE>frameno.avi</CODE> will be
+      inserted into the destination file.. and it's all ready!</B></TD>
+  </TR>
+  </TABLE>
+</P>
+
+<P><B>Example for 3-pass encoding :</B></P>
+
+<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;rm frameno.avi</CODE> - remove this file,
+  which can come from a previous 3-pass encoding (it interferes with current
+  one)<BR>
+<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc frameno
+  -o frameno.avi<BR>
+<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2
+  -divx4opts br=1100 -oac copy -o movie.avi -pass 1<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2
+  -divx4opts br=1100 -oac copy -o movie.avi -pass 2</CODE>
+</P>
+
 
 <P><B><A NAME=2.4.3.2>2.4.3.2.  Rescaling movies</B></P>