tags around block elements, do not put block elements in inline elements, some typos and cosmetic changes. diff -r d0d74f9d8d4a -r a2eb6f519855 DOCS/documentation.html --- a/DOCS/documentation.html Sat Jun 15 17:12:21 2002 +0000 +++ b/DOCS/documentation.html Sat Jun 15 19:47:10 2002 +0000 @@ -1,226 +1,250 @@ +
+ - - -Table of Contents
-+
+
+
- - -0. How to read this documentation
@@ -336,7 +359,7 @@ 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 @@ 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 @@
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 @@
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.
- - mkdir ~/.mplayer/font
+section 1.5 for details.
+
+
+ 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
+
@@ -679,14 +706,13 @@
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 @@MPlayer can display subtitles along with movie files. Currently the following -formats are supported: +formats are supported:
VobSub subtitles
@@ -789,7 +814,7 @@
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 @@
~/.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.4. MEncoder - An All-Purpose Encoder
- - - - - -2.5.1. Overview
+ + + + + + +2.3.. Video & Audio output devices
+ + +2.4.. MEncoder - An All-Purpose Encoder
+ + + + + +This section is about how to enable watching/grabbing from V4L compatible TV tuner.
@@ -862,9 +887,8 @@ 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 @@
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 @@ | 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 @@
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 @@
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 @@
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 @@ -vop crop[=width:height:x:y]
2.6.4. Expand
+Description:
@@ -1056,7 +1078,7 @@ -vop expand[=width:height:x:y]
2.6.5. Fame/Lavc
+Description:
@@ -1070,7 +1092,7 @@ -vop lavc
2.6.6. Flip
+Description:
@@ -1082,7 +1104,7 @@ -vop flip
2.6.7. Format
+Description:
@@ -1096,7 +1118,7 @@format can be for example: rgb32, yuy2, etc...)
-2.6.8. Postprocess
+Description:
@@ -1109,7 +1131,7 @@ -vop pp[=postprocess options/keywords]
2.6.9. RGB2BGR
+Description:
@@ -1122,7 +1144,7 @@ -vop rgb2bgr[=swap]
2.6.10. Rotate
+Description:
@@ -1134,12 +1156,12 @@ -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 @@
-vop scale[=width:height]
2.6.12. YUY2
+Description:
@@ -1164,7 +1186,7 @@ -vop yuy2
2.6.13. Mirror
+Description:
@@ -1175,7 +1197,7 @@ -vop mirror
2.6.14. DVBscale
+Description:
@@ -1186,7 +1208,7 @@ -vop dvbscale
2.6.15. Cropdetect
+Description:
@@ -1211,24 +1233,26 @@ will play files in this order: 1 1 2 1 1 2 1 1 2| 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) | ||
| 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 @@+ 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 +
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 @@ > pt_step 1 < pt_step -1 ENTER pt_step 1 1 -- - + + @@ -1321,7 +1342,7 @@
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 @@GUI actions
+
+
begin
button = VOLUME_PLUS
prog = mplayer
@@ -1495,7 +1515,7 @@
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 @@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 @@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 @@ 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 @@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 @@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 @@
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 @@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: +
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 @@ here. -Appendix C - How to report bugs
+Appendix C - How to report bugs
@@ -2380,7 +2491,7 @@Various A-V sync and other audio problems:
-General audio delay or jerky sound (exists with all or many files):