changeset 4919:40b48a0a780e

documented Multifile JPEG/PNG input (-mf)
author gabucino
date Sun, 03 Mar 2002 10:54:03 +0000
parents 8e6ccd3e5325
children 089485d69edd
files DOCS/Hungarian/documentation.html DOCS/Hungarian/encoding.html DOCS/documentation.html DOCS/encoding.html DOCS/mencoder.1
diffstat 5 files changed, 134 insertions(+), 9 deletions(-) [+]
line wrap: on
line diff
--- a/DOCS/Hungarian/documentation.html	Sun Mar 03 09:01:47 2002 +0000
+++ b/DOCS/Hungarian/documentation.html	Sun Mar 03 10:54:03 2002 +0000
@@ -151,6 +151,7 @@
             <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>
             <LI><A HREF="encoding.html#2.4.3.5">2.4.3.5 Enkódolás a libavcodec codec-ekkel</A></LI>
+            <LI><A HREF="encoding.html#2.4.3.6">2.4.3.6 Enkódolás több bemeneti file-ból (JPEG, PNG)</A></LI>  
           </UL>
         <LI><A HREF="encoding.html#2.4.4">2.4.4 Szintaxis</A></LI>
         <LI><A HREF="encoding.html#2.4.5">2.4.5 Opciók</A></LI>
--- a/DOCS/Hungarian/encoding.html	Sun Mar 03 09:01:47 2002 +0000
+++ b/DOCS/Hungarian/encoding.html	Sun Mar 03 10:54:03 2002 +0000
@@ -238,6 +238,57 @@
   <CODE>vcodec</CODE> opciónak, pl : <CODE>-lavcopts vcodec=msmpeg4</CODE></P>
 
 
+<P><B><A NAME=2.4.3.6>2.4.3.6.  Enkódolás több bemeneti file-ból (JPEG, PNG)</B></P>
+
+<P>A <B>MEncoder</B> képes több JPEG vagy PNG file-ból filmet létrehozni.
+  Egyszerű framecopy használatával pedig MJPEG (Motion JPEG) vagy MPNG
+  (Motion PNG) filmek hozhatók létre.</P>
+
+<P><B><I>A folyamat magyarázata</I></B></P>
+
+<P>Először a <B>MEncoder</B> <I>dekódolja</I> a bemeneti fileokat egy
+  rendelkezésre álló és szabadonválasztott MJPEG dekóderrel (PNG-k dekódolása
+  esetén csak a beépitett PNG dekóder használható). Alapértelmezésben az
+  <CODE>ffmjpeg</CODE> codec-et próbálja használni, így ajánlott libavcodec-kel
+  fordítani. Ennek a codecnek a legnagyobb hátránya hogy bizonyos JPEG
+  fileokat nem tud kezelni (ilyenkor zöld kimenet látható). Ilyenkor különböző
+  képkonvertáló programokkal előtte konvertáld át ezeket a <B>MEncoder</B>
+  által is emészthető formába.<BR>
+  Választhatsz más dekódert is, például az <CODE>mcmjpg32.dll</CODE>-t
+  (MainConcept Motion JPEG). Ilyenkor meg kell nézni a <CODE>codecs.conf</CODE>
+  fileban hogy az adott codecre milyen névvel lehet hivatkozni (<CODE>videocodec</CODE>
+  sor), és utána ezt a nevet a <CODE>-vc</CODE> opció után írni. A fenti
+  példát véve: <CODE>-vc mjpeg</CODE>
+</P>
+
+<P>A <B>MEncoder</B> ezután a kiválasztott kimeneti codecnek adja a
+  dekódolt képet (pl DivX4, Xvid, ffmpeg msmpeg4, stb). Vigyázat: a PNG
+  dekóder jelenleg csak RGB formátumú képek kiadására képes, így nem
+  használható olyan codecekkel amelyek YUV formátumot várnak. Ilyen
+  például a DivX4, vagy az ffmpeg-beli msmpeg4.</P>
+
+<P><B><I>Példák</I></B></P>
+
+<P>Az <CODE>-mf</CODE> opció magyarázata a lenti összefoglaló
+  <A HREF=#2.4.5>Opciók</A> fejezetben, illetve a manpage-ben található.</P>
+
+<P><I>DivX4 film létrehozása az aktuális könyvtárban található összes JPEG fileból :</I><BR>
+  &nbsp;&nbsp;<CODE>mencoder \*.jpg -mf on:w=800:h=600:fps=25 -ovc divx4 -o
+  kimenet.avi</CODE></P>
+
+<P><I>MJPEG (Motion JPEG) film létrehozása az aktuális könyvtárban található összes JPEG fileból :</I><BR>
+  &nbsp;&nbsp;<CODE>mencoder \*.jpg -mf on:w=800:h=600:fps=25 -ovc copy
+  -o kimenet.avi</CODE></P>
+
+<P><I>Tömörítetlen film létrehozása az aktuális könyvtárban található összes PNG fileból :</I><BR>
+  &nbsp;&nbsp;<CODE>mencoder \*.png -mf on:w=800:h=600:fps=25:type=png -ovc raw -o
+  kimenet.avi</CODE></P>
+
+<P><I>MPNG (Motion PNG) film létrehozása az aktuális könyvtárban található összes PNG fileból :</I><BR>
+  &nbsp;&nbsp;<CODE>mencoder \*.png -mf on:w=800:h=600:fps=25:type=png -ovc copy
+  -o kimenet.avi</CODE></P>
+
+
 <P><B><A NAME=2.4.4>2.4.4.  Szintaxis</B></P>
 
 <P>&nbsp;&nbsp;<CODE>mencoder [opciók] [bemeneti file] [opciók] ...</P>
--- a/DOCS/documentation.html	Sun Mar 03 09:01:47 2002 +0000
+++ b/DOCS/documentation.html	Sun Mar 03 10:54:03 2002 +0000
@@ -151,6 +151,7 @@
             <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>
             <LI><A HREF="encoding.html#2.4.3.5">2.4.3.5 Encoding with the libavcodec codec family</A></LI>
+            <LI><A HREF="encoding.html#2.4.3.6">2.4.3.6 Encoding from multiple input image files (MJPEG/MPNG)</A></LI>
           </UL>
         <LI><A HREF="encoding.html#2.4.4">2.4.4 Syntax</A></LI>
         <LI><A HREF="encoding.html#2.4.5">2.4.5 Available options</A></LI>
--- a/DOCS/encoding.html	Sun Mar 03 09:01:47 2002 +0000
+++ b/DOCS/encoding.html	Sun Mar 03 10:54:03 2002 +0000
@@ -228,6 +228,54 @@
   <CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -o title2.avi -ovc lavc -lavcopts vcodec=mjpeg</CODE></P>
 
 
+<P><B><A NAME=2.4.3.6>2.4.3.6.  Encoding from multiple input image files (JPEGs or PNGs)</B></P>
+
+<P><B>MEncoder</B> is capable of creating movies from one or more JPEG or PNG
+  files. With simple framecopy it can create MJPEG (Motion JPEG) or MPNG
+  (Motion PNG) files.</P>
+
+<P><B><I>Explanation of the process</I></B></P>
+
+<P><B>MEncoder</B> <I>decodes</I> the input image(s) with an available MJPEG
+  video codec (when decoding PNGs, it will use the internal PNG decoder). By
+  default it uses <CODE>ffmjpeg</CODE>, so you have to compile with libavcodec
+  support (which is recommended anyways). Its disadvantage is that it can't
+  handle some JPEG types (green image will be encoded for these). Use some
+  external utility to convert those images into edible format.<BR> You can
+  freely choose any other MJPEG decoder, like <CODE>mcmjpg32.dll</CODE>
+  (MainConcept Motion JPEG) if installed, and after checking
+  <CODE>codecs.conf</CODE> and checking the <CODE>videocodec</CODE> line which
+  refers to this file, you'll learn you have to use the <CODE>-vc mjpeg</CODE>
+  option for it.
+</P>
+
+<P><B>MEncoder</B> then feeds the decoded image to the chosen video compressor
+  (DivX4, Xvid, ffmpeg msmpeg4, etc...). Watch for the PNG decoder, as
+  currently it can output only to RGB formats, thus can't be used with codecs
+  that require YUV as input, like DivX4 or ffmpeg's msmpeg4.</P>
+
+<P><B><I>Examples</I></B></P>
+
+<P>The explanation of the <CODE>-mf</CODE> option can be found below in the
+  global <A HREF=#2.4.5>Options</A> section and in the manpage.</P>
+
+<P><I>Creating a DivX4 file from all the JPEG files in the current dir :</I><BR>
+  &nbsp;&nbsp;<CODE>mencoder \*.jpg -mf on:w=800:h=600:fps=25 -ovc divx4 -o
+  output.avi</CODE></P>
+
+<P><I>Creating a Motion JPEG (MJPEG) file from all the JPEG files in the current dir :</I><BR>
+  &nbsp;&nbsp;<CODE>mencoder \*.jpg -mf on:w=800:h=600:fps=25 -ovc copy
+  -o output.avi</CODE></P>
+
+<P><I>Creating an uncompressed file from all the PNG files in the current dir :</I><BR>
+  &nbsp;&nbsp;<CODE>mencoder \*.png -mf on:w=800:h=600:fps=25:type=png -ovc raw -o
+  output.avi</CODE></P>
+
+<P><I>Creating a Motion PNG (MPNG) file from all the PNG files in the current dir :</I><BR>
+  &nbsp;&nbsp;<CODE>mencoder \*.png -mf on:w=800:h=600:fps=25:type=png -ovc copy
+  -o output.avi</CODE></P>
+
+
 <P><B><A NAME=2.4.4>2.4.4.  Syntax</B></P>
 
 <P>&nbsp;&nbsp;<CODE>mencoder [options] [input file] [options] ...</P>
@@ -318,15 +366,28 @@
 </TR>
 <TR>
   <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+    <I>-mf</I> multifile options</TD>
+  <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+    Used when encoding from multiple JPEG files. Its sub-options are:<BR>
+    &nbsp;&nbsp;<B>on</B> - turns on multifile support<BR>
+    &nbsp;&nbsp;<B>w</B>=&lt;value&gt; - width of the output file<BR>
+    &nbsp;&nbsp;<B>h</B>=&lt;value&gt; - height of the output file<BR>
+    &nbsp;&nbsp;<B>fps</B>=&lt;value&gt; - fps of the output file<BR>
+    &nbsp;&nbsp;<B>type</B>=&lt;value&gt; - type of input files (available types : <CODE>jpeg</CODE>, <CODE>png</CODE>)<BR>
+  </TD>
+</TR>
+
+<TR>
+  <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
     <I>-divx4opts</I></TD>
   <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
     If encoding to DivX4, you can specify its parameters here, like:<BR>
     &nbsp;&nbsp;<CODE>-divx4opts br=1800:deinterlace:key=250</CODE><BR>
     Common options: <B>(for full list, check the manpage!)</B><BR>
     &nbsp;&nbsp;<B>help</B> - get help<BR>
-    &nbsp;&nbsp;<B>br</B>=XXX - specify bitrate in kbit &lt;4-16000&gt; or bit &lt;16001-24000000&gt;<BR>
-    &nbsp;&nbsp;<B>q</B>=XXXX - quality (1-fastest, 5-best - default 5)<BR>
-    &nbsp;&nbsp;<B>key</B>=XXXX - keyframe interval<BR>
+    &nbsp;&nbsp;<B>br</B>=&lt;value&gt; - specify bitrate in kbit &lt;4-16000&gt; or bit &lt;16001-24000000&gt;<BR>
+    &nbsp;&nbsp;<B>q</B>=&lt;value&gt; - quality (1-fastest, 5-best - default 5)<BR>
+    &nbsp;&nbsp;<B>key</B>=&lt;value&gt; - keyframe interval<BR>
   </TD>
 </TR>
 <TR>
@@ -337,10 +398,10 @@
     &nbsp;&nbsp;<CODE>-lavcopts vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250</CODE><BR>
     Common options: <B>(for full list, check the manpage!)</B><BR>
     &nbsp;&nbsp;<B>help</B> - get help<BR>
-    &nbsp;&nbsp;<B>vcodec</B>=XXX - select videocodec (for the full list, see the libavcodec section above)<BR>
-    &nbsp;&nbsp;<B>vbitrate</B>=XXX - specify bitrate in kbit &lt;4-16000&gt; or bit &lt;16001-24000000&gt;<BR>
+    &nbsp;&nbsp;<B>vcodec</B>=&lt;value&gt; - select videocodec (for the full list, see the libavcodec section above)<BR>
+    &nbsp;&nbsp;<B>vbitrate</B>=&lt;value&gt; - specify bitrate in kbit &lt;4-16000&gt; or bit &lt;16001-24000000&gt;<BR>
     &nbsp;&nbsp;<B>vhq</B> - high quality<BR>
-    &nbsp;&nbsp;<B>keyint</B>=XXX - keyframe interval<BR>
+    &nbsp;&nbsp;<B>keyint</B>=&lt;value&gt; - keyframe interval<BR>
   </TD>
 </TR>
 <TR>
@@ -353,8 +414,8 @@
     Common options: <B>(for full list, check the manpage!)</B><BR>
     &nbsp;&nbsp;<B>help</B> - get help<BR>
     &nbsp;&nbsp;<B>cbr</B> - select <B>CBR</B> MP3 (default is <B>VBR</B>)<BR>
-    &nbsp;&nbsp;<B>br</B>=XXX - specify bitrate in kbit &lt;0-1024&gt; (this is for <B>CBR</B> only!)<BR>
-    &nbsp;&nbsp;<B>q</B>=XXXX - quality (0-highest, 9-fastest - default 0) (this is for <B>VBR</B> only!)<BR>
+    &nbsp;&nbsp;<B>br</B>=&lt;value&gt; - specify bitrate in kbit &lt;0-1024&gt; (this is for <B>CBR</B> only!)<BR>
+    &nbsp;&nbsp;<B>q</B>=&lt;value&gt; - quality (0-highest, 9-fastest - default 0) (this is for <B>VBR</B> only!)<BR>
   </TD>
 </TR>
 </TABLE>
--- a/DOCS/mencoder.1	Sun Mar 03 09:01:47 2002 +0000
+++ b/DOCS/mencoder.1	Sun Mar 03 10:54:03 2002 +0000
@@ -26,6 +26,7 @@
 .RB [ \-ac3file\ <filename> ]
 .RB [ \-ovc\ <video\ codec\ name> ]
 .RB [ \-oac\ <audio\ codec\ name> ]
+.RB [ \-mf\ <multifile\ options> ]
 .RB [ \-divx4opts\ <codec\ options> ]
 .RB [ \-lavcopts\ <codec\ options> ]
 .RB [ \-lameopts\ <codec\ options> ]
@@ -40,7 +41,7 @@
 .RB [ \-ffourcc\ fourcc ]
 .RB [ \-ss\ <time> ]
 .RB [ \-endpos\ <time> ]
-.I - or file or device
+.I - or file or files specified with escaped wildcard or device
 .PP
 .SH DESCRIPTION
 .I mencoder
@@ -140,6 +141,16 @@
   -oac pcm       encode to uncompressed PCM
   -oac mp3lame   encode to MP3 (using Lame)
 .TP
+.B \-mf <multifile options>
+Used when encoding from multiple JPEG files.
+Its sub-options are:
+
+  on             turns on multifile support
+  w=<value>      width of the output file
+  h=<value>      height of the output file
+  fps=<value>    fps of the output file
+  type=<value>   type of input files (jpeg, png)
+.TP
 .B \-divx4opts
 If encoding to DivX4, you can specify its parameters here, like: