From 7bdbd38f2f7bec813aca8a345a7bccbfc87f2bf0 Mon Sep 17 00:00:00 2001
From: diego
tags around block elements, do not put block elements in inline elements,
some typos and cosmetic changes.
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@6437 b3059339-0415-0410-9bf9-f77b7e298cf2
---
DOCS/documentation.html | 1262 +++++++++++++++++++++------------------
1 file changed, 687 insertions(+), 575 deletions(-)
diff --git a/DOCS/documentation.html b/DOCS/documentation.html
index d18567621b..195f28dc5f 100644
--- a/DOCS/documentation.html
+++ b/DOCS/documentation.html
@@ -1,226 +1,250 @@
+
+
http://www.mplayerhq.hu
-[ English ]
+[ English ]
[ Hungarian ]
[ German ]
[ French ]
[ Polish ]
[ Italian ]
-
Table of Contents
-
- -
0. How to read this documentation
@@ -336,7 +359,7 @@ files or with audio/video sync. Most of them is unable to play both MPEG1, MPEG2 and AVI (DivX) files. Many players have image quality or speed problems too. So I've decided to write/modify one... -
Non-YUV cards
@@ -580,6 +603,8 @@ example to 352x288. If you don't have YUV accel, this latter method is the recommended one. Throughout MPlayer, this behaviour can be switched on by using the-vm
option and with
the following drivers :
+
+
SOUNDCARDS
FEATURES
usleep()
to tune
@@ -640,9 +663,11 @@ multiuser system! It's a clear way for everyone to gain root.Then build MPlayer:
-./configure ++ ./configure make - make install+ make install +
At this point, MPlayer is ready to use. The directory
$PREFIX/share/mplayer
contains the codecs.conf
@@ -666,12 +691,14 @@ their version matches. The configure.log usually tells you what is missing.
Though not mandatory, the fonts should be installed in order to gain OSD, and subtitle functionality. Download mp-arial-iso-8859-*.zip and/or optional (if exists) language updates. It's VERY RECOMMENDED to check -section 1.5 for details.
+section 1.5 for details. -mkdir ~/.mplayer/font +@@ -679,14 +706,13 @@ OSD, and subtitle functionality. Download mp-arial-iso-8859-*.zip and/or optiona+ mkdir ~/.mplayer/font cd ~/.mplayer/font unzip mp-arial-iso-8859-1.zip - ln -s ~/.mplayer/font/arial-24 font+ ln -s ~/.mplayer/font/arial-24 font +
The GUI needs GTK (it isn't GTK, but the panels are). The skins are stored
in PNG format, so gtk, libpng (and their devel stuff) has to be installed.
You can build it by specifying --enable-gui
during ./configure .
-Then, to turn on GUI mode, you either
+Then, to turn on GUI mode, you either
-gui
optiongui=yes
in your config fileln -s $PREFIX/bin/mplayer $PREFIX/bin/gmplayer
,
and call gmplayer
instead.
HINT: use the middle button (on 2 button mice press left and right simultaneously) for a popup GTK menu, with DVD playing option!
@@ -703,7 +729,7 @@ directive to use the skin in*/Skin/newskin
directory.
MPlayer can display subtitles along with movie files. Currently the following -formats are supported: +formats are supported:
VobSub subtitles
@@ -789,7 +814,7 @@ OSD is used to display current time, volume bar, seek bar etc.
INSTALLING OSD and SUB
You need an MPlayer font package to be able to use OSD/SUB feature. -There are many ways to get it: +There are many ways to get it:
After that, UNZIP the file you downloaded to ~/.mplayer
or
$PREFIX/share/mplayer
. Then rename or symlink one of them to
@@ -825,7 +850,7 @@ It's a complete tool to convert from TTF/Type1/etc font to mplayer font pkg.
~/.mplayer/font). Now you have to see a timer at the upper left corner
of the movie (switch it off with the "o" key).
OSD has 3 states: (switch with 'o')
+
OSD has 3 states: (switch with 'o')
2.3. Video & Audio output devices
+2.3.. Video & Audio output devices
-2.4. MEncoder - An All-Purpose Encoder
+2.4.. MEncoder - An All-Purpose Encoder
- + -2.5.1. Overview
+This section is about how to enable watching/grabbing from V4L compatible TV tuner.
@@ -862,9 +887,8 @@ TV tuner. tweaking/experimenting! -2.5.2. Compilation
+ -
./configure
will autodetect kernel headers
of v4l stuff, and the existence of /dev/video* entries. If they exist,
@@ -872,14 +896,13 @@ TV tuner.
Hint : are the colors messed up? Then your tuner can't display
in YV12 colorspace. Try I420 (you must use the -vc rawi420
option too!), or YUY2, UYVY, RGB32 (this one
with -vo sdl
) colorspaces.
You can specify these with the outfmt=YV12
option see below.
2.5.3. Available options
+
@@ -966,17 +989,16 @@ TV tuner. | available: us-bcast, us-cable, europe-west, europe-east, etc |
2.5.4. Keyboard control
+h or l | select previous/next channel | ||
n | change norm | ||
b | change channel list | ||
h or l | select previous/next channel | ||
n | change norm | ||
b | change channel list |
2.5.5. Examples
+
Dummy output, to AAlib :)
@@ -987,10 +1009,10 @@ Input from standard V4L
2.6. Video filters
+ -2.6.1. Overview
+Both MPlayer and MEncoder supports using a universal
video filter layer, which comprises of numerous plugins - listed and
@@ -1002,7 +1024,7 @@ Input from standard V4L
With this filter layer it's possible to perform fast image format conversion
between the various RGB and YUV when neccessary. This enables for example
playing RGB data on xv
and xmga
outputs, amongst
- others. (see the Scale filter)
The layer also does Direct Rendering between the plugins, to
maximize the speed.
@@ -1010,7 +1032,7 @@ Input from standard V4L
Note that the postprocessing code is now also a part of the layer. It will be explained below.
-2.6.2. Usage
+ mplayer/mencoder -vop filter1,filter2,filter3,...
mplayer -vop help
" command line.
-2.6.3. Crop
+Description:
@@ -1040,7 +1062,7 @@ Input from standard V4L -vop crop[=width:height:x:y]
2.6.4. Expand
+Description:
@@ -1056,7 +1078,7 @@ Input from standard V4L -vop expand[=width:height:x:y]
2.6.5. Fame/Lavc
+Description:
@@ -1070,7 +1092,7 @@ Input from standard V4L -vop lavc
2.6.6. Flip
+Description:
@@ -1082,7 +1104,7 @@ Input from standard V4L -vop flip
2.6.7. Format
+Description:
@@ -1096,7 +1118,7 @@ Input from standard V4Lformat
can be for example: rgb32, yuy2, etc...)
-2.6.8. Postprocess
+Description:
@@ -1109,7 +1131,7 @@ Input from standard V4L -vop pp[=postprocess options/keywords]
2.6.9. RGB2BGR
+Description:
@@ -1122,7 +1144,7 @@ Input from standard V4L -vop rgb2bgr[=swap]
2.6.10. Rotate
+Description:
@@ -1134,12 +1156,12 @@ Input from standard V4L -vop rotate[=x]
2.6.11. Scale
+Description:
Scales the image with the software scaler (slow). You can adjust the
- quality of the scaler with the -sws
option, see the manpage.
+ quality of the scaler with the -sws
option, see the man page.
Nice quality implies speed loss.
NOTE: calling this filter with no options means colorspace
@@ -1153,7 +1175,7 @@ Input from standard V4L
-vop scale[=width:height]
2.6.12. YUY2
+Description:
@@ -1164,7 +1186,7 @@ Input from standard V4L -vop yuy2
2.6.13. Mirror
+Description:
@@ -1175,7 +1197,7 @@ Input from standard V4L -vop mirror
2.6.14. DVBscale
+Description:
@@ -1186,7 +1208,7 @@ Input from standard V4L -vop dvbscale
2.6.15. Cropdetect
+Description:
@@ -1211,24 +1233,26 @@ Input from standard V4Lfile | mplayer [options] [path/]filename | ||
files | mplayer [default options] [path/]filename1 [options for filename1] filename2 [options for filename2] ... | ||
VCD | mplayer [options] -vcd trackno [-cdrom-device /dev/cdrom] | ||
DVD | mplayer [options] -dvd titleno [-dvd-device /dev/dvd] | ||
net | mplayer [options] http://site.com/file.asf (playlists can be used too) | ||
file | mplayer [options] [path/]filename | ||
files | mplayer [default options] [path/]filename1 [options for filename1] filename2 [options for filename2] ... | ||
VCD | mplayer [options] -vcd trackno [-cdrom-device /dev/cdrom] | ||
DVD | mplayer [options] -dvd titleno [-dvd-device /dev/dvd] | ||
net | mplayer [options] http://site.com/file.asf (playlists can be used too) |
Latest versions of MPlayer also accepts VCD and DVD tracks in URL style, just like
Xine does: mplayer dvd://1
or mplayer vcd://1
mplayer -vo x11 /mnt/Films/Contact/contact2.mpg +@@ -1240,11 +1264,11 @@ Xine does:+ mplayer -vo x11 /mnt/Films/Contact/contact2.mpg mplayer -vcd 2 mplayer -afm 3 /mnt/DVDtrailers/alien4.vob mplayer -dvd 1 -dvd-device /dev/hdc - mplayer -abs 65536 -delay -0.4 -nobps ~/movies/test.avi+ mplayer -abs 65536 -delay -0.4 -nobps ~/movies/test.avi +
mplayer dvd://1
or mplayer vcd://1
Keyboard
-<- or -> | seek backward/forward 10 seconds | ||
up or down | seek backward/forward 1 minute | ||
pgup/pgdown | seek backward/forward 10 minutes | ||
< or > | seek backward/forward in playlist | ||
< or > | seek backward/forward in playlist | ||
p or SPACE | pause movie (press any key) | ||
q or ESC | stop playing and quit program | ||
+ or - | adjust audio delay by +/- 0.1 second | ||
3 or 4 | adjust brightness | ||
5 or 6 | adjust hue | ||
7 or 8 | adjust saturation |
GUI
-, and . | previous / next file | ||
gray - or + | decrease / increase volume | ||
enter | start playing | ||
p | toggle playlist | ||
f | toggle fullscreen | ||
m | toggle mute | -
TV
-h or l | select previous/next channel | ||
n | change norm | ||
b | change channel list |
MPlayer allow you to bind any key/button to any MPlayer command using a simple config file. The syntax consist of a key name followed by a command. The default config file location is $HOME/.mplayer/input.conf but it can be overrided using the -input conf switch (relative path are relative to $HOME/.mplayer). -
-Example: +
Example:
## ## MPlayer input control file @@ -1311,9 +1333,8 @@ q quit > pt_step 1 < pt_step -1 ENTER pt_step 1 1 -+ - @@ -1321,7 +1342,7 @@ ENTER pt_step 1 1
Keyboard
-Mouse
Note : mouse is only supported under X
-Joystick
Note : joystick support must be enabled at compile time
-You can have a full list of know commands by running "mplayer -input cmdlist"
-
Seek to some place in the movie.
Type 0 is a relative seek of +/- val seconds.
- Type 1 seek to val % in the movie.
Adjust the audio delay of val seconds
@@ -1446,10 +1466,10 @@ ENTER pt_step 1 1GUI actions
++begin button = VOLUME_PLUS prog = mplayer @@ -1495,7 +1515,7 @@ begin prog = mplayer config = seek 0 1\npause end -+
If you don't like the standard location for the lirc-config file (~/.lircrc) use the -lircconf <filename> switch to specify another file.
@@ -1521,9 +1541,9 @@ used to play from FTP:Note: it's also recommended to enable CACHE when playback from network:
wget ftp://micorsops.com/something.avi -O - | mplayer -cache 8192 -
4. FAQ section
- + @@ -1532,24 +1552,30 @@ used to play from FTP:To build the package, get the cvs version, or .tgz and uncompress it, and cd into programs directory:
-cd main - fakeroot debian/rules binary+
+ cd main + fakeroot debian/rules binary +
(... mplayer detects hardware/software, builds itself and.. ) dpkg-deb: building package `mplayer' in `../mplayer_0.18-1_i386.deb'.
And now just become root, and:
-dpkg -i ../mplayer_0.18-1_i386.deb as root.+
+ dpkg -i ../mplayer_0.18-1_i386.deb as root. +
Here's how it looks like:
-eyck@incubus:/src/main$ sudo dpkg -i ../mplayer_0.18-1_i386.deb +@@ -1589,8 +1615,10 @@ HREF="http://www.sun.com/sparc/vis/mediaLib.html">mLib installed. Solaris make will not work. Typical error you get when building with solaris' make instead of GNU make: -+ eyck@incubus:/src/main$ sudo dpkg -i ../mplayer_0.18-1_i386.deb Password: (Reading database ... 26946 files and directories currently installed.) Preparing to replace mplayer 0.17a-1 (using ../mplayer_0.18-1_i386.deb) Unpacking replacement mplayer ... - Setting up mplayer (0.18-1) ...+ Setting up mplayer (0.18-1) ... +
% /usr/ccs/bin/make - make: Fatal error in reader: Makefile, line 25: Unexpected end of line seen+
+ % /usr/ccs/bin/make + make: Fatal error in reader: Makefile, line 25: Unexpected end of line seen +
On Solaris SPARC, you need the GNU C/C++ Compiler; it does not matter if GNU C/C++ compiler is configured with or without the GNU assembler.
@@ -1609,24 +1637,28 @@ configure script where it can find GNU "as" on your system).Error message from configure on a Solaris x86 system using GCC without GNU assembler:
-% configure ++ % configure ... Checking assembler (/usr/ccs/bin/as) ... , failed - Please upgrade(downgrade) binutils to 2.10.1...+ Please upgrade(downgrade) binutils to 2.10.1... +
(Solution: Install and use a gcc configured with "--with-as=gas")
Typical error you get when building with a GNU C compiler that does not use GNU as:
-% gmake ++ % gmake ... gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math -fomit-frame-pointer -I/usr/local/include -o mplayer.o mplayer.c Assembler: mplayer.c "(stdin)", line 3567 : Illegal mnemonic "(stdin)", line 3567 : Syntax error - ... more "Illegal mnemonic" and "Syntax error" errors ...+ ... more "Illegal mnemonic" and "Syntax error" errors ... +
For DVD support you must have the patched libcss installed. Patch: http://www.tools.de/solaris/mplayer/.
@@ -1634,7 +1666,8 @@ not use GNU as:Due to two bugs in solaris 8 x86, you cannot reliably play DVDs using a capacity >4GB:
-On Solaris with an UltraSPARC CPU, you can get some extra speed by using the CPU's VIS instructions for certain time consuming operations. @@ -1659,8 +1692,10 @@ all data is accessed modulo 4GB
MPlayer is reported to compile on StrongARM. Use the following command line:
-./configure --target=arm-linux --disable-css --with-x11libdir=/usr/arm/lib - --with-x11incdir=/usr/arm/lib --disable-gcc-checking+
+ ./configure --target=arm-linux --disable-css --with-x11libdir=/usr/arm/lib + --with-x11incdir=/usr/arm/lib --disable-gcc-checking +
6.5. Silicon Graphics Indigo / IRIX
@@ -1708,7 +1743,7 @@ version (/usr/ports/x11/mplayer).The MPlayer project:
-zr
video output driverMain testers:
-The codecs, libs:
-Their code is not used in current player version, but I've got some ideas or other technical help from:
-Appendix A/2 - MPlayer code and documentation maintainers
-Homepage +Homepage
English documentation -
Documentation translations -
Platforms/ports -
MPlayer code: -
libvo drivers: -
VIDIX drivers: -
libao2 drivers: -
TOOLS: +English documentation
There are some public mailing lists on MPlayer. Subscribing can be achieved on the following addresses:
-This list is about mplayer development! Talking about interface/API changes, new libraries, code optimization, ./configure changes, and send patches here. Do NOT send bugreports, user questions, feature requests, flame here! This list should be kept low-traffic.
- -Send matrox-related questions here
Things related to the hardware decoder card called DVB. (NOT dxr3!)
- -Send only questions about CVS changes here. (if you don't understand why a change is required or you've better fix or you've noticed possible bug/problem in the commited patch) Be sure in that your target developer reads this list!
- -NOTE: language of above lists are ENGLISH, unless explicitly stated otherwise. Please do not send messages using other language!
@@ -2346,7 +2457,7 @@ otherwise. Please do not send messages using other language! here. -Appendix C - How to report bugs
+Appendix C - How to report bugs
@@ -2380,7 +2491,7 @@ otherwise. Please do not send messages using other language!Various A-V sync and other audio problems:
-General audio delay or jerky sound (exists with all or many files):