misc/libfreetype/docs/formats.txt
changeset 9431 0f5961910e27
parent 9357 a501f5ec7b34
parent 9429 7a97a554ac80
child 9433 f0a8ac191839
equal deleted inserted replaced
9357:a501f5ec7b34 9431:0f5961910e27
     1 This  file  contains a  list  of various  font  formats.   It gives  the
       
     2 reference document and whether it is supported in FreeType 2.
       
     3 
       
     4 
       
     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.
       
    10 
       
    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),
       
    15     `LZW' (compressed with either `gzip' or `compress'), and
       
    16     `BZ2' (compressed with `bzip2`).
       
    17 
       
    18   font format:
       
    19     How the font  is to be accessed, possibly  after converting the file
       
    20     type and  wrapper format  into a generic  form.  Bitmap  formats are
       
    21     `BDF',  `PCF', and  one  form  of `WINFNT';  all  others are  vector
       
    22     formats.
       
    23 
       
    24   font type:
       
    25     Sub-formats  of the font  format.  `SBIT'  and `MACSBIT'  are bitmap
       
    26     formats, `MM' and `VAR' support optical axes.
       
    27 
       
    28   glyph access:
       
    29     If not specified, the glyph access is `standard' to the font format.
       
    30     Values are  `CID' for CID-keyed  fonts, `SYNTHETIC' for  fonts which
       
    31     are modified  versions of other  fonts by means of  a transformation
       
    32     matrix, `COLLECTION' for collecting  multiple fonts (sharing most of
       
    33     the data) into a single file, and `TYPE_0' for PS fonts which are to
       
    34     be accessed in a tree-like structure.
       
    35 
       
    36   FreeType driver:
       
    37     The module in  the FreeType library which handles  the specific font
       
    38     format.   A missing entry  means that  FreeType doesn't  support the
       
    39     font format (yet).
       
    40 
       
    41 
       
    42 Please  send  additions  and/or  corrections  to wl@gnu.org  or  to  the
       
    43 FreeType developer's list  at freetype-devel@nongnu.org (for subscribers
       
    44 only).   If you  can provide  a font  example for  a format  which isn't
       
    45 supported yet please send a mail too.
       
    46 
       
    47 
       
    48 file wrapper font   font    glyph      FreeType reference
       
    49 type format  format type    access     driver   documents
       
    50 ----------------------------------------------------------------------------
       
    51 
       
    52 ---  ---     BDF    ---     ---        bdf      5005.BDF_Spec.pdf, X11
       
    53 
       
    54 
       
    55 ---  SFNT    PS     TYPE_1  ---        type1    Type 1 GX Font Format
       
    56                                                 (for the Mac) [3]
       
    57 MAC  SFNT    PS     TYPE_1  ---        type1    Type 1 GX Font Format
       
    58                                                 (for the Mac) [3]
       
    59 ---  SFNT    PS     TYPE_1  CID        cid      5180.sfnt.pdf (for the Mac)
       
    60                                                 [3]
       
    61 MAC  SFNT    PS     TYPE_1  CID        cid      5180.sfnt.pdf (for the Mac)
       
    62                                                 [3]
       
    63 ---  SFNT    PS     CFF     ---        cff      OT spec, 5176.CFF.pdf
       
    64                                                 (`OTTO' format)
       
    65 MAC  SFNT    PS     CFF     ---        cff      OT spec, 5176.CFF.pdf
       
    66                                                 (`OTTO' format)
       
    67 ---  SFNT    PS     CFF     CID        cff      OT spec, 5176.CFF.pdf
       
    68 MAC  SFNT    PS     CFF     CID        cff      OT spec, 5176.CFF.pdf
       
    69 ---  SFNT    PS     CFF     SYNTHETIC  ---      OT spec, 5176.CFF.pdf
       
    70 MAC  SFNT    PS     CFF     SYNTHETIC  ---      OT spec, 5176.CFF.pdf
       
    71 ---  SFNT    TT     SBIT    ---        sfnt     XFree86 (bitmaps only;
       
    72                                                 with `head' table)
       
    73 ---  SFNT    TT     MACSBIT ---        sfnt     OT spec (for the Mac;
       
    74                                                 bitmaps only; `bhed' table)
       
    75 MAC  SFNT    TT     MACSBIT ---        sfnt     OT spec (for the Mac;
       
    76                                                 bitmaps only; `bhed' table)
       
    77 ---  SFNT    TT     ---     ---        truetype OT spec (`normal' TT font)
       
    78 MAC  SFNT    TT     ---     ---        truetype OT spec (`normal' TT font)
       
    79 MAC  SFNT    TT     VAR     ---        truetype GX spec (`?var' tables)
       
    80 ---  SFNT    TT     ---     COLLECTION truetype OT spec (this can't be CFF)
       
    81 MAC  SFNT    TT     ---     COLLECTION truetype OT spec (this can't be CFF)
       
    82 
       
    83 
       
    84 ---  ---     PS     TYPE_1  ---        type1    T1_SPEC.pdf
       
    85                                                 (`normal' Type 1 font)
       
    86 MAC  ---     PS     TYPE_1  ---        type1    T1_SPEC.pdf
       
    87                                                 (`normal' Type 1 font)
       
    88 ---  ---     PS     TYPE_1  CID        cid      PLRM.pdf (CID Font Type 0;
       
    89                                                 Type 9 font)
       
    90 ---  ---     PS     MM      ---        type1    5015.Type1_Supp.pdf
       
    91                                                 (Multiple Masters)
       
    92 ---  ---     PS     CFF     ---        cff      5176.CFF.pdf (`pure' CFF)
       
    93 ---  ---     PS     CFF     CID        cff      5176.CFF.pdf (`pure' CFF)
       
    94 ---  ---     PS     CFF     SYNTHETIC  ---      5176.CFF.pdf (`pure' CFF)
       
    95 ---  PS      PS     CFF     ---        ---      PLRM.pdf (Type 2) [1]
       
    96 ---  PS      PS     CFF     CID        ---      PLRM.pdf (Type 2) [1]
       
    97 ---  PS      PS     CFF     SYNTHETIC  ---      PLRM.pdf (Type 2) [1]
       
    98 ---  ---     PS     ---     TYPE_0     ---      PLRM.pdf
       
    99 ---  ---     PS     TYPE_3  ---        ---      PLRM.pdf (never supported)
       
   100 ---  ---     PS     TYPE_3  CID        ---      PLRM.pdf (CID Font Type 1;
       
   101                                                 Type 10 font; never supported)
       
   102 ---  PS      PS     TYPE_14 ---        ---      PLRM.pdf (Chameleon font;
       
   103                                                 Type 14 font; never supported?)
       
   104 ---  ---     PS     TYPE_32 CID        ---      PLRM.pdf (CID Font Type 4;
       
   105                                                 Type 32 font; never supported?)
       
   106 ---  PS      TT     ---     ---        type42   5012.Type42_Spec.pdf
       
   107                                                 (Type 42 font)
       
   108 ---  PS      TT     ---     CID        ---      PLRM.pdf (CID Font Type 2;
       
   109                                                 Type 11 font)
       
   110 
       
   111 
       
   112 ---  ?       ?      CEF     ?          cff      ?
       
   113 
       
   114 
       
   115 ---  ---     PCF    ---     ---        pcf      X11 [4]
       
   116 ---  LZW     PCF    ---     ---        pcf      X11 [4]
       
   117 ---  BZ2     PCF    ---     ---        pcf      X11 [4]
       
   118 
       
   119 
       
   120 ---  ---     PFR    PFR0    ---        pfr      [2]
       
   121 ---  ---     PFR    PFR1    ---        ---      (undocumented, proprietary;
       
   122                                                 probably never supported)
       
   123 
       
   124 
       
   125 ---  ---     WINFNT ---     ---        winfonts MS Windows 3 Developer's Notes
       
   126 ---  ---     WINFNT VECTOR  ---        ---      MS Windows 3 Developer's Notes
       
   127 
       
   128 
       
   129 [1] Support should be rather simple since this is identical to `CFF' but
       
   130     in a PS wrapper.
       
   131 
       
   132 [2] Official PFR specification:
       
   133 
       
   134       http://www.bitstream.com/categories/developer/truedoc/pfrspec.html
       
   135       http://www.bitstream.com/categories/developer/truedoc/pfrspec1.2.pdf
       
   136 
       
   137     The  syntax of  the  auxiliary data  is  not defined  there, but  is
       
   138     partially defined in  MHP 1.0.3 (also called ETSI  TS 101812 V1.3.1)
       
   139     section 7.4.
       
   140 
       
   141       http://www.etsi.org/
       
   142       http://webapp.etsi.org/workprogram/Report_WorkItem.asp?WKI_ID=18799
       
   143 
       
   144     (free registration required).
       
   145 
       
   146 [3] Support is rudimentary currently; some tables are not loaded yet.
       
   147 
       
   148 [4] See
       
   149 
       
   150       THE X WINDOW SYSTEM SERVER: X VERSION 11, RELEASE 5
       
   151       Elias Israel, Erik Fortune, Digital Press, 1992
       
   152       ISBN 1-55558-096-3
       
   153 
       
   154     for a specification  given in Appendix D on pgs. 436-450.   However,
       
   155     this information  might be out of  date; unfortunately,  there is no
       
   156     PCF  specification available  online, and this book is out of print. 
       
   157     George  Williams deduced  the font  format from the X11  sources and
       
   158     documented it for his FontForge font editor:
       
   159 
       
   160       http://fontforge.sourceforge.net/pcf-format.html
       
   161 
       
   162 ------------------------------------------------------------------------
       
   163 
       
   164 Copyright 2004, 2005, 2008, 2009, 2010 by
       
   165 David Turner, Robert Wilhelm, and Werner Lemberg.
       
   166 
       
   167 This  file is  part  of the  FreeType  project, and  may  only be  used,
       
   168 modified,  and  distributed under  the  terms  of  the FreeType  project
       
   169 license, LICENSE.TXT.  By continuing  to use, modify, or distribute this
       
   170 file  you indicate that  you have  read the  license and  understand and
       
   171 accept it fully.
       
   172 
       
   173 
       
   174 --- end of formats.txt ---