From 2858b18d99549be98362293d0258a7647fdc9c38 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Franti=C5=A1ek=20Dvo=C5=99=C3=A1k?= Date: Thu, 19 Feb 2004 19:10:58 +0000 Subject: Michael's corrections and changes in the FAQ. English looks better now. :-) CVS patchset: 6176 CVS date: 2004/02/19 19:10:58 --- doc/faq/faq.sgml | 109 +++++++++++++++++++++++++++++-------------------------- 1 file changed, 57 insertions(+), 52 deletions(-) (limited to 'doc') diff --git a/doc/faq/faq.sgml b/doc/faq/faq.sgml index d3e8f6c40..6a9417733 100644 --- a/doc/faq/faq.sgml +++ b/doc/faq/faq.sgml @@ -1823,79 +1823,84 @@ - Which kinds of subtitle fonts xine uses and how to use them? - - xine can use two kinds of the fonts: + What kinds of subtitle fonts does xine use? + + xine can use two kinds of fonts: - + - TTF fonts + TTF fonts - If xine is compiled with freetype library xine recognises and uses TTF - fonts directly. + If xine is compiled with freetype library xine recognizes and uses TTF + fonts directly. - - + + - xine fonts + xine fonts - This is the xine native format. It's better because in the font - generator utility is implemented more features than in the - "on the fly" TTF renderer. + This is xine's native format. It's better because the font + generator utility implements more features than the "on the fly" TTF renderer. - + - - - Font for external subtitles is selected via config option - 'misc.spu_font'. You can specify xine font name ('sans', 'serif', ...) - or file name of TTF font. The fonts are searched in the directories + + + The font for text subtitles is selected via config option + misc.spu_font. You can specify xine font name + (sans, serif, ...) + or file name of the TTF font. The directories $prefix/share/xine/libxine1/fonts and - ~/.xine/fonts. TTF fonts are searched also in the - current directory. - + ~/.xine/fonts are searched for the fonts, with + $prefix being the place xine-lib was installed to. + Usually this is /usr/local or /usr. + TTF fonts are also searched for in the current directory. + - How to create own xine subtitle fonts? - - xine native subtitle fonts can be generated from TTF fonts with the - utility xine-fontconv. It isn't compiled and installed by default but - you can make it manually. You'll need freetype and zlib packages and - their versions for development: + How to create own xine subtitle fonts? + + xine's native subtitle fonts can be generated from TTF fonts with the + utility xine-fontconv. It isn't compiled and installed by default but + you can make it manually. You'll need freetype and zlib packages together with + their versions for development plus a compiler, of course ;) + Here's how you build xine-fontconv: - - - Get the source of xine-fontconv utility from xine-lib sources. - - - - - Compile it: - gcc xine-fontconv.c -o xine-fontconv `freetype-config --cflags --libs` -lz - - + + + Get the source of xine-fontconv utility from the misc + directory within the xine-lib sources. + + + + + Compile it: +    gcc xine-fontconv.c -o xine-fontconv `freetype-config --cflags --libs` -lz + + You'll need some TTF font for generating. Characters in this font should - cover all codepages you want support else you'll have missing characters. - - + cover all codepages you want supported, otherwise you'll have missing characters. + + Syntax is: - ./xine-fontconf font.ttf font_name [encoding1 [encoding2 [...]]] - - +    ./xine-fontconf font.ttf font_name [encoding1 [encoding2 [...]]] + + For example default font sans was generated with following command: - ./xine-fontconv Aril_Bold.ttf sans iso-8859-1 iso-8859-2 iso-8859-5 \ - iso-8859-9 iso-8859-15 cp1250 cp1251 - - + +   ./xine-fontconv Aril_Bold.ttf sans iso-8859-1 iso-8859-2 iso-8859-5 \ +    iso-8859-9 iso-8859-15 cp1250 cp1251 + + There are displayed messages about missing characters on the screen during generating. It's OK if the missing characters are U+007f..U+009F. These characters come from iso-8859-1 and they aren't displayable. - + @@ -1903,8 +1908,8 @@ Default expected encoding of the external subtitles is iso-8859-1. You need set appropriate encoding in the config option - 'misc.spu_src_encoding'. Note you need also the font which contains all - characters from given encoding. + misc.spu_src_encoding. Note you need also the font + which contains all characters from given encoding. Default font sans and fonts -- cgit v1.2.3