From 318f5e60d412add2ab4d6b1b8045ba0e20aa437c Mon Sep 17 00:00:00 2001
From: gabucino
Date: Tue, 13 Nov 2001 17:11:26 +0000
Subject: [PATCH] *** empty log message ***
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@2869 b3059339-0415-0410-9bf9-f77b7e298cf2
---
DOCS/documentation.html | 34 ++++++++++++++---
DOCS/encoding.html | 82 +++++++++++++++++++++++++++++++++++++++--
DOCS/mencoder.1 | 14 ++++++-
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?
MPlayer 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.
+library which has special license. We are still developing towards GPL.
+
+Important notice
+
+MPlayer CAN'T BE DISTRIBUTED IN BINARY FORM ! Due to the fact, that
+EVERY optimization flag is determined during compile time.
+
+An optimized, compiled MPlayer is very unlikely to work on another computer.
+An unoptimized, compiled MPlayer may work, but will be sluggish.
+
+If you are using a self-made binary package, that's ok.
+If you are distributing a binary package, that's forbidden!
+If you have downloaded and using a binary package made by someone else,
+then please inform us.
+
+Important notice ends
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 MEncoder section .
If you want to play 3ivx movies, check the
XAnim codecs section.
+
+If you have a V4L compatible TV tuner card, and wish to watch/grab and
+encode movies with MPlayer, read the TV input section.
Then build MPlayer:
@@ -460,11 +478,13 @@ Now you have to see a timer at the upper left corner of the movie
2.4. MEncoder - An All-Purpose Encoder
-2.4. TV input
+2.5. TV input
This section is about how to enable watching/grabbing from V4L compatible
TV tuner.
+Compilation
+
- first, you have to add the
--enable-tv
flag to ./configure
,
@@ -475,7 +495,7 @@ TV tuner.
Available options
-
+
|
on |
@@ -484,7 +504,7 @@ TV tuner.
input
- |
+ |
driver |
|
@@ -554,9 +574,10 @@ TV tuner.
Dummy output, to AAlib :)
-mplayer -tv on:driver=dummy:width=640:height=480
+ mplayer -tv on:driver=dummy:width=640:height=480 -vo aa
+
Input from standard V4L
-mplayer -tv on:driver=v4l:width=800:height=600:device=/dev/video0:input=television:outfmt=yv12 -vc rawyv12 -vo xv
+ mplayer -tv on:driver=v4l:width=800:height=600:device=/dev/video0:input=television:outfmt=yv12 -vc rawyv12 -vo xv
@@ -923,6 +944,7 @@ Anyone has closer info?
- vo_ggi output driver in libvo (www.ggi-project.org)
- xanim codecs support (incomplete yet!)
- VIVO files support
+ - TV grabbing support
- Andreas Ackermann (Acki)
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.
MEncoder features :
- - encoding from the wide range of fileformats and decoders of MPlayer
+
- encoding from the wide range of fileformats and decoders of MPlayer
+ - encoding from V4L compatible TV tuners
- encoding/multiplexing to interleaved AVI files with proper index
- 1 or 2 pass DivX4 video
- VBR MP3 audio
@@ -67,9 +68,84 @@ should consult some guides available on the Net.
This example shows how to encode a DVD to a 2-pass DivX4 AVI. Just two
commands are needed :
- mplayer -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100
+ mplayer -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100
-o movie.avi -pass 1
- mplayer -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 -o movie.avi -pass 2
+ mplayer -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 -o movie.avi -pass 2
+
+Syntax
+
+ mencoder [options] <input file> [options] ...
+
+Available options
+
+NOTE : for all available options, read the manpage !
+
+
+
+ |
+
+ -o filename |
+ |
+
+ specify output filename
+ |
+
+
+ |
+
+ -ovc codecname |
+ |
+
+ Encode with the given codec (codec names are from codecs.conf). Examples:
+ help - get list of available codecs
+ copy - no encoding, just copy the stream (only from AVI/ASF now)
+ divx4 - encode to DivX4
+ |
+
+
+ |
+
+ -oac codecname |
+ |
+
+ Encode with the given codec (codec names are from codecs.conf). Examples:
+ help - get list of available codecs
+ copy - no encoding, just copy the stream (only from AVI/ASF now)
+ pcm - encode to uncompressed PCM
+ mp3lame - encode to MP3 (using Lame)
+ |
+
+
+ |
+
+ -divx4opts |
+ |
+
+ If encoding to DivX4, you can specify its parameters here, like:
+ -divx4opts br=1800:deinterlace:key=250
+ Common options: (for full list, check the manpage!)
+ help - get help
+ br=XXX - specify bitrate in kbit <4-16000> or bit <16001-24000000>
+ q=XXXX - quality (1-fastest, 5-best - default 5)
+ |
+
+
+ |
+
+ -lameopts |
+ |
+
+ If encoding to MP3 with libmp3lame, you can specify its parameters here, like:
+ -lameopts q=3
+ -lameopts br=192:cbr
+ Common options: (for full list, check the manpage!)
+ help - get help
+ cbr - select CBR MP3 (default is VBR)
+ br=XXX - specify bitrate in kbit <0-1024> (this is for CBR only!)
+ q=XXXX - quality (0-highest, 9-fastest - default 0) (this is for VBR only!)
+ |
+
+
Examples
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 |