Add copy of .ttf font with .eot extension for testing
[wine-gecko.git] / modules / freetype2 / docs / formats.txt
blob2f7c3d94e23e53be6e9b4802cf2eabcb9c63a8d8
1 This  file  contains a  list  of various  font  formats.   It gives  the
2 reference document and whether it is supported in FreeType 2.
5   file type:
6     The only special  case is `MAC'; on older Mac  OS versions, a `file'
7     is  stored as  a  data and  a  resource fork,  this  is, within  two
8     separate data chunks.   In all other cases, the  font data is stored
9     in a single file.
11   wrapper format:
12     The format used  to represent the font data.  In  the table below it
13     is used only if the font format differs.  Possible values are `SFNT'
14     (binary), `PS' (a text header, followed by binary or text data), and
15     `LZW' (compressed with either `gzip' or `compress').
17   font format:
18     How the font  is to be accessed, possibly  after converting the file
19     type and  wrapper format  into a generic  form.  Bitmap  formats are
20     `BDF',  `PCF', and  one  form  of `WINFNT';  all  others are  vector
21     formats.
23   font type:
24     Sub-formats  of the font  format.  `SBIT'  and `MACSBIT'  are bitmap
25     formats, `MM' and `VAR' support optical axes.
27   glyph access:
28     If not specified, the glyph access is `standard' to the font format.
29     Values are  `CID' for CID-keyed  fonts, `SYNTHETIC' for  fonts which
30     are modified  versions of other  fonts by means of  a transformation
31     matrix, `COLLECTION' for collecting  multiple fonts (sharing most of
32     the data) into a single file, and `TYPE_0' for PS fonts which are to
33     be accessed in a tree-like structure.
35   FreeType driver:
36     The module in  the FreeType library which handles  the specific font
37     format.   A missing entry  means that  FreeType doesn't  support the
38     font format (yet).
41 Please  send  additions  and/or  corrections  to wl@gnu.org  or  to  the
42 FreeType developer's list  at freetype-devel@nongnu.org (for subscribers
43 only).   If you  can provide  a font  example for  a format  which isn't
44 supported yet please send a mail too.
47 file wrapper font   font    glyph      FreeType reference
48 type format  format type    access     driver   documents
49 ----------------------------------------------------------------------------
51 ---  ---     BDF    ---     ---        bdf      5005.BDF_Spec.pdf, X11
54 ---  SFNT    PS     TYPE_1  ---        ---      Type 1 GX Font Format
55                                                 (for the Mac)
56 MAC  SFNT    PS     TYPE_1  ---        ---      Type 1 GX Font Format
57                                                 (for the Mac)
58 ---  SFNT    PS     TYPE_1  CID        ---      5180.sfnt.pdf (for the Mac)
59 MAC  SFNT    PS     TYPE_1  CID        ---      5180.sfnt.pdf (for the Mac)
60 ---  SFNT    PS     CFF     ---        cff      OT spec, 5176.CFF.pdf
61                                                 (`OTTO' format)
62 MAC  SFNT    PS     CFF     ---        cff      OT spec, 5176.CFF.pdf
63                                                 (`OTTO' format)
64 ---  SFNT    PS     CFF     CID        cff      OT spec, 5176.CFF.pdf
65 MAC  SFNT    PS     CFF     CID        cff      OT spec, 5176.CFF.pdf
66 ---  SFNT    PS     CFF     SYNTHETIC  ---      OT spec, 5176.CFF.pdf
67 MAC  SFNT    PS     CFF     SYNTHETIC  ---      OT spec, 5176.CFF.pdf
68 ---  SFNT    TT     SBIT    ---        sfnt     XFree86 (bitmaps only;
69                                                 with `head' table)
70 ---  SFNT    TT     MACSBIT ---        sfnt     OT spec (for the Mac;
71                                                 bitmaps only; `bhed' table)
72 MAC  SFNT    TT     MACSBIT ---        sfnt     OT spec (for the Mac;
73                                                 bitmaps only; `bhed' table)
74 ---  SFNT    TT     ---     ---        truetype OT spec (`normal' TT font)
75 MAC  SFNT    TT     ---     ---        truetype OT spec (`normal' TT font)
76 MAC  SFNT    TT     VAR     ---        truetype GX spec (`?var' tables)
77 ---  SFNT    TT     ---     COLLECTION truetype OT spec (this can't be CFF)
78 MAC  SFNT    TT     ---     COLLECTION truetype OT spec (this can't be CFF)
81 ---  ---     PS     TYPE_1  ---        type1    T1_SPEC.pdf
82                                                 (`normal' Type 1 font)
83 MAC  ---     PS     TYPE_1  ---        type1    T1_SPEC.pdf
84                                                 (`normal' Type 1 font)
85 ---  ---     PS     TYPE_1  CID        cid      PLRM.pdf (CID Font Type 0;
86                                                 Type 9 font)
87 ---  ---     PS     MM      ---        type1    5015.Type1_Supp.pdf
88                                                 (Multiple Masters)
89 ---  ---     PS     CFF     ---        cff      5176.CFF.pdf (`pure' CFF)
90 ---  ---     PS     CFF     CID        cff      5176.CFF.pdf (`pure' CFF)
91 ---  ---     PS     CFF     SYNTHETIC  ---      5176.CFF.pdf (`pure' CFF)
92 ---  PS      PS     CFF     ---        ---      PLRM.pdf (Type 2) [1]
93 ---  PS      PS     CFF     CID        ---      PLRM.pdf (Type 2) [1]
94 ---  PS      PS     CFF     SYNTHETIC  ---      PLRM.pdf (Type 2) [1]
95 ---  ---     PS     ---     TYPE_0     ---      PLRM.pdf
96 ---  ---     PS     TYPE_3  ---        ---      PLRM.pdf (never supported)
97 ---  ---     PS     TYPE_3  CID        ---      PLRM.pdf (CID Font Type 1;
98                                                 Type 10 font; never supported)
99 ---  PS      PS     TYPE_14 ---        ---      PLRM.pdf (Chameleon font;
100                                                 Type 14 font; never supported?)
101 ---  ---     PS     TYPE_32 CID        ---      PLRM.pdf (CID Font Type 4;
102                                                 Type 32 font; never supported?)
103 ---  PS      TT     ---     ---        type42   5012.Type42_Spec.pdf
104                                                 (Type 42 font)
105 ---  PS      TT     ---     CID        ---      PLRM.pdf (CID Font Type 2;
106                                                 Type 11 font)
109 ---  ?       ?      CEF     ?          cff      ?
112 ---  ---     PCF    ---     ---        pcf      X11
113 ---  LZW     PCF    ---     ---        pcf      X11
116 ---  ---     PFR    PFR0    ---        pfr      [2]
117 ---  ---     PFR    PFR1    ---        ---      (undocumented, proprietary;
118                                                 probably never supported)
121 ---  ---     WINFNT ---     ---        winfonts MS Windows 3 Developer's Notes
122 ---  ---     WINFNT VECTOR  ---        ---      MS Windows 3 Developer's Notes
125 [1] Support should be rather simple since this is identical to `CFF' but
126     in a PS wrapper.
128 [2] Official PFR specification:
130       http://www.bitstream.com/categories/developer/truedoc/pfrspec.html
131       http://www.bitstream.com/categories/developer/truedoc/pfrspec1.2.pdf
133     The  syntax of  the  auxiliary data  is  not defined  there, but  is
134     partially defined in  MHP 1.0.3 (also called ETSI  TS 101812 V1.3.1)
135     section 7.4.
137       http://www.etsi.org/
138       http://webapp.etsi.org/workprogram/Report_WorkItem.asp?WKI_ID=18799
140     (free registration required).
142 ------------------------------------------------------------------------
144 Copyright 2004, 2005 by
145 David Turner, Robert Wilhelm, and Werner Lemberg.
147 This  file is  part  of the  FreeType  project, and  may  only be  used,
148 modified,  and  distributed under  the  terms  of  the FreeType  project
149 license, LICENSE.TXT.  By continuing  to use, modify, or distribute this
150 file  you indicate that  you have  read the  license and  understand and
151 accept it fully.
154 --- end of formats.txt ---