rsrctool: produce an actually usuable entry list of the rsrc file
[maemo-rb.git] / fonts / README
blob2c81c60d38a7ec0582478c9667e9d1b2edea3e54
1                __________               __   ___.
2      Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
3      Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
4      Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
5      Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
6                        \/            \/     \/    \/            \/
8                          Rockbox Font Collection
10 Fonts put here need to follow a few rules:
12 1. All fonts must be in standard unicode encoding (ISO10646-1). ISO8859-1
13    would also work, but should be avoided for consistency, and converted to
14    unicode (it's a trivial change of declaration, the actual code positions
15    stay the same).
16    Other encodings will break text output in rockbox for any non-ASCII text
17    and are hence not allowed.
18    
19 2. All fonts need to adhere to the following naming convention for easy
20    browsing in rockbox:
22       NN-Family-Variant.bdf
24    NN is the height _in pixels_ when converted to .fnt with convbdf, zero
25    padded for proper sorting in the file browser.
27    "Family" is the font family (might consist of more than one part, e.g.
28    "Adobe-Helvetica")
29    
30    "Variant" covers the weight and variant (might also consist of more than
31    one part e.g. "Cond-BoldItalic"). This part should be left out if it is
32    Regular/Normal/Medium. Do not abbreviate variant names unless they're
33    overly long (keep in mind that the rockbox target displays vary a lot in
34    size).
36 3. Fonts must have a suitable license for redistribution.
38 4. Fonts should be carefully selected, judging quality over quantity. A font
39    that only covers ASCII isn't worth much. Rockbox supports a lot of
40    languages.
43 Reference table for theme authors
45 Old Name                   New Name              Remarks
46 -------------------------------------------------------------------------------
47 00-Starmap_r400-8          -                     removed, use another 8px font
48 5x7                        07-Fixed
49 5x8                        08-Fixed
50 6+12x13                    13-Fixed
51 6x9                        09-Fixed
52 6x10                       10-Fixed
53 6x12                       12-Fixed-SemiCond
54 6x13                       13-Fixed-SemiCond
55 6x13B                      13-Fixed-SemiCond-Bold
56 8x13B                      13-Fixed-Bold
57 9+18x18                    18-Fixed
58 9+18x18B                   18-Fixed-Bold
59 alt8x8                     -                     removed, use another 8px font
60 atadore                    08-Atadore
61 atari-small                -                     removed, use another 8px font
62 clR6x8-8859-2              08-Schumacher-Clean   *
63 courB08                    -                     removed, use another 10px font
64 courB14                    -                     removed, use another 18px font
65 Hebrew-Bold                -                     removed, use another 8px font
66 Hebrew-Large               -                     removed, use another 8px font
67 Hebrew-Medium              -                     removed, use another 8px font
68 Hebrew-Small               -                     removed, use another 8px font
69 helvR10                    12-Adobe-Helvetica
70 helvR12                    15-Adobe-Helvetica
71 helvR14                    16-Adobe-Helvetica
72 jackash-16                 16-Jackash
73 mix12                      14-Rockbox-Mix
74 namil-8                    08-Namil
75 nedore-8                   08-Nedore
76 nedore-9                   09-Nedore
77 nimbus-10                  10-Nimbus
78 nimbus-11                  11-Nimbus
79 nimbus-12                  12-Nimbus
80 nimbus-13                  13-Nimbus
81 nimbus-14                  14-Nimbus
82 nimbus-19                  19-Nimbus
83 ProFont_r400-10            10-ProFont
84 ProFont_r400-11            11-ProFont
85 ProFont_r400-12            12-ProFont
86 ProFont_r400-15            15-ProFont
87 ProFont_r400-17            17-ProFont
88 ProFont_r400-22            22-ProFont
89 ProFont_r400-29            29-ProFont
90 proportional               08-Rockbox-Propfont
91 rockbox_default            08-Schumacher-Clean   *
92 rockfont-8                 08-Rockfont
93 Sazanami-Mincho-Regular-8  08-Sazanami-Mincho
94 Sazanami-Mincho-Regular-9  09-Sazanami-Mincho
95 Sazanami-Mincho-Regular-10 10-Sazanami-Mincho
96 Sazanami-Mincho-Regular-11 11-Sazanami-Mincho
97 Sazanami-Mincho-Regular-12 12-Sazanami-Mincho
98 Sazanami-Mincho-Regular-13 13-Sazanami-Mincho
99 Sazanami-Mincho-Regular-14 14-Sazanami-Mincho
100 snap                       10-Artwiz-Snap
101 ter-u12n                   12-Terminus
102 ter-u14b                   14-Terminus-Bold
103 ter-u14n                   14-Terminus
104 ter-u14v                   -                     removed, use 14-Terminus-Bold
105 ter-u16b                   16-Terminus-Bold
106 ter-u16n                   16-Terminus
107 ter-u16v                   -                     removed, use 16-Terminus-Bold
108 ter-u20b                   20-Terminus-Bold
109 ter-u20n                   20-Terminus
110 ter-u24b                   24-Terminus-Bold
111 ter-u24n                   24-Terminus
112 ter-u28b                   28-Terminus-Bold
113 ter-u28n                   28-Terminus
114 ter-u32b                   32-Terminus-Bold
115 ter-u32n                   32-Terminus
116 timR08                     -                     removed, use another 11px font
117 Tiny-Prop-5                05-Tiny
118 Tiny-Prop-6                06-Tiny
119 unifont                    16-GNU-Unifont
120 uwe_prop                   -                     removed, use 08-Rockbox-Propfont
121 win_crox0c                 -                     removed, use another 10px font
122 win_crox1c                 -                     removed, use another 13px font
123 win_crox2c                 -                     removed, use another 16px font
124 win_crox3c                 -                     removed, use another 20px font
125 win_crox4h                 -                     removed, use another 24px font
126 win_crox5t                 -                     removed, use another 27px font
128 * this is not a mistake. Those were 2 encoding variants of the same font,
129   which are now combined.