mirror of https://github.com/mpv-player/mpv
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@19825 b3059339-0415-0410-9bf9-f77b7e298cf2
This commit is contained in:
diego
parent
fa81ef2122
commit
5e238d8a8f
|
|
@ -60,6 +60,10 @@ You need a fairly recent system. On Linux, 2.4.x kernels are recommended.
|
||||||
<emphasis role="bold">always the newest</emphasis> (at least 3.79.x). This
|
<emphasis role="bold">always the newest</emphasis> (at least 3.79.x). This
|
||||||
usually isn't important.
|
usually isn't important.
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
|
<listitem><para>
|
||||||
|
<emphasis role="bold">FreeType</emphasis> 2.0.9 or later is required
|
||||||
|
to have a font for the OSD and subtitles.
|
||||||
|
</para></listitem>
|
||||||
<listitem><para>
|
<listitem><para>
|
||||||
<emphasis role="bold">SDL</emphasis> - it's not mandatory, but can help in
|
<emphasis role="bold">SDL</emphasis> - it's not mandatory, but can help in
|
||||||
some cases (bad audio, video cards that lag strangely with the xv driver).
|
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.
|
||||||
<listitem><para>
|
<listitem><para>
|
||||||
<emphasis role="bold">cdparanoia</emphasis> - optional, for CDDA support
|
<emphasis role="bold">cdparanoia</emphasis> - optional, for CDDA support
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
<listitem><para>
|
|
||||||
<emphasis role="bold">libfreetype</emphasis> - optional, for TTF fonts
|
|
||||||
support. At least 2.0.9 is required.
|
|
||||||
</para></listitem>
|
|
||||||
<listitem><para>
|
<listitem><para>
|
||||||
<emphasis role="bold">libxmms</emphasis> - optional, for XMMS input plugin
|
<emphasis role="bold">libxmms</emphasis> - optional, for XMMS input plugin
|
||||||
support. At least 1.2.7 is required.
|
support. At least 1.2.7 is required.
|
||||||
|
|
@ -560,112 +560,63 @@ About DVD subtitles, read the <link linkend="dvd">DVD</link> section.
|
||||||
<title>Installing OSD and subtitles</title>
|
<title>Installing OSD and subtitles</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
You need an <application>MPlayer</application> font package to be able to use
|
You need to tell <application>MPlayer</application> which font to use to
|
||||||
OSD/SUB feature. There are many ways to get it:
|
enjoy OSD and subtitles. Any TrueType font or special bitmap fonts will
|
||||||
</para>
|
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.
|
||||||
|
|
||||||
<itemizedlist>
|
|
||||||
<listitem><para>
|
|
||||||
using a TrueType (TTF) font, by the means of the <systemitem class="library">freetype</systemitem>
|
|
||||||
library. Version 2.0.9 or greater is mandatory! Then you have two methods:
|
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>
|
<listitem><para>
|
||||||
use the <option>-font <replaceable>/path/to/sample_font.ttf</replaceable></option>
|
Use the <option>-font <replaceable>/path/to/sample_font.ttf</replaceable></option>
|
||||||
option to specify a TrueType font file on every occasion
|
option to specify a TrueType font file on the command line.
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
<listitem><para>
|
<listitem><para>
|
||||||
create a symlink:
|
Create a symlink
|
||||||
<screen>ln -s <replaceable>/path/to/sample_font.ttf</replaceable> ~/.mplayer/subfont.ttf</screen>
|
<screen>ln -s <replaceable>/path/to/sample_font.ttf</replaceable> ~/.mplayer/subfont.ttf</screen>
|
||||||
|
for each user individually or a system-wide one:
|
||||||
|
<screen>ln -s <replaceable>/path/to/sample_font.ttf</replaceable> /usr/local/share/mplayer/subfont.ttf</screen>
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
If <application>MPlayer</application> was compiled with
|
If <application>MPlayer</application> was compiled with
|
||||||
<systemitem class="library">fontconfig</systemitem> support, the above methods
|
<systemitem class="library">fontconfig</systemitem> support, the above methods
|
||||||
won't work, instead the <option>-font</option> expects a
|
won't work, instead <option>-font</option> expects a
|
||||||
<systemitem class="library">fontconfig</systemitem> font name
|
<systemitem class="library">fontconfig</systemitem> font name
|
||||||
and defaults to the sans-serif font. To get a list of fonts known to
|
and defaults to the sans-serif font. To get a list of fonts known to
|
||||||
<systemitem class="library">fontconfig</systemitem>,
|
<systemitem class="library">fontconfig</systemitem>,
|
||||||
use <command>fc-list</command>. Example: <option>-font
|
use <command>fc-list</command>. Example:
|
||||||
<replaceable>'Bitstream Vera Sans'</replaceable></option>
|
|
||||||
</para></listitem>
|
|
||||||
<listitem><para>
|
|
||||||
Download ready-to-use font packages from <application>MPlayer</application>
|
|
||||||
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.
|
|
||||||
</para><para>
|
|
||||||
<!-- FIXME: this para should be before the list -->
|
|
||||||
Font should have appropriate <filename>font.desc</filename> 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>-utf8</option> option or just name the subtitles file
|
|
||||||
<filename><video_name>.utf</filename> and have it in the same dir
|
|
||||||
as the video file. Recoding from different codepages to UTF-8 could be
|
|
||||||
done by using <command>konwert</command> or <command>iconv</command> programs.
|
|
||||||
</para><para>
|
|
||||||
|
|
||||||
<table>
|
<screen>mplayer -font <replaceable>'Bitstream Vera Sans'</replaceable> <replaceable>anime.mkv</replaceable></screen>
|
||||||
<title>Some URLs</title>
|
</para>
|
||||||
<tgroup cols="2">
|
|
||||||
<thead>
|
|
||||||
<row><entry>URL</entry><entry>Comment</entry></row>
|
|
||||||
</thead>
|
|
||||||
<tbody>
|
|
||||||
<row><entry>
|
|
||||||
<ulink url="ftp://ftp.mplayerhq.hu/MPlayer/releases/fonts/"></ulink>
|
|
||||||
</entry><entry>
|
|
||||||
ISO fonts
|
|
||||||
</entry></row>
|
|
||||||
<row><entry>
|
|
||||||
<ulink url="ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/"></ulink>
|
|
||||||
</entry><entry>
|
|
||||||
various fonts by users
|
|
||||||
</entry></row>
|
|
||||||
</tbody>
|
|
||||||
</tgroup>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
</para></listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
<para>
|
<para>
|
||||||
If you chose non-TTF fonts, UNZIP the file you downloaded to <filename
|
If for some reason you wish or need to employ bitmap fonts, download a set
|
||||||
class="directory">~/.mplayer</filename> or <filename
|
from our homepage. You can choose between various
|
||||||
class="directory">$PREFIX/share/mplayer</filename>. Then rename or symlink
|
<ulink url="http://www.mplayerhq.hu/MPlayer/releases/fonts/">ISO fonts</ulink>
|
||||||
one of the extracted directories to <filename class="directory">font</filename>,
|
and some sets of fonts
|
||||||
for example:
|
<ulink url="http://www.mplayerhq.hu/MPlayer/contrib/fonts/">contributed by users</ulink>
|
||||||
|
in various encodings.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Uncompress the file you downloaded to
|
||||||
|
<filename class="directory">~/.mplayer</filename> or
|
||||||
|
<filename class="directory">$PREFIX/share/mplayer</filename>.
|
||||||
|
Then rename or symlink one of the extracted directories to
|
||||||
|
<filename class="directory">font</filename>, for example:
|
||||||
<screen>ln -s <replaceable>~/.mplayer/arial-24</replaceable> ~/.mplayer/font</screen>
|
<screen>ln -s <replaceable>~/.mplayer/arial-24</replaceable> ~/.mplayer/font</screen>
|
||||||
|
<screen>ln -s <replaceable>$PREFIX/share/mplayer/arial-24</replaceable> $PREFIX/share/mplayer/font</screen>
|
||||||
Now you have to see a timer at the upper left corner of the movie (switch
|
|
||||||
it off with the <keycap>o</keycap> key).
|
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
(subtitles are <emphasis>always enabled</emphasis>, for disabling them please
|
Fonts should have an appropriate <filename>font.desc</filename> file
|
||||||
read the man page)
|
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>-utf8</option> option or just name the subtitles
|
||||||
|
file <filename><video_name>.utf</filename> and have it in the
|
||||||
|
same directory as the video file.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
|
||||||
OSD has 4 states (switch with <keycap>o</keycap>):
|
|
||||||
|
|
||||||
<orderedlist>
|
|
||||||
<listitem><simpara>
|
|
||||||
volume bar + seek bar (default)
|
|
||||||
</simpara></listitem>
|
|
||||||
<listitem><simpara>
|
|
||||||
volume bar + seek bar + timer + file position percentage on seeking
|
|
||||||
</simpara></listitem>
|
|
||||||
<listitem><simpara>
|
|
||||||
volume bar + seek bar + timer + total duration of the media
|
|
||||||
</simpara></listitem>
|
|
||||||
<listitem><simpara>
|
|
||||||
subtitles only
|
|
||||||
</simpara></listitem>
|
|
||||||
</orderedlist>
|
|
||||||
|
|
||||||
You can change default behaviour by setting <varname>osdlevel</varname>
|
|
||||||
variable in config file, or the <option>-osdlevel</option> command line option.
|
|
||||||
|
|
||||||
</para>
|
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue