Mercurial > mplayer.hg

changeset 2868:4a1802c5bbee

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
*** empty log message ***
author gabucino
date Tue, 13 Nov 2001 17:11:26 +0000
parents a9a63f7e9ddc
children 107d9e9e5bd1
files DOCS/documentation.html DOCS/encoding.html DOCS/mencoder.1
diffstat 3 files changed, 119 insertions(+), 11 deletions(-) [+]
line wrap: on
line diff
--- a/DOCS/documentation.html	Tue Nov 13 16:19:48 2001 +0000
+++ b/DOCS/documentation.html	Tue Nov 13 17:11:26 2001 +0000
@@ -182,7 +182,22 @@
 
 <P><B>MPlayer</B> is basically GPL, but contains some non-GPL code which is not
 allowed to be distributed in binary form, and also contains the OpenDivX
-library which has special license.</P>
+library which has special license. We are still developing towards GPL.</P>
+
+<P><B><I>Important notice</I></B></P>
+
+<P><B>MPlayer CAN'T BE DISTRIBUTED IN BINARY FORM !</B> Due to the fact, that
+EVERY optimization flag is determined during compile time.</P>
+
+<P>An optimized, compiled <B>MPlayer</B> is <U>very unlikely</U> to work on another computer.<BR>
+An unoptimized, compiled <B>MPlayer</B> may work, but will be <U>sluggish</U>.</P>
+
+<P>If you are <B>using</B> a self-made binary package, that's ok.<BR>
+If you are <B>distributing</B> a binary package, that's <B>forbidden</B>!<BR>
+If you have <B>downloaded and using</B> a binary package made by someone else,
+then please inform us.</P>
+
+<P><B><I>Important notice ends</I></B></P>
 
 <P>I didn't write any codecs, just some players. I spent
 a lot of time finding the best way to parse bad damaged input files
@@ -315,6 +330,9 @@
 
 <LI>If you want to play <B>3ivx</B> movies, check the <A HREF=codecs.html#2.2.1.3>
 XAnim codecs section</A>.</LI>
+
+<LI>If you have a V4L compatible <B>TV tuner</B> card, and wish to watch/grab and
+encode movies with <B>MPlayer</B>, read the <A HREF=#2.5>TV input</A> section.</LI>
 </UL>
 
 <P>Then build <B>MPlayer</B>:</P>
@@ -460,11 +478,13 @@
 <P><A NAME=2.4>2.4. <A HREF="encoding.html">MEncoder - An All-Purpose Encoder</P>
 
 
-<P><A NAME=2.5><B>2.4. TV input</B></P>
+<P><A NAME=2.5><B>2.5. TV input</B></P>
 
 <P>This section is about how to enable <B>watching/grabbing from V4L compatible
 TV tuner</B>.</P>
 
+<P><B><I>Compilation</I></B></P>
+
 <P>
 <UL>
   <LI>first, you have to add the <CODE>--enable-tv</CODE> flag to <CODE>./configure</CODE>,
@@ -475,7 +495,7 @@
 </P>
 
 <P><B><I>Available options</I></B><BR>
-<TABLE>
+<TABLE BORDER=0>
 <TR>
   <TD>&nbsp;&nbsp;</TD>
   <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><I>on</I></TD>
@@ -484,7 +504,7 @@
   input</TD>
 </TR>
 <TR>
-  <TD></TD>
+  <TD>&nbsp;&nbsp;</TD>
   <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><I>driver</I></TD>
   <TD></TD>
   <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
@@ -554,9 +574,10 @@
 
 <P>
 Dummy output, to AAlib :)<BR>
-<CODE>mplayer -tv on:driver=dummy:width=640:height=480</CODE><BR>
+<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -tv on:driver=dummy:width=640:height=480 -vo aa</CODE><BR>
+<BR>
 Input from standard V4L<BR>
-<CODE>mplayer -tv on:driver=v4l:width=800:height=600:device=/dev/video0:input=television:outfmt=yv12 -vc rawyv12 -vo xv</CODE><BR>
+<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -tv on:driver=v4l:width=800:height=600:device=/dev/video0:input=television:outfmt=yv12 -vc rawyv12 -vo xv</CODE><BR>
 </P>
 
 
@@ -923,6 +944,7 @@
   <LI>vo_ggi output driver in libvo (www.ggi-project.org)</LI>
   <LI>xanim codecs support (incomplete yet!)</LI>
   <LI>VIVO files support</LI>
+  <LI>TV grabbing support</LI>
 </UL></LI>
 
 <LI><B><A HREF="mailto:asackerm@stud.informatik.uni-erlangen.de">Andreas Ackermann (Acki)</A></B>
--- a/DOCS/encoding.html	Tue Nov 13 16:19:48 2001 +0000
+++ b/DOCS/encoding.html	Tue Nov 13 17:11:26 2001 +0000
@@ -35,7 +35,8 @@
 
 <P><B><I>MEncoder features</I></B> :
   <UL>
-    <LI>encoding from the wide range of fileformats and decoders of <B>MPlayer</B>
+    <LI>encoding from the wide range of fileformats and decoders of <B>MPlayer</B></LI>
+    <LI>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><B>VBR</B> MP3 audio</LI>
@@ -67,9 +68,84 @@
 
 <P>This example shows how to encode a DVD to a 2-pass DivX4 AVI. Just two
 commands are needed :<BR>
-<CODE>&nbsp;&nbsp;mplayer -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100
+<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100
 -o movie.avi -pass 1<BR>
-&nbsp;&nbsp;mplayer -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 -o movie.avi -pass 2</CODE></P>
+&nbsp;&nbsp;&nbsp;&nbsp;mplayer -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 -o movie.avi -pass 2</CODE></P>
+
+<P><B><I>Syntax</I></B></P>
+
+<P>&nbsp;&nbsp;<CODE>mencoder [options] &lt;input file&gt; [options] ...</P>
+
+<P><B><I>Available options</I></B></P>
+
+<P>NOTE : for all available options, <B>read the manpage !</B></P>
+
+<TABLE BORDER=0>
+<TR>
+  <TD>&nbsp;&nbsp;</TD>
+  <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+    <I>-o</I> filename</TD>
+  <TD>&nbsp;&nbsp;</TD>
+  <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+    specify output filename
+  </TD>
+</TR>
+<TR>
+  <TD>&nbsp;&nbsp;</TD>
+  <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+    <I>-ovc</I> codecname</TD>
+  <TD>&nbsp;&nbsp;</TD>
+  <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+    Encode  with  the given codec (codec names are from codecs.conf). Examples:<BR>
+    &nbsp;&nbsp;<B>help</B> - get list of available codecs<BR>
+    &nbsp;&nbsp;<B>copy</B> - no encoding, just copy the stream (only from AVI/ASF now)<BR>
+    &nbsp;&nbsp;<B>divx4</B> - encode to DivX4<BR>
+  </TD>
+</TR>
+<TR>
+  <TD>&nbsp;&nbsp;</TD>
+  <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+    <I>-oac</I> codecname</TD>
+  <TD>&nbsp;&nbsp;</TD>
+  <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+    Encode  with  the given codec (codec names are from codecs.conf). Examples:<BR>
+    &nbsp;&nbsp;<B>help</B> - get list of available codecs<BR>
+    &nbsp;&nbsp;<B>copy</B> - no encoding, just copy the stream (only from AVI/ASF now)<BR>
+    &nbsp;&nbsp;<B>pcm</B> - encode to uncompressed PCM<BR>
+    &nbsp;&nbsp;<B>mp3lame</B> - encode to MP3 (using Lame)<BR>
+  </TD>
+</TR>
+<TR>
+  <TD>&nbsp;&nbsp;</TD>
+  <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+    <I>-divx4opts</I></TD>
+  <TD>&nbsp;&nbsp;</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>
+  </TD>
+</TR>
+<TR>
+  <TD>&nbsp;&nbsp;</TD>
+  <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+    <I>-lameopts</I></TD>
+  <TD>&nbsp;&nbsp;</TD>
+  <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+    If encoding to MP3 with libmp3lame, you can specify its parameters here, like:<BR>
+    &nbsp;&nbsp;<CODE>-lameopts q=3</CODE><BR>
+    &nbsp;&nbsp;<CODE>-lameopts br=192:cbr</CODE><BR>
+    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>
+  </TD>
+</TR>
+</TABLE>
 
 <P><B><I>Examples</I></B></P>
 
--- a/DOCS/mencoder.1	Tue Nov 13 16:19:48 2001 +0000
+++ b/DOCS/mencoder.1	Tue Nov 13 17:11:26 2001 +0000
@@ -36,13 +36,21 @@
 .PP
 .SH DESCRIPTION
 .I mencoder
-Encoder.
+MEncoder (MPlayer's Movie Encoder) is a simple movie encoder, designed to
+encode MPlayer-playable movies (AVI/DVD/VCD/VOB/MPG/MOV/VIV/NET) to other
+MPlayer-playable formats (see below). Currently it's in beta stage, and encodes
+only to DivX4 (1 or 2 passes) video, PCM/MP3/VBRMP3 audio. Also has stream
+copying abilities. In the future, there will be cropping, resizing filters, and
+other interesting stuff.
 .LP
 .SH "GENERAL OPTIONS"
 .TP
 .I NOTE
 Every "flag" option has "noflag" pair, e.g. -flag opposite is -noflag
 .TP
+.I NOTE
+CHECK THE HTML DOCUMENTATION TOO !
+.TP
 .B \-vcd <track number>
 Encode the specified VCD track.
 .TP
@@ -72,7 +80,7 @@
 If source media contains multiple video streams, encode the specified one.
 .TP
 .B \-pp <value>
-Apply a postprocess filter to enhance image quality. (values?)
+Apply a postprocess filter to enhance image quality. (values TODO)
 .TP
 .B \-vc <codec name>
 Use specified codec (according to codecs.conf) for decoding input video
@@ -152,8 +160,10 @@
     help         get help
     br=XXX       specify bitrate in
                  kbit <0-1024>
+                 (only for CBR)
     q=XXX        Quality
                  (0-highest, 9-fastest)
+                 (for VBR)
     vbr=XXX      variable bitrate method
                    0=cbr
                    1=mt