* doc/subtitles/*, share/font-eutopiabold21.rle: new (smaller) font + scripts
[vlc.git] / doc / subtitles / readme
1 How to create new subtitles fonts
2 ---------------------------------
3
4 VLC uses run-length encoded fonts. We already provide 2 of these fonts
5 (share/font-eutopiabold21.rle and share/font-eutopiabold36.rle) but you might
6 also want to generate your own.
7
8 Two (very basic) perl scripts are provided to generate these fonts files,
9 vlc-gimp.pl and vlc-font.pl. vlc-gimp.pl is perl-fu, and uses gimp's font
10 plotting routines to create an image, which should be saved as an RAW PNM.
11 Installing vlc-gimp.pl with "gimptool --install-bin vlc-gimp.pl" will add a new
12 entry in the Xtns/Perl-Fu menu in gimp.
13 vlc-font.pl extracts the characters from the raw PNM, and creates a run-length
14 encoded font file which VLC can use. As already stated these scripts are quite
15 basic so you will have to hack them to your liking.
16
17 Also note that the subtitler engine in VLC is currently being replaced to use
18 the freetype library which will allow the use of fonts already available on
19 your system and some other new powerful features.