diff --git a/DOCS/xml/en/install.xml b/DOCS/xml/en/install.xml index 5c90c8e5c4..ec94f5880b 100644 --- a/DOCS/xml/en/install.xml +++ b/DOCS/xml/en/install.xml @@ -60,6 +60,10 @@ You need a fairly recent system. On Linux, 2.4.x kernels are recommended. always the newest (at least 3.79.x). This usually isn't important. + + FreeType 2.0.9 or later is required + to have a font for the OSD and subtitles. + SDL - it's not mandatory, but can help in some cases (bad audio, video cards that lag strangely with the xv driver). @@ -102,10 +106,6 @@ You need a fairly recent system. On Linux, 2.4.x kernels are recommended. cdparanoia - optional, for CDDA support - - libfreetype - optional, for TTF fonts - support. At least 2.0.9 is required. - libxmms - optional, for XMMS input plugin support. At least 1.2.7 is required. @@ -560,112 +560,63 @@ About DVD subtitles, read the DVD section. Installing OSD and subtitles -You need an MPlayer font package to be able to use -OSD/SUB feature. There are many ways to get it: - +You need to tell MPlayer which font to use to +enjoy OSD and subtitles. Any TrueType font or special bitmap fonts will +work. However, TrueType fonts are recommended as they look far better, +can be properly scaled to the movie size and cope better with different +encodings. - - - using a TrueType (TTF) font, by the means of the freetype - library. Version 2.0.9 or greater is mandatory! Then you have two methods: - use the - option to specify a TrueType font file on every occasion + Use the + option to specify a TrueType font file on the command line. - create a symlink: + Create a symlink ln -s /path/to/sample_font.ttf ~/.mplayer/subfont.ttf + for each user individually or a system-wide one: + ln -s /path/to/sample_font.ttf /usr/local/share/mplayer/subfont.ttf If MPlayer was compiled with fontconfig support, the above methods - won't work, instead the expects a + won't work, instead expects a fontconfig font name and defaults to the sans-serif font. To get a list of fonts known to fontconfig, - use fc-list. Example: - - - Download ready-to-use font packages from MPlayer - site. Note: currently available fonts are limited for ISO 8859-1/2 support, - but there are some other (including Korean, Russian, ISO 8859-8 etc) fonts at - contrib/font section of FTP, made by users. - - - Font should have appropriate font.desc file which - maps unicode font positions to the actual code page of the subtitles - text. Other solution is to have subtitles encoded in UTF-8 encoding and - use option or just name the subtitles file - <video_name>.utf and have it in the same dir - as the video file. Recoding from different codepages to UTF-8 could be - done by using konwert or iconv programs. - + use fc-list. Example: - - Some URLs - - - URLComment - - - - - - ISO fonts - - - - - various fonts by users - - - -
+mplayer -font 'Bitstream Vera Sans' anime.mkv +
-
- -If you chose non-TTF fonts, UNZIP the file you downloaded to ~/.mplayer or $PREFIX/share/mplayer. Then rename or symlink -one of the extracted directories to font, -for example: +If for some reason you wish or need to employ bitmap fonts, download a set +from our homepage. You can choose between various +ISO fonts +and some sets of fonts +contributed by users +in various encodings. + + +Uncompress the file you downloaded to +~/.mplayer or +$PREFIX/share/mplayer. +Then rename or symlink one of the extracted directories to +font, for example: ln -s ~/.mplayer/arial-24 ~/.mplayer/font - -Now you have to see a timer at the upper left corner of the movie (switch -it off with the o key). +ln -s $PREFIX/share/mplayer/arial-24 $PREFIX/share/mplayer/font -(subtitles are always enabled, for disabling them please -read the man page) +Fonts should have an appropriate font.desc file +which maps unicode font positions to the actual code page of the +subtitle text. Another solution is to have UTF-8-encoded subtitles +and use the option or just name the subtitles +file <video_name>.utf and have it in the +same directory as the video file. - -OSD has 4 states (switch with o): - - - - volume bar + seek bar (default) - - - volume bar + seek bar + timer + file position percentage on seeking - - - volume bar + seek bar + timer + total duration of the media - - - subtitles only - - - -You can change default behaviour by setting osdlevel -variable in config file, or the command line option. - -