[MPlayer-cvslog] CVS: main README,1.16,1.17
Ivo van Poorten CVS
syncmail at mplayerhq.hu
Sat Aug 6 01:29:16 CEST 2005
CVS change done by Ivo van Poorten CVS
Update of /cvsroot/mplayer/main
In directory mail:/var2/tmp/cvs-serv2562
Modified Files:
README
Log Message:
Restore latest version of README after CVS breakage
This version was originally 1.30
Index: README
===================================================================
RCS file: /cvsroot/mplayer/main/README,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- README 24 Dec 2003 22:58:34 -0000 1.16
+++ README 5 Aug 2005 23:29:13 -0000 1.17
@@ -1,5 +1,4 @@
-
-Welcome to MPlayer, the Unix movie player. MPlayer can play most standard video
+Welcome to MPlayer, The Movie Player. MPlayer can play most standard video
formats out of the box and almost all others with the help of external codecs.
MPlayer currently works best from the command line, but visual feedback for
many functions is available from its onscreen status display (OSD), which is
@@ -20,14 +19,14 @@
- You need a working development environment that can compile programs.
On popular Linux distributions, this means having the glibc development
package(s) installed.
-- To compile MPlayer with X11 support, you need to have the XFree86 development
- packages installed.
+- To compile MPlayer with X11 support, you need to have the X Window System
+ development packages (like for XFree86 or X.Org) installed.
- For the GUI you need the libpng and GTK 1.2 development packages.
Before you start...
-Unless you know what are you doing, consult DOCS/HTML/en/devices.html#video-dev
-to see which driver to use with your video card to get the best quality and
+Unless you know what are you doing, consult DOCS/HTML/en/video.html to see
+which driver to use with your video card to get the best quality and
performance. Most cards require special drivers not included with XFree86 to
drive their 2-D video acceleration features like YUV and scaling.
@@ -37,7 +36,7 @@
- 3dfx Voodoo3/Banshee: Get XFree86 4.2.0+ for Xv or use the tdfxfb driver.
- nVidia cards: Get the X11 driver from www.nvidia.com for Xv support.
- NeoMagic cards: Get an Xv capable driver from our homepage as described in
- DOCS/HTML/en/devices.html#video-dev.
+ DOCS/HTML/en/video.html.
Without accelerated video even an 800MHz P3 may be too slow to play DVDs.
@@ -52,12 +51,10 @@
http://www.mplayerhq.hu/homepage/dload.html
-A set of fonts is necessary for the OSD and subtitles, the GUI needs at least
-one skin and codec packages add support for some more video and audio formats.
-MPlayer does not come with any of these by default, you have to download and
-install them separately. A wide range of codec packages can be downloaded at
-
- http://www.mplayerhq.hu/MPlayer/releases/codecs/
+A set of fonts is necessary for the OSD and subtitles unless you are using
+TrueType fonts, the GUI needs at least one skin and codec packages add support
+for some more video and audio formats. MPlayer does not come with any of these
+by default, you have to download and install them separately.
You can also get MPlayer via anonymous CVS. Issue the following commands to get
the latest sources:
@@ -73,29 +70,41 @@
from within that directory.
-___________________________________
-STEP1: Installing FFmpeg libavcodec
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+_________________________________________________________
+STEP1: Installing FFmpeg libavcodec/libavutil/libavformat
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-If you are using an official (pre)release, skip this step, since official
-releases include libavcodec. CVS sources and thus CVS snapshots do not include
+If you are using an official (pre)release or a CVS snapshot, skip this step,
+since official releases include libavcodec. CVS sources do not include
libavcodec. To verify if you do have libavcodec or not, check if a subdirectory
named 'libavcodec' exists in the MPlayer source tree.
The FFmpeg project provides libavcodec, a very portable codec collection (among
-the supported formats is MPEG4/DivX) with excellent quality and speed, that is
-the preferred MPEG4/DivX codec of MPlayer. You have to get libavcodec directly
+the supported formats is MPEG-4/DivX) with excellent quality and speed, that is
+the preferred MPEG-4/DivX codec of MPlayer. You have to get libavcodec directly
from the FFmpeg CVS server.
To get the FFmpeg sources, use the following commands in a suitable directory
outside the MPlayer source directory:
cvs -d:pserver:anonymous at mplayerhq.hu:/cvsroot/ffmpeg login
-cvs -z3 -d:pserver:anonymous at mplayerhq.hu:/cvsroot/ffmpeg co ffmpeg/libavcodec
+cvs -z3 -d:pserver:anonymous at mplayerhq.hu:/cvsroot/ffmpeg co ffmpeg
When asked for a password, you can just hit enter. A directory named 'ffmpeg'
-with a subdirectory named 'libavcodec' inside will be created. Copy (symbolic
-linking does NOT suffice) this subdirectory into the MPlayer source tree.
+with subdirectories named 'libavcodec' and 'libavutil' inside will be created.
+Copy (symbolic linking does NOT suffice) these subdirectories into the MPlayer
+source tree.
+
+In order to force automatic updates of libavcodec when you update MPlayer, add
+the following lines to main/CVS/Entries:
+
+D/libavcodec////
+D/libavutil////
+
+FFmpeg also contains libavformat, a library to decode container formats that
+can optionally be used to extend MPlayer's container format support. If you
+wish to use it, also copy the libavformat subdirectory into the MPlayer
+source tree and add another line to main/CVS/Entries.
_______________________________
@@ -169,6 +178,20 @@
fakeroot debian/rules binary
+If you want to pass custom options to configure, you can set up the
+DEB_BUILD_OPTIONS environment variable. For instance, if you want GUI
+and OSD menu support you would use:
+
+ DEB_BUILD_OPTIONS="--enable-gui --enable-menu" fakeroot debian/rules binary
+
+You can also pass some variables to the Makefile. For example, if you want
+to compile with gcc 3.4 even if it's not the default compiler:
+
+ CC=gcc-3.4 DEB_BUILD_OPTIONS="--enable-gui" fakeroot debian/rules binary
+
+To clean up the source tree run the following command:
+
+ fakeroot debian/rules clean
____________________________________________
STEP5: Installing the onscreen display fonts
@@ -178,6 +201,10 @@
font files of the corresponding size into /usr/local/share/mplayer/font/ or
~/.mplayer/font/ (or whatever you set with './configure --datadir=DIR').
+Alternatively you can use a TrueType font installed on your system. Just
+make a symbolic link from either /usr/local/share/mplayer/subfont.ttf or
+~/.mplayer/subfont.ttf to your TrueType font.
+
____________________________
STEP6: Installing a GUI skin
More information about the MPlayer-cvslog
mailing list