289c28c059eff261667a868c76ab5177e0d74496
[mplayer.git] / DOCS / tech / subcp.txt
1 Ascii Subtitle / Font CODEPAGEs
2 ===============================
3
4 The subtitle encoding issue seems a bit confusing, so I'll try to 
5 summarize it here.
6
7 There are 2 approaches:
8
9 1. (preferred) You can generate Unicode subtitles with:
10         subfont --unicode <signle-byte encoding known by iconv> ...
11 or
12         subfont --unicode <path to custom encoding file> ...
13         (this custom encoding file could list all iso-8859-* characters to create 
14 single font file for common encodings)
15
16 and then run mplayer this way (-subcp and -utf8 expect Unicode font!):
17         mplayer -subcp <any encoding known by iconv> ...
18 or
19         mplayer -utf8 ...
20
21 2. (current) Generate subtitles for some specific encoding with:
22         subfont <signle-byte encoding known by iconv> ...
23 or
24         subfont <path to custom signle-byte or EUC encoding file> ...
25
26 and then run mplayer without any encoding options for signle-byte 
27 encodings, or with -unicode option for EUC (and the like) encodings 
28 (which is only partially implemented in mplayer).
29
30 AFAIK, CJK encodings: EUC-*, BIG5 and GB2312 work more or less this way:
31 - 0x8e (SINGLE-SHIFT TWO, SS2) begins a 2-byte character,
32 - 0x8f (SINGLE-SHIFT THREE, SS3) begins a 3-byte character,
33 - 0xa0-0xff begin 2-byte characters,
34 - other characters are single-byte.
35
36
37 I tested charmap2enc script only with /usr/share/i18n/charmaps/EUC-KR.gz 
38 (on RedHat). It wasn't intended to be perfect.
39
40
41 -- 
42 Artur Zaprzala
43
44