summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorgabucino <gabucino@b3059339-0415-0410-9bf9-f77b7e298cf2>2001-11-13 17:11:26 +0000
committergabucino <gabucino@b3059339-0415-0410-9bf9-f77b7e298cf2>2001-11-13 17:11:26 +0000
commit318f5e60d412add2ab4d6b1b8045ba0e20aa437c (patch)
tree80c8364b1e22226d46f4034c6b7cb7f2242b73ab /DOCS
parent90e7605dd8037aec5b6fa1964743fd08fc4867f7 (diff)
downloadmpv-318f5e60d412add2ab4d6b1b8045ba0e20aa437c.tar.bz2
mpv-318f5e60d412add2ab4d6b1b8045ba0e20aa437c.tar.xz
*** empty log message ***
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@2869 b3059339-0415-0410-9bf9-f77b7e298cf2
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/documentation.html34
-rw-r--r--DOCS/encoding.html82
-rw-r--r--DOCS/mencoder.114
3 files changed, 119 insertions, 11 deletions
diff --git a/DOCS/documentation.html b/DOCS/documentation.html
index 3422172d4b..805ed38183 100644
--- a/DOCS/documentation.html
+++ b/DOCS/documentation.html
@@ -182,7 +182,22 @@ cyrillic, korean fonts, and OSD?</P>
<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 @@ see the <A HREF="encoding.html#2.4">MEncoder section</A> .</LI>
<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 @@ Now you have to see a timer at the upper left corner of the movie
<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 @@ TV tuner</B>.</P>
</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 @@ TV tuner</B>.</P>
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 @@ TV tuner</B>.</P>
<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 @@ Anyone has closer info?</P>
<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>
diff --git a/DOCS/encoding.html b/DOCS/encoding.html
index a60c343609..a568fa244b 100644
--- a/DOCS/encoding.html
+++ b/DOCS/encoding.html
@@ -35,7 +35,8 @@ other interesting stuff.</P>
<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 @@ 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;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>
diff --git a/DOCS/mencoder.1 b/DOCS/mencoder.1
index 7a8f094f17..69f7b047e7 100644
--- a/DOCS/mencoder.1
+++ b/DOCS/mencoder.1
@@ -36,13 +36,21 @@ mencoder \- Movie Encoder for Linux
.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 @@ the specified one.
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 @@ Available options:
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