misc/libfreetype/docs/CHANGES
changeset 9431 0f5961910e27
parent 9357 a501f5ec7b34
parent 9429 7a97a554ac80
child 9433 f0a8ac191839
equal deleted inserted replaced
9357:a501f5ec7b34 9431:0f5961910e27
     1 CHANGES BETWEEN 2.4.4 and 2.4.5
       
     2 
       
     3   I. IMPORTANT BUG FIXES
       
     4 
       
     5     - A rendering regression  for second-order Bézier curves  has been
       
     6       fixed, introduced in 2.4.3.
       
     7 
       
     8 
       
     9   II. IMPORTANT CHANGES
       
    10 
       
    11     - If autohinting  is not  explicitly disabled,  FreeType now  uses
       
    12       the autohinter if  a TrueType based font doesn't  contain native
       
    13       hints.
       
    14 
       
    15     - The load flag FT_LOAD_IGNORE_GLOBAL_ADVANCE_WIDTH  has been made
       
    16       redundant and  is simply ignored;  this means that FreeType  now
       
    17       ignores the global advance width value in TrueType fonts.
       
    18 
       
    19 
       
    20   III. MISCELLANEOUS
       
    21 
       
    22     - `FT_Sfnt_Table_Info' can now return the number of SFNT tables of
       
    23       a font.
       
    24 
       
    25     - Support for PCF files compressed with bzip2 has been contributed
       
    26       by Joel  Klinghed.  To  make this  work, the  OS must  provide a
       
    27       bzip2 library.
       
    28 
       
    29     - Bradley  Grainger  contributed  project  and  solution  files in
       
    30       Visual Studio 2010 format.
       
    31 
       
    32     - Again some fixes to better handle broken fonts.
       
    33 
       
    34     - Some improvements to the B/W rasterizer.
       
    35 
       
    36     - Fixes to the cache module to improve robustness.
       
    37 
       
    38 
       
    39 ======================================================================
       
    40 
       
    41 CHANGES BETWEEN 2.4.3 and 2.4.4
       
    42 
       
    43   I. IMPORTANT BUG FIXES
       
    44 
       
    45     - UVS support (TrueType/OpenType cmap format 14) support is fixed.
       
    46       This regression has been introduced in version 2.4.0.
       
    47 
       
    48 
       
    49   II. MISCELLANEOUS
       
    50 
       
    51     - Detect tricky fonts (e.g. MingLiU)  by the lengths and checksums
       
    52       of Type42-persistent subtables (`cvt ', `fpgm', and `prep') when
       
    53       a TrueType font without family name is given.  The previous fix,
       
    54       introduced in 2.4.3,  was too rigorous,  causing many  subsetted
       
    55       fonts (mainly  from PDF files) displayed badly  because FreeType
       
    56       forced  rendering with  the TrueType bytecode engine  instead of
       
    57       the autohinter.
       
    58 
       
    59     - Better support for 64bit platforms.
       
    60 
       
    61     - More fixes to improve handling of broken fonts.
       
    62 
       
    63 
       
    64 ======================================================================
       
    65 
       
    66 CHANGES BETWEEN 2.4.2 and 2.4.3
       
    67 
       
    68   I. IMPORTANT BUG FIXES
       
    69 
       
    70     - Fix rendering of certain cubic, S-shaped arcs.   This regression
       
    71       has been introduced in version 2.4.0.
       
    72 
       
    73 
       
    74   II. MISCELLANEOUS
       
    75 
       
    76     - To  fix  the  above  mentioned  rendering  issue,  a  new spline
       
    77       flattening algorithm  has been  introduced which  speeds up both
       
    78       conic and cubic arcs.
       
    79 
       
    80     - Handling of broken fonts has been further improved.
       
    81 
       
    82 
       
    83 ======================================================================
       
    84 
       
    85 CHANGES BETWEEN 2.4.1 and 2.4.2
       
    86 
       
    87   I. IMPORTANT BUG FIXES
       
    88 
       
    89     - A stack overflow in CFF Type2 CharStrings interpreter is fixed.
       
    90 
       
    91     - Handling Type 42 font deallocation was broken; additionally, the
       
    92       library is now more robust against malformed Type 42 fonts.
       
    93 
       
    94 
       
    95   II. MISCELLANEOUS
       
    96 
       
    97     - Two new functions,  `FT_Reference_Library' (in FT_MODULE_H)  and
       
    98       `FT_Reference_Face'  (in  FT_FREETYPE_H),  have  been  added  to
       
    99       simplify life-cycle management.  A counter gets initialized to 1
       
   100       at the  time an  FT_Library (or  FT_Face) structure  is created.
       
   101       The  two  new   functions  increment  the  respective   counter.
       
   102       `FT_Done_Library' and `FT_Done_Face' then only destroy a library
       
   103       or face if the counter is 1, otherwise they simply decrement the
       
   104       counter. 
       
   105 
       
   106 
       
   107 ======================================================================
       
   108 
       
   109 CHANGES BETWEEN 2.4.0 and 2.4.1
       
   110 
       
   111   I. IMPORTANT CHANGES
       
   112 
       
   113     - A serious bug in the  CFF font module prevented  display of many
       
   114       glyphs in CFF fonts like `MinionPro-Regular.otf'.
       
   115 
       
   116 
       
   117 ======================================================================
       
   118 
       
   119 CHANGES BETWEEN 2.3.12 and 2.4.0
       
   120 
       
   121   I. IMPORTANT CHANGES
       
   122 
       
   123     - Since May  2010, all  patents  regarding  the TrueType  bytecode
       
   124       interpreter have expired worldwide.  Consequently, we now define
       
   125       TT_CONFIG_OPTION_BYTECODE_INTERPRETER by  default (and  undefine
       
   126       TT_CONFIG_OPTION_UNPATENTED_HINTING).
       
   127 
       
   128     - A new function `FT_Library_SetLcdFilterWeights' is available  to
       
   129       adjust the filter weights set by `FT_Library_SetLcdFilter'.
       
   130 
       
   131 
       
   132   II. MISCELLANEOUS
       
   133 
       
   134     - Thanks to many reports from Robert Święcki, FreeType's stability
       
   135       in handling broken or damaged fonts is much improved.
       
   136 
       
   137     - Support  for LCD  filter  control has  been  added to  the  demo
       
   138       programs `ftdiff' and `ftview'.
       
   139 
       
   140 
       
   141 ======================================================================
       
   142 
       
   143 CHANGES BETWEEN 2.3.11 and 2.3.12
       
   144 
       
   145   I. IMPORTANT CHANGES
       
   146 
       
   147     - For  `FT_Open_Face',  new  parameters  are  available  to ignore
       
   148       preferred family names: FT_PARAM_TAG_IGNORE_PREFERRED_FAMILY and
       
   149       FT_PARAM_TAG_IGNORE_PREFERRED_SUBFAMILY.
       
   150 
       
   151 
       
   152   II. MISCELLANEOUS
       
   153 
       
   154     - Support  for  incremental  font  loading  (controlled  with  the
       
   155       FT_CONFIG_OPTION_INCREMENTAL macro) is now active by default.
       
   156 
       
   157     - Better support for vertical metrics.
       
   158 
       
   159     - Various minor bug fixes.
       
   160 
       
   161 
       
   162 ======================================================================
       
   163 
       
   164 CHANGES BETWEEN 2.3.10 and 2.3.11
       
   165 
       
   166   I. IMPORTANT BUG FIXES
       
   167 
       
   168     - Version 2.3.10 broke PCF support.
       
   169 
       
   170 
       
   171 ======================================================================
       
   172 
       
   173 CHANGES BETWEEN 2.3.10 and 2.3.9
       
   174 
       
   175   I. IMPORTANT BUG FIXES
       
   176 
       
   177     - If all  ASCII digits in a  font have the  same (unscaled) width,
       
   178       the autohinter respects this and won't change it.
       
   179 
       
   180     - TrueType fonts  are now  rasterized correctly  if the horizontal
       
   181       and vertical resolution differ.
       
   182 
       
   183     - Type 1 fonts are now handled with increased precision internally
       
   184       to avoid serious rounding issues if non-integral coordinates are
       
   185       encountered.
       
   186 
       
   187     - Horizontally  condensed CFF  fonts (using the font  matrix) were
       
   188       rendered  incorrectly.   This  bug  has  been  introduced  after
       
   189       release 2.3.5.
       
   190 
       
   191 
       
   192   II. IMPORTANT CHANGES
       
   193 
       
   194     - Support for the SFNT cmap 13 table format (as defined by the new
       
   195       OpenType 1.6 specification) has been added.
       
   196 
       
   197     - B/W rasterization  of well-hinted TrueType  fonts at small sizes
       
   198       has been greatly improved.
       
   199 
       
   200     - Calculation  of  vertical  metrics in  OpenType  fonts has  been
       
   201       improved.
       
   202 
       
   203 
       
   204   III. MISCELLANEOUS
       
   205 
       
   206     - It  is now  possible to  change  the emboldening  factor in  the
       
   207       `ftview' demo program with keys `e' and `E'.
       
   208 
       
   209     - It is  now possible  to change the  slant value in  the `ftview'
       
   210       demo program with keys `s' and `S'.
       
   211 
       
   212     - The  5-levels  grayscale  mode of  the `ftraster'  module (which
       
   213       FreeType doesn't use by default) was broken since version 2.3.0.
       
   214 
       
   215     - Compilation of the  `ftgrays' and `ftraster' modules  was broken
       
   216       in stand-alone mode.
       
   217 
       
   218     - Various fixes for compilation on 64bit and 16bit architectures.
       
   219 
       
   220 
       
   221 ======================================================================
       
   222 
       
   223 CHANGES BETWEEN 2.3.9 and 2.3.8
       
   224 
       
   225   I. IMPORTANT BUG FIXES
       
   226 
       
   227     - Very unfortunately, FreeType 2.3.8 contained a change that broke
       
   228       its  official ABI.  The  end result  is  that programs  compiled
       
   229       against previous versions of the library, but dynamically linked
       
   230       to  2.3.8 can  experience  memory corruption  if  they call  the
       
   231       `FT_Get_PS_Font_Info' function.
       
   232 
       
   233       We recommend all users to  upgrade to 2.3.9 as soon as possible,
       
   234       or to downgrade to a previous  release of the library if this is
       
   235       not an option.
       
   236 
       
   237       The  origin of the  bug is  that a  new field  was added  to the
       
   238       publicly  defined  `PS_FontInfoRec'  structure.   Unfortunately,
       
   239       objects of this  type can be stack or  heap allocated by callers
       
   240       of   `FT_Get_PS_Font_Info',  resulting   in   a  memory   buffer
       
   241       overwrite with its implementation in 2.3.8.
       
   242 
       
   243       If  you want to  know whether  your code  is vulnerable  to this
       
   244       issue,  simply  search  for  the  substrings  `PS_FontInfo'  and
       
   245       `PS_Font_Info' in your source code.  If none is found, your code
       
   246       is safe and is not affected.
       
   247 
       
   248       The FreeType team apologizes for the problem.
       
   249 
       
   250     - The POSIX support  of MacOS resource-fork fonts  (Suitcase fonts
       
   251       and LaserWriter Type1 PostScript fonts) was broken in 2.3.8.  If
       
   252       FreeType2 is built without Carbon framework, these fonts are not
       
   253       handled correctly.  Version 2.3.7 didn't have this bug.
       
   254 
       
   255     - `FT_Get_Advance' (and `FT_Get_Advances') returned bad values for
       
   256       almost all font formats except TrueType fonts.
       
   257 
       
   258     - Fix a bug  in the SFNT  kerning table  loader/parser which could
       
   259       crash the engine if certain malformed tables were encountered.
       
   260 
       
   261     - Composite SFNT bitmaps are now handled correctly.
       
   262 
       
   263 
       
   264   II. IMPORTANT CHANGES
       
   265 
       
   266     - The   new  functions   `FT_Get_CID_Is_Internally_CID_keyed'  and
       
   267       `FT_Get_CID_From_Glyph_Index'  can be  used to  access CID-keyed
       
   268       CFF fonts  via CID  values.  This code  has been  contributed by
       
   269       Michael Toftdal.
       
   270 
       
   271 
       
   272   III. MISCELLANEOUS
       
   273 
       
   274     - `FT_Outline_Get_InsideBorder'  returns   FT_STROKER_BORDER_RIGHT
       
   275       for empty outlines.  This was incorrectly documented.
       
   276 
       
   277     - The `ftview' demo program now supports UTF-8 encoded strings.
       
   278 
       
   279 
       
   280 ======================================================================
       
   281 
       
   282 CHANGES BETWEEN 2.3.8 and 2.3.7
       
   283 
       
   284   I. IMPORTANT BUG FIXES
       
   285 
       
   286     - CID-keyed fonts in an SFNT wrapper were not handled correctly.
       
   287 
       
   288     - The smooth renderer produced truncated images (on the right) for
       
   289       outline parts with negative horizontal values.  Most fonts don't
       
   290       contain outlines left  to the y coordinate axis, but  the effect
       
   291       was very noticeable for outlines processed with FT_Glyph_Stroke,
       
   292       using thick strokes.
       
   293 
       
   294     - `FT_Get_TrueType_Engine_Type'  returned a  wrong  value if  both
       
   295       configuration  macros  TT_CONFIG_OPTION_BYTECODE_INTERPRETER and
       
   296       TT_CONFIG_OPTION_UNPATENTED_HINTING were defined.
       
   297 
       
   298     - The  `face_index'  field  in   the  `FT_Face'  structure  wasn't
       
   299       initialized properly after calling FT_Open_Face and friends with
       
   300       a positive face index for CFFs,  WinFNTs, and, most importantly,
       
   301       for TrueType Collections (TTCs).
       
   302 
       
   303 
       
   304   II. IMPORTANT CHANGES
       
   305 
       
   306     - Rudimentary support for Type 1  fonts and CID-keyed Type 1 fonts
       
   307       in an SFNT wrapper has been  added -- such fonts are used on the
       
   308       Mac.  The core  SFNT tables `TYP1' and `CID '  are passed to the
       
   309       PS Type 1  and CID-keyed PS font drivers;  other tables (`ALMX',
       
   310       `BBOX', etc.) are not supported yet.
       
   311 
       
   312     - A  new interface  to extract  advance values  of glyphs  without
       
   313       loading their outlines has been added.  The functions are called
       
   314       `FT_Get_Advance' and `FT_Get_Advances'; they are defined in file
       
   315       `ftadvanc.h' (to be accessed as FT_ADVANCES_H).
       
   316 
       
   317     - A new function `FT_Get_FSType_Flags' (in FT_FREETYPE_H) has been
       
   318       contributed  by   David  Bevan  to  access   the  embedding  and
       
   319       subsetting restriction information of fonts.
       
   320 
       
   321 
       
   322   III. MISCELLANEOUS
       
   323 
       
   324     - FT_MulFix is now an inlined function; by default, assembler code
       
   325       is provided for x86 and ARM.  See FT_CONFIG_OPTION_INLINE_MULFIX
       
   326       and FT_CONFIG_OPTION_NO_ASSEMBLER (in ftoption.h) for more.
       
   327 
       
   328     - The handling of `tricky' fonts  (this is, fonts which don't work
       
   329       with the  autohinter, needing the font  format's hinting engine)
       
   330       has been generalized and changed slightly:
       
   331 
       
   332       . A new  face flag  FT_FACE_FLAG_TRICKY indicates that  the font
       
   333         format's  hinting engine is  necessary for  correct rendering.
       
   334         The macro FT_IS_TRICKY can be used to check this flag.
       
   335 
       
   336       . FT_LOAD_NO_HINTING is now ignored for tricky fonts.  To really
       
   337         force  raw  loading  of  such fonts  (without  hinting),  both
       
   338         FT_LOAD_NO_HINTING  and FT_LOAD_NO_AUTOHINT  must  be used  --
       
   339         this is something which you probably never want to do.
       
   340 
       
   341       . Tricky  TrueType fonts  always use  the  bytecode interpreter,
       
   342         either the patented or unpatented version.
       
   343 
       
   344     - The  function  `FT_GlyphSlot_Own_Bitmap'  has  been  moved  from
       
   345       FT_SYNTHESIS_H to FT_BITMAP_H; it  is now part of the `official'
       
   346       API.   (The functions  in  FT_SYNTHESIS_H are  still subject  to
       
   347       change, however.)
       
   348 
       
   349     - In the  `ftdiff'  demo  program you  can now  toggle the  use of
       
   350       FT_LOAD_IGNORE_GLOBAL_ADVANCE_WIDTH with key `a'.
       
   351 
       
   352 
       
   353 ======================================================================
       
   354 
       
   355 CHANGES BETWEEN 2.3.7 and 2.3.6
       
   356 
       
   357   I. IMPORTANT BUG FIXES
       
   358 
       
   359     - If the library  was compiled on an i386  platform using gcc, and
       
   360       compiler  option -O3 was  given, `FT_MulFix'  sometimes returned
       
   361       incorrect  results   which  could  have   caused  problems  with
       
   362       `FT_Request_Metrics'   and  `FT_Select_Metrics',   returning  an
       
   363       incorrect descender size.
       
   364 
       
   365     - Pure CFFs without  subfonts were scaled incorrectly  if the font
       
   366       matrix  was  non-standard.  This  bug  has  been  introduced  in
       
   367       version 2.3.6.
       
   368 
       
   369     - The  `style_name'  field  in  the  `FT_FaceRec'  structure often
       
   370       contained  a wrong  value for  Type 1  fonts.  This misbehaviour
       
   371       has been  introduced  in  version  2.3.6  while  trying  to  fix
       
   372       another   problem.   [Note,  however,   that   this   value   is
       
   373       informative only  since  the  used  algorithm to  extract  it is
       
   374       very simplistic.]
       
   375 
       
   376 
       
   377   II. IMPORTANT CHANGES
       
   378 
       
   379     - Two      new      macros,      FT_OUTLINE_SMART_DROPOUTS     and
       
   380       FT_OUTLINE_EXCLUDE_STUBS,  have been introduced.   Together with
       
   381       FT_OUTLINE_IGNORE_DROPOUTS (which  was ignored previously) it is
       
   382       now possible to control the dropout mode  of the `raster' module
       
   383       (for B&W rasterization),   using  the   `flags'  field   in  the
       
   384       `FT_Outline' structure.
       
   385 
       
   386     - The TrueType bytecode interpreter now passes the dropout mode to
       
   387       the B&W rasterizer.  This greatly increases the output for small
       
   388       ppem values of many fonts like `pala.ttf'.
       
   389 
       
   390 
       
   391 ======================================================================
       
   392 
       
   393 CHANGES BETWEEN 2.3.6 and 2.3.5
       
   394 
       
   395   I. IMPORTANT BUG FIXES
       
   396 
       
   397     - A  bunch of  potential security  problems have  been found.  All
       
   398       users should update.
       
   399 
       
   400     - Microsoft  Unicode  cmaps  in  TrueType  fonts  are  now  always
       
   401       preferred over Apple cmaps.  This is not a bug per se, but there
       
   402       exist some buggy  fonts created for MS which  have broken  Apple
       
   403       cmaps.  This affects  only the automatic  selection of FreeType;
       
   404       it's always possible to manually select an Apple Unicode cmap if
       
   405       desired.
       
   406 
       
   407     - Many bug fixes to the TrueType bytecode interpreter.
       
   408 
       
   409     - Improved Mac support.
       
   410 
       
   411     - Subsetted CID-keyed CFFs are now supported correctly.
       
   412 
       
   413     - CID-keyed CFFs with subfonts which are scaled in a  non-standard
       
   414       way are now handled correctly.
       
   415 
       
   416     - A call to FT_Open_Face with `face_index' < 0 crashed FreeType if
       
   417       the font was a Windows (bitmap) FNT/FON.
       
   418 
       
   419 
       
   420   II. IMPORTANT CHANGES
       
   421 
       
   422     - The new function `FT_Get_CID_Registry_Ordering_Supplement' gives
       
   423       access to  those fields in a CID-keyed font.  The code  has been
       
   424       contributed by Derek Clegg.
       
   425 
       
   426     - George Williams  contributed  code  to validate  the new  `MATH'
       
   427       OpenType  table (within  the `otvalid'  module).  The  `ftvalid'
       
   428       demo program has been extended accordingly.
       
   429 
       
   430     - An API for cmap 14 support  (for Unicode Variant Selectors, UVS)
       
   431       has been contributed by George Williams.
       
   432 
       
   433     - A new face flag FT_FACE_FLAG_CID_KEYED has been added,  together
       
   434       with a macro FT_IS_CID_KEYED which evaluates to 1 if the font is
       
   435       CID-keyed.
       
   436 
       
   437 
       
   438   III. MISCELLANEOUS
       
   439 
       
   440     - Build support for symbian has been contributed.
       
   441 
       
   442     - Better WGL4 glyph name support, contributed by Sergey Tolstov.
       
   443 
       
   444     - Debugging output of the  various FT_TRACEX macros is now sent to
       
   445       stderr.
       
   446 
       
   447     - The `ftview' demo program now provides artificial slanting too.
       
   448 
       
   449     - The `ftvalid' demo  program has a new  option `-f' to select the
       
   450       font index.
       
   451 
       
   452 
       
   453 ======================================================================
       
   454 
       
   455 CHANGES BETWEEN 2.3.5 and 2.3.4
       
   456 
       
   457   I. IMPORTANT BUG FIXES
       
   458 
       
   459     - Some subglyphs in TrueType fonts were handled incorrectly due to
       
   460       a missing graphics state reinitialization.
       
   461 
       
   462     - Large .Z files  (as distributed with some X11  packages) weren't
       
   463       handled correctly, making FreeType increase the heap stack in an
       
   464       endless loop.
       
   465 
       
   466     - A large  number of  bugs have  been fixed  to avoid  crashes and
       
   467       endless loops with invalid fonts.
       
   468 
       
   469 
       
   470   II. IMPORTANT CHANGES
       
   471 
       
   472     - The  two new  cache functions  `FTC_ImageCache_LookupScaler' and
       
   473       `FTC_SBit_Cache_LookupScaler' have been added to allow lookup of
       
   474       glyphs using an  `FTC_Scaler' object;  this makes it possible to
       
   475       use fractional pixel sizes in the cache.  The demo programs have
       
   476       been updated accordingly to use this feature.
       
   477 
       
   478     - A new API  `FT_Get_CMap_Format' has been added to  get the  cmap
       
   479       format  of a  TrueType font.   This  is useful  in handling  PDF
       
   480       files.  The code has been contributed by Derek Clegg.
       
   481 
       
   482     - The  auto-hinter  now  produces  better  output  by  default for
       
   483       non-Latin scripts  like Indic.   This was done by  using the CJK
       
   484       hinting module  as the default instead of the Latin one.  Thanks
       
   485       to Rahul Bhalerao for this suggestion.
       
   486 
       
   487     - A new API `FT_Face_CheckTrueTypePatents'  has been added to find
       
   488       out  whether  a  given  TrueType  font  uses  patented  bytecode
       
   489       instructions.   The  `ft2demos' bundle  contains a  new  program
       
   490       called `ftpatchk' which demonstrates its usage.
       
   491 
       
   492     - A  new  API  `FT_Face_SetUnpatentedHinting'  has  been  added to
       
   493       enable or disable the unpatented hinter.
       
   494 
       
   495     - Support for Windows FON files in PE format  has been contributed
       
   496       by Dmitry Timoshkov.
       
   497 
       
   498 
       
   499   III. MISCELLANEOUS
       
   500 
       
   501     - Vincent Richomme contributed Visual C++ project files for Pocket
       
   502       PCs.
       
   503 
       
   504 
       
   505 ======================================================================
       
   506 
       
   507 CHANGES BETWEEN 2.3.4 and 2.3.3
       
   508 
       
   509   I. IMPORTANT BUG FIXES
       
   510 
       
   511     - A serious  bug  in  the  handling  of bitmap  fonts (and  bitmap
       
   512       strikes of outline fonts) has been introduced in 2.3.3.
       
   513 
       
   514 
       
   515 ======================================================================
       
   516 
       
   517 CHANGES BETWEEN 2.3.3 and 2.3.2
       
   518 
       
   519   I. IMPORTANT BUG FIXES
       
   520 
       
   521     - Remove a serious regression in the TrueType bytecode interpreter
       
   522       that was introduced  in version 2.3.2.  Note that  this does not
       
   523       disable  the  improvements  introduced  to  the  interpreter  in
       
   524       version 2.3.2,  only some ill  cases that occurred  with certain
       
   525       fonts (though a few popular ones).
       
   526 
       
   527     - The auto-hinter now  ignores single-point contours for computing
       
   528       blue zones.   This bug  created `wavy' baselines  when rendering
       
   529       text  with  various  fonts  that  use these  contours  to  model
       
   530       mark-attach points  (these are points that  are never rasterized
       
   531       and are placed outside of the glyph's real outline).
       
   532 
       
   533     - The `rsb_delta' and `lsb_delta' glyph slot fields are now set to
       
   534       zero for mono-spaced fonts.  Otherwise code that uses them would
       
   535       essentially ruin the fixed-advance property.
       
   536 
       
   537     - Fix  CVE-2007-1351 which  can  cause an  integer overflow  while
       
   538       parsing  BDF fonts,  leading to  a potentially  exploitable heap
       
   539       overflow condition.
       
   540 
       
   541 
       
   542   II. MISCELLANEOUS
       
   543 
       
   544     - Fixed compilation issues on some 64-bit platforms (see ChangeLog
       
   545       for details).
       
   546 
       
   547     - A new demo  program `ftdiff' has been added  to compare TrueType
       
   548       hinting, FreeType's auto  hinting, and rendering without hinting
       
   549       in three columns.
       
   550 
       
   551 
       
   552 ======================================================================
       
   553 
       
   554 CHANGES BETWEEN 2.3.2 and 2.3.1
       
   555 
       
   556   I. IMPORTANT BUG FIXES
       
   557 
       
   558     - FreeType  returned incorrect  kerning information  from TrueType
       
   559       fonts when the bytecode  interpreter was enabled.  This happened
       
   560       due to a typo introduced in version 2.3.0.
       
   561 
       
   562     - Negative  kerning  values  from   PFM  files  are  now  reported
       
   563       correctly  (they were read  as 16-bit  unsigned values  from the
       
   564       file).
       
   565 
       
   566     - Fixed  a small  memory leak  when `FT_Init_FreeType'  failed for
       
   567       some reason.
       
   568 
       
   569     - The Postscript hinter placed and sized very thin and ghost stems
       
   570       incorrectly.
       
   571 
       
   572     - The TrueType bytecode  interpreter has been fixed to  get rid of
       
   573       most of the  rare differences seen in comparison  to the Windows
       
   574       font loader.
       
   575 
       
   576 
       
   577   II. IMPORTANT CHANGES
       
   578 
       
   579     - The auto-hinter  now better deals  with serifs and  corner cases
       
   580       (e.g.,  glyph '9'  in Arial  at 9pt,  96dpi).  It  also improves
       
   581       spacing  adjustments and doesn't  change widths  for non-spacing
       
   582       glyphs.
       
   583 
       
   584     - Many   Mac-specific   functions   are  deprecated   (but   still
       
   585       available);  modern replacements  have been  provided  for them.
       
   586       See the documentation in file `ftmac.h'.
       
   587 
       
   588 
       
   589 ======================================================================
       
   590 
       
   591 CHANGES BETWEEN 2.3.1 and 2.3.0
       
   592 
       
   593   I. IMPORTANT BUG FIXES
       
   594 
       
   595     - The TrueType interpreter sometimes returned incorrect horizontal
       
   596       metrics due to a bug in the handling of the SHZ instruction.
       
   597 
       
   598     - A typo  in  a  security  check  introduced  after  version 2.2.1
       
   599       prevented FreeType to render some glyphs in CFF fonts.
       
   600 
       
   601 
       
   602 ======================================================================
       
   603 
       
   604 CHANGES BETWEEN 2.3.0 and 2.2.1
       
   605 
       
   606   I. IMPORTANT BUG FIXES
       
   607 
       
   608     - The  PCF font  loader  is  now much  more  robust while  loading
       
   609       malformed font files.
       
   610 
       
   611     - Various memory leaks have been found and fixed.
       
   612 
       
   613     - The TrueType name loader now deals properly with some fonts that
       
   614       encode their  names in UTF-16 (the specification  was vague, and
       
   615       the code incorrectly assumed UCS-4).
       
   616 
       
   617     - Fixed the TrueType bytecode  loader to deal properly with subtle
       
   618       monochrome/gray  issues  when   scaling  the  CVT.   Some  fonts
       
   619       exhibited bad rendering artifacts otherwise.
       
   620 
       
   621     - `FT_GlyphSlot_Embolden' now  supports vertical layouts correctly
       
   622       (it mangled the vertical advance height).
       
   623 
       
   624     - Fixed byte  endian issues  of `ftmac.c' to  support Mac OS  X on
       
   625       i386.
       
   626 
       
   627     - The  PFR  font loader  no  longer  erroneously  tags font  files
       
   628       without any outlines as FT_FACE_FLAG_SCALABLE.
       
   629 
       
   630 
       
   631   II. NEW API FUNCTIONS
       
   632 
       
   633     - `FT_Library_SetLcdFilter' allows you  to select a special filter
       
   634       to be  applied to the bitmaps generated  by `FT_Render_Glyph' if
       
   635       one of the FT_RENDER_MODE_LCD and FT_RENDER_MODE_LCD_V modes has
       
   636       been  selected.  This filter  is used  to reduce  color fringes;
       
   637       several  settings are  available  through the  FT_LCD_FILTER_XXX
       
   638       enumeration.
       
   639 
       
   640       Its  declaration   and  documentation  can  be   found  in  file
       
   641       `include/freetype/ftlcdfil.h'   (to  be   accessed   with  macro
       
   642       FT_LCD_FILTER_H).
       
   643 
       
   644       *IMPORTANT*:     This      function     returns     an     error
       
   645       (FT_Err_Unimplemented_Feature) in default  builds of the library
       
   646       for patent reasons.  See below.
       
   647 
       
   648     - `FT_Get_Gasp'  allows you  to query  the flags  of  the TrueType
       
   649       `gasp' table for  a given character pixel size.   This is useful
       
   650       to duplicate  the text rendering  of MS Windows when  the native
       
   651       bytecode  interpreter is  enabled (which  isn't the  default for
       
   652       other patent reasons).
       
   653 
       
   654       Its  declaration   and  documentation  can  be   found  in  file
       
   655       `include/freetype/ftgasp.h'   (to   be   accessed   with   macro
       
   656       FT_GASP_H).
       
   657 
       
   658 
       
   659   III. IMPORTANT CHANGES
       
   660 
       
   661     - The auto-hinter has been tuned a lot to improve its results with
       
   662       serif fonts, resulting in much better font rendering of many web
       
   663       pages.
       
   664 
       
   665     - The unpatented  hinter is now part  of the default  build of the
       
   666       library; we  have added  code to automatically  support `tricky'
       
   667       fonts that need it.
       
   668 
       
   669       This means  that FreeType should `just work'  with certain Asian
       
   670       fonts, like  MingLiU, which cannot properly be  loaded without a
       
   671       bytecode interpreter,  but which fortunately  do not use  any of
       
   672       the patented  bytecode opcodes.  We detect these  fonts by name,
       
   673       so please  report any font file  that doesn't seem  to work with
       
   674       FreeType, and  we shall do what we  can to support it  in a next
       
   675       release.
       
   676 
       
   677       Note  that  the API  hasn't  changed,  so  you can  still  force
       
   678       unpatented hinting with a special parameter to `FT_Open_Face' as
       
   679       well.  This  might be useful in  same cases; for  example, a PDF
       
   680       reader might present  a user option to activate  it to deal with
       
   681       certain  `tricky'   embedded  fonts  which   cannot  be  clearly
       
   682       identified.
       
   683 
       
   684       If you are  a developer for embedded systems,  you might want to
       
   685       *disable*  the   feature  to  save  code   space  by  undefining
       
   686       TT_CONFIG_OPTION_UNPATENTED_HINTING in file `ftoption.h'.
       
   687 
       
   688     - LCD-optimized rendering is now  *disabled* in all default builds
       
   689       of  the  library,  mainly   due  to  patent  issues.   For  more
       
   690       information see:
       
   691 
       
   692       http://lists.gnu.org/archive/html/freetype/2006-09/msg00064.html
       
   693 
       
   694       A  new  configuration macro  FT_CONFIG_OPTION_SUBPIXEL_RENDERING
       
   695       has been introduced in  `ftoption.h'; manually define it in this
       
   696       file if you want to re-enable the feature.
       
   697 
       
   698       The  change only  affects the  implementation, not  the FreeType
       
   699       API.  This means that clients don't need to be modified, because
       
   700       the library still generates  LCD decimated bitmaps, but with the
       
   701       added constraint that R=G=B on each triplet.
       
   702 
       
   703       The  displayed result  should  be equal  to normal  anti-aliased
       
   704       rendering.
       
   705 
       
   706       Additionally,  if   FT_CONFIG_OPTION_SUBPIXEL_RENDERING  is  not
       
   707       defined, the new  `FT_Library_SetLcdFilter' function returns the
       
   708       FT_Err_Unimplemented_Feature error code.
       
   709 
       
   710     - Some computation bugs in  the TrueType bytecode interpreter were
       
   711       found,  which  allow us  to  get rid  of  very  subtle and  rare
       
   712       differences we had experienced with the Windows renderer.
       
   713 
       
   714     - It is now possible to cross-compile the library easily.  See the
       
   715       file `docs/INSTALL.CROSS' for details.
       
   716 
       
   717     - The file `src/base/ftmac.c' now contains code for Mac OS X only;
       
   718       its  deprecated function  `FT_GetFile_From_Mac_Font_Name' always
       
   719       returns an  error even if the QuickDraw  framework is available.
       
   720       The previous version has been moved to `builds/mac/ftmac.c'.
       
   721 
       
   722       Selecting  configure option `--with-quickdraw-carbon'  makes the
       
   723       build process use the original `ftmac.c' file instead of the Mac
       
   724       OS X-only version.
       
   725 
       
   726 
       
   727   IV. MISCELLANEOUS
       
   728 
       
   729     - Various performance and memory footprint optimizations have been
       
   730       performed on  the TrueType and CFF font  loaders, sometimes with
       
   731       very drastic  benefits (e.g., the  TrueType loader is  now about
       
   732       25% faster;  FreeType should use  less heap memory  under nearly
       
   733       all conditions).
       
   734 
       
   735     - The anti-aliased rasterizer has been optimized and is now 15% to
       
   736       25%  percent  faster than  in  previous  versions, depending  on
       
   737       content.
       
   738 
       
   739     - The Type 1 loader has been improved; as an example, it now skips
       
   740       top-level dictionaries properly.
       
   741 
       
   742     - Better support for Mac  fonts on POSIX systems, plus compilation
       
   743       fixes for Mac OS X on ppc64 where `ftmac.c' cannot be built.
       
   744 
       
   745     - Configuration  without `--with-old-mac-fonts'  does  not include
       
   746       `ftmac.c' (this was the behaviour in FreeType version 2.1.10).
       
   747 
       
   748     - The TrueTypeGX validator (gxvalid) checks the order of glyph IDs
       
   749       in the kern table.
       
   750 
       
   751 
       
   752 ======================================================================
       
   753 
       
   754 CHANGES BETWEEN 2.2.1 and 2.2
       
   755 
       
   756   I. IMPORTANT BUG FIXES
       
   757 
       
   758     - Various integer overflows have been fixed.
       
   759 
       
   760     - PFB fonts with MacOS resource fork weren't  handled correctly on
       
   761       non-MacOS platforms.
       
   762 
       
   763 
       
   764 ======================================================================
       
   765 
       
   766 CHANGES BETWEEN 2.2 and 2.1.10
       
   767 
       
   768 (not released officially)
       
   769 
       
   770   I. IMPORTANT BUG FIXES
       
   771 
       
   772     - Vertical metrics for SFNT fonts were incorrect sometimes.
       
   773 
       
   774     - The FT_HAS_KERNING macro always returned 0.
       
   775 
       
   776     - CFF OpenType  fonts didn't  return correct vertical  metrics for
       
   777       glyphs with outlines.
       
   778 
       
   779     - If FreeType was compiled without hinters, all font formats based
       
   780       on PS outlines weren't scaled correctly.
       
   781 
       
   782 
       
   783   II. IMPORTANT CHANGES
       
   784 
       
   785     - Version 2.2 no longer exposes its internals, this is, the header
       
   786       files  located in  the `include/freetype/internal'  directory of
       
   787       the source package are not  copied anymore by the `make install'
       
   788       command.  Consequently, a number of rogue clients which directly
       
   789       access  FreeType's  internal   functions  and  structures  won't
       
   790       compile without modification.
       
   791 
       
   792       We provide  patches for  most of those  rogue clients.   See the
       
   793       following page for more information:
       
   794 
       
   795         http://www.freetype.org/freetype2/patches/rogue-patches.html
       
   796 
       
   797       Note that, as  a convenience to our Unix  desktop users, version
       
   798       2.2 is *binary* compatible with FreeType 2.1.7, which means that
       
   799       installing this  release on  an existing distribution  shall not
       
   800       break any working desktop.
       
   801 
       
   802     - FreeType's build  mechanism has been redesigned.   With GNU make
       
   803       it  is  now  sufficient  in   most  cases  to  edit  two  files:
       
   804       `modules.cfg',  to  select   the  library  components,  and  the
       
   805       configuration  file  `include/freetype/config/ftoption.h' (which
       
   806       can be copied to the objects directory).  Removing unused module
       
   807       directories   to    prevent   its   compilation    and   editing
       
   808       `include/freetype/config/ftmodule.h' is no longer necessary.
       
   809 
       
   810     - The  LIGHT  hinting algorithm  produces  more pleasant  results.
       
   811       Also, using the  FT_LOAD_TARGET_LIGHT flags within FT_Load_Glyph
       
   812       always forces auto-hinting, as a special exception.  This allows
       
   813       you to experiment with it  even if you have enabled the TrueType
       
   814       bytecode interpreter in your build.
       
   815 
       
   816     - The auto hinter now employs a new algorithm for CJK fonts, based
       
   817       on Akito  Hirai's patch.   Note that this  only works  for fonts
       
   818       with a Unicode charmap at the moment.
       
   819 
       
   820     - The following callback function  types have changed slightly (by
       
   821       adding the `const' keyword where appropriate):
       
   822 
       
   823         FT_Outline_MoveToFunc
       
   824         FT_Outline_LineToFunc
       
   825         FT_Outline_ConicToFunc
       
   826         FT_Outline_CubicToFunc
       
   827         FT_SpanFunc
       
   828         FT_Raster_RenderFunc
       
   829 
       
   830         FT_Glyph_TransformFunc
       
   831         FT_Renderer_RenderFunc
       
   832         FT_Renderer_TransformFunc
       
   833 
       
   834       Note that this doesn't affect binary backward compatibility.
       
   835 
       
   836     - On MacOS,  new APIs have  been added as replacements  for legacy
       
   837       APIs:  `FT_New_Face_From_FSRef'  for  `FT_New_Face_From_FSSpec',
       
   838       and              `FT_GetFile_From_Mac_ATS_Name'              for
       
   839       `FT_GetFile_From_Mac_Name'.  Legacy APIs are still available, if
       
   840       FreeType is built without disabling them.
       
   841 
       
   842     - A new  API `FT_Select_Size'  has been added  to select  a bitmap
       
   843       strike  by its  index.   Code using  other  functions to  select
       
   844       bitmap strikes should be updated to use this function.
       
   845 
       
   846     - A  new API  `FT_Get_SubGlyph_Info'  has been  added to  retrieve
       
   847       subglyph data.  This can be  used by rogue clients which used to
       
   848       access the internal headers to get the corresponding data.
       
   849 
       
   850     - In 2.1.10, the behaviour of `FT_Set_Pixel_Sizes' was changed for
       
   851       BDF/PCF fonts,  and only  for them.  This  causes inconsistency.
       
   852       In this release,  we undo the change.  The  intent of the change
       
   853       in 2.1.10  is to allow  size selection through  real dimensions,
       
   854       which can now be done through `FT_Request_Size'.
       
   855 
       
   856     - Some security  issues were discovered  and fixed in the  CFF and
       
   857       Type  1 loader, causing  crashes of  FreeType by  malformed font
       
   858       files.
       
   859 
       
   860 
       
   861   III. MISCELLANEOUS
       
   862 
       
   863     - The documentation  for FT_LOAD_TARGET_XXX and FT_RENDER_MODE_XXX
       
   864       values now better reflects its usage and differences: One set is
       
   865       used to specify the hinting algorithm, the other to specify  the
       
   866       pixel rendering mode.
       
   867 
       
   868     - `FT_New_Face' and `FT_New_Face_From_FSSpec' in ftmac.c have been
       
   869       changed to count supported scalable faces (sfnt, LWFN) only, and
       
   870       to  return the  number of  available faces  via face->num_faces.
       
   871       Unsupported bitmap faces (fbit, NFNT) are ignored.
       
   872 
       
   873     - builds/unix/configure  has been  improved for  MacOS X.   It now
       
   874       automatically checks available  functions in Carbon library, and
       
   875       prepare to use newest  functions by default.  Options to specify
       
   876       the  dependencies of  each Carbon  APIs (FSSpec,  FSRef, old/new
       
   877       QuickDraw, ATS)  are available too.  By manual  disabling of all
       
   878       QuickDraw   functionality,  FreeType   can   be  built   without
       
   879       `deprecated   function'   warnings    on   MacOS   10.4.x,   but
       
   880       FT_GetFile_Mac_Name  in  ftmac.c  then  is changed  to  a  dummy
       
   881       function, and returns an `unimplemented' error.  For details see
       
   882       builds/mac/README.
       
   883 
       
   884     - SFNT cmap handling has been  improved, mainly to run much faster
       
   885       with CJK fonts.
       
   886 
       
   887     - A   new  function   `FT_Get_TrueType_Engine_Type   (declared  in
       
   888       `FT_MODULE_H')  is  provided  to  determine the  status  of  the
       
   889       TrueType   bytecode  interpreter   compiled  into   the  library
       
   890       (patented, unpatented, unimplemented).
       
   891 
       
   892     - Vertical metrics of glyphs are  synthesized if the font does not
       
   893       provide such information.  You can tell whether  the metrics are
       
   894       synthesized or not by checking the FT_FACE_FLAG_VERTICAL flag of
       
   895       the face.
       
   896 
       
   897     - The demo programs  `ftview' and  `ftstring' have been  rewritten
       
   898       for better readability.   `ftview' has a new switch `-p' to test
       
   899       FT_New_Memory_Face (instead of FT_New_Face).
       
   900 
       
   901     - FreeType now honours bit 1 in the `head' table of TrueType fonts
       
   902       (meaning `left sidebearing point at x=0').  This helps with some
       
   903       buggy fonts.
       
   904 
       
   905     - Rudimentary support for Adobe's new `SING Glyphlet' format.  See
       
   906 
       
   907         http://www.adobe.com/products/indesign/sing_gaiji.html
       
   908 
       
   909       for more information.
       
   910 
       
   911     - The `ftdump'  program from the `ft2demos' bundle  now shows some
       
   912       information about charmaps.  It  also supports a new switch `-v'
       
   913       to increase verbosity.
       
   914 
       
   915     - Better AFM support.  This includes track kerning support.
       
   916 
       
   917 
       
   918 ======================================================================
       
   919 
       
   920 CHANGES BETWEEN 2.1.10 and 2.1.9
       
   921 
       
   922   I. IMPORTANT BUG FIXES
       
   923 
       
   924     - The size comparison for BDF and PCF files could fail sometimes.
       
   925 
       
   926     - Some  CFF files  were still not  loaded  correctly.   Patch from
       
   927       Derek Noonburg.
       
   928 
       
   929     - The stroker still had some serious bugs.
       
   930 
       
   931     - Boris  Letocha  fixed a  bug in  the  TrueType interpreter:  The
       
   932       NPUSHW instruction wasn't skipped correctly in IF clauses.  Some
       
   933       fonts like `Helvetica 75 Bold' failed.
       
   934 
       
   935     - Another  serious  bug  in  handling  TrueType hints  caused many
       
   936       distortions.  It has been introduced in version 2.1.8, and it is
       
   937       highly recommended to upgrade.
       
   938 
       
   939     - FreeType didn't properly parse empty Type 1 glyphs.
       
   940 
       
   941     - An unbound dynamic buffer growth was fixed in the PFR loader.
       
   942 
       
   943     - Several bugs have been fixed in the cache sub-system.
       
   944 
       
   945     - FreeType behaved incorrectly when resizing two distinct but very
       
   946       close character pixel sizes through `FT_Set_Char_Size' (Savannah
       
   947       bug #12263).
       
   948 
       
   949     - The auto-hinter didn't work properly for fonts without a Unicode
       
   950       charmap -- it even refused to load the glyphs.
       
   951 
       
   952 
       
   953   II. IMPORTANT CHANGES
       
   954 
       
   955     - Many fixes have been applied to drastically reduce the amount of
       
   956       heap   memory   used   by   FreeType,   especially   when  using
       
   957       memory-mapped font files  (which is the default on Unix  systems
       
   958       which support them).
       
   959 
       
   960     - The auto-hinter  has been replaced with a new module, called the
       
   961       `auto-fitter'.  It consumes  less memory  than its  predecessor,
       
   962       and it is  prepared to support non-latin scripts  better in next
       
   963       releases.
       
   964 
       
   965     - George Williams  contributed code to read  kerning data from PFM
       
   966       files.
       
   967 
       
   968     - FreeType   now   uses    the   TT_NAME_ID_PREFERRED_FAMILY   and
       
   969       TT_NAME_ID_PREFERRED_SUBFAMILY   strings   (if   available)  for
       
   970       setting  family  and  style in SFNT  fonts  (patch from Kornfeld
       
   971       Eliyahu Peter).
       
   972 
       
   973     - A  new  API `FT_Sfnt_Table_Info'  (in FT_TRUETYPE_TABLES_H)  has
       
   974       been added to retrieve name and size information of SFNT tables.
       
   975 
       
   976     - A new API `FT_OpenType_Validate' (in FT_OPENTYPE_VALIDATE_H) has
       
   977       been added to validate OpenType tables  (BASE, GDEF, GPOS, GSUB,
       
   978       JSTF).   After validation  it is  no longer  necessary to  check
       
   979       for errors in those tables while accessing them.
       
   980 
       
   981       Note that  this module might  be moved to another library in the
       
   982       future  to avoid  a tight  dependency between  FreeType and  the
       
   983       OpenType specification.
       
   984 
       
   985     - A new API in FT_BITMAP_H  (`FT_Bitmap_New', `FT_Bitmap_Convert',
       
   986       `FT_Bitmap_Copy',  `FT_Bitmap_Embolden',  `FT_Bitmap_Done')  has
       
   987       been added.   Its  use is  to convert an  FT_Bitmap structure in
       
   988       1bpp, 2bpp,  4bpp, or 8bpp  format into  another 8bpp FT_Bitmap,
       
   989       probably using a different pitch, and to further manipulate it.
       
   990 
       
   991     - A new  API `FT_Outline_Embolden'  (in FT_OUTLINE_H) gives  finer
       
   992       control how  outlines are embolded.
       
   993 
       
   994     - `FT_GlyphSlot_Embolden' (in FT_SYNTHESIS_H)  now handles bitmaps
       
   995       also (code contributed  by Chia I Wu).  Note that this  function
       
   996       is still experimental and may be replaced with a better API.
       
   997 
       
   998     - The method  how BDF and PCF  bitmap fonts  are accessed has been
       
   999       refined.   Formerly,   FT_Set_Pixel_Sizes  and  FT_Set_Char_Size
       
  1000       were  synonyms in  FreeType's  BDF and PCF interface.  This  has
       
  1001       changed now.  FT_Set_Pixel_Sizes  should be  used to  select the
       
  1002       actual  font dimensions  (the `strike',  which is the sum of the
       
  1003       `FONT_ASCENT'    and    `FONT_DESCENT'    properties),     while
       
  1004       FT_Set_Char_Size  selects  the  `nominal' size  (the `PIXELSIZE'
       
  1005       property).  In both functions, the width parameter is ignored.
       
  1006 
       
  1007 
       
  1008   III. MISCELLANEOUS
       
  1009 
       
  1010     - The BDF driver  no longer converts  all returned bitmaps  with a
       
  1011       depth of 2bpp or 4bpp to a depth of 8bpp.  The documentation has
       
  1012       not  mentioned  this  explicitly,  but  implementors  might have
       
  1013       relied on this after looking into the source files.
       
  1014 
       
  1015     - A new option `--ftversion' has been  added to freetype-config to
       
  1016       return the FreeType version.
       
  1017 
       
  1018     - The  memory  debugger  has  been  updated   to  dump  allocation
       
  1019       statistics on  all allocation  sources in the library.   This is
       
  1020       useful to  spot greedy  allocations when  loading and processing
       
  1021       fonts.
       
  1022 
       
  1023     - We removed a huge array of constant pointers to constant strings
       
  1024       in the `psnames' module.   The problem was that  compilations in
       
  1025       PIC mode (i.e.,  when generating a  Unix shared object/dll)  put
       
  1026       the array  into the non-shared  writable section of  the library
       
  1027       since absolute pointers are not relocatable by nature.
       
  1028 
       
  1029       This reduces the memory consumption by approximately 16KByte per
       
  1030       process linked  to FreeType.   We now also store  the array in a
       
  1031       compressed form (as a trie) which saves about 20KByte of code as
       
  1032       well.
       
  1033 
       
  1034     - Kirill  Smelkov provided  patches to make  src/raster/ftraster.c
       
  1035       compile stand-alone again.
       
  1036 
       
  1037 
       
  1038 ======================================================================
       
  1039 
       
  1040 CHANGES BETWEEN 2.1.9 and 2.1.8
       
  1041 
       
  1042   I. IMPORTANT BUG FIXES
       
  1043 
       
  1044     - The function  `FT_Get_CharMap_Index' was only declared,  without
       
  1045       any  real  code.   For  consistency,  it  has  been  renamed  to
       
  1046       `FT_Get_Charmap_Index'.   (This function is needed  to implement
       
  1047       cmap caches.)
       
  1048 
       
  1049     - `FT_Outline_Get_BBox'  sometimes returned  incorrect values  for
       
  1050       conic outlines (e.g., for TrueType fonts).
       
  1051 
       
  1052     - Handling of `bhed' table has been fixed.
       
  1053 
       
  1054     - The TrueType driver with enabled byte code interpreter sometimes
       
  1055       returned artifacts due to incorrect rounding.  This bug has been
       
  1056       introduced after version 2.1.4.
       
  1057 
       
  1058     - The BDF driver dropped the last glyph in the font.
       
  1059 
       
  1060     - The BDF driver now uses the DEFAULT_CHAR property (if available)
       
  1061       to select a glyph shape for the undefined glyph.
       
  1062 
       
  1063     - The stroker failed for closed outlines and single points.
       
  1064 
       
  1065 
       
  1066   II. IMPORTANT CHANGES
       
  1067 
       
  1068     - George  Williams   contributed  code  to   handle  Apple's  font
       
  1069       distortion technology found in GX fonts (`avar', `cvar', `fvar',
       
  1070       and `gvar' tables;  the Multiple Masters  API has been  slightly
       
  1071       extended to cope with the new functionality).
       
  1072 
       
  1073     - The `FT_GlyphSlotRec' structure has been extended:  The elements
       
  1074       `lsb_delta' and  `rsb_delta' give the difference  between hinted
       
  1075       and  unhinted  left and right  side bearings  if autohinting  is
       
  1076       active.  Using those values can improve the inter-letter spacing
       
  1077       considerably.   See the documentation of  `FT_GlyphSlotRec'  and
       
  1078       the `ftstring' demo program how to use it.
       
  1079 
       
  1080     - Loading TrueType and Type 1 fonts has been made much faster.
       
  1081 
       
  1082     - The stroker is  no longer experimental (but the  cache subsystem
       
  1083       still is).
       
  1084 
       
  1085 
       
  1086   III. MISCELLANEOUS
       
  1087 
       
  1088     - A new  documentation file  `formats.txt' describes various  font
       
  1089       formats supported (and not supported) by FreeType.
       
  1090 
       
  1091 
       
  1092 ======================================================================
       
  1093 
       
  1094 CHANGES BETWEEN 2.1.8 and 2.1.7
       
  1095 
       
  1096   I. IMPORTANT BUG FIXES
       
  1097 
       
  1098     - The native  TrueType hinter contained some  bugs which prevented
       
  1099       some fonts to be rendered correctly, most notably Legendum.otf.
       
  1100 
       
  1101     - The PostScript hinter now produces improved results.
       
  1102 
       
  1103     - The  linear advance  width  and height  values were  incorrectly
       
  1104       rounded,  making  them virtually  unusable  if  not loaded  with
       
  1105       FT_LOAD_LINEAR_DESIGN.
       
  1106 
       
  1107     - Indexing CID-keyed CFF fonts is  now working: The glyph index is
       
  1108       correctly  treated as a  CID, similar  to FreeType's  CID driver
       
  1109       module.  Note that CID CMap support is still missing.
       
  1110 
       
  1111     - The FT_FACE_FLAGS_GLYPH_NAMES flag is now  set correctly for all
       
  1112       font formats.
       
  1113 
       
  1114     - Some subsetted Type 1  fonts weren't parsed correctly.  This bug
       
  1115       has been introduced in 2.1.7.  In summary, the Type 1 parser has
       
  1116       become more robust.
       
  1117 
       
  1118     - Non-decimal numbers weren't parsed correctly in PS fonts.
       
  1119 
       
  1120     - The WinFNT driver now correctly reports FT_ENCODING_NONE for all
       
  1121       but one encoding.  Use  the new FT_WinFNT_ID_XXX values together
       
  1122       with `FT_Get_WinFNT_Header' to get the WinFNT charset ID.
       
  1123 
       
  1124     - The descender metrics (face->size->metrics.descender) for WinFNT
       
  1125       bitmap fonts had the wrong sign.
       
  1126 
       
  1127     - The (emulated) `seac' support for CFF fonts was broken.
       
  1128 
       
  1129     - The `flex' operator didn't work for CFF fonts.
       
  1130 
       
  1131     - PS glyphs  which  use  the   `hintmask'  operator  haven't  been
       
  1132       rendered correctly in some cases.
       
  1133 
       
  1134     - Metrics for BDF and PCF bitmap font formats have been fixed.
       
  1135 
       
  1136     - Autohinting  is now  disabled for  glyphs  which  are vertically
       
  1137       distorted  or mirrored  (using a  transformation matrix).   This
       
  1138       fixes a bug which produced zero-height glyphs.
       
  1139 
       
  1140     - The   `freetype-config'   script   now  handles   --prefix   and
       
  1141       --exec-prefix correctly; it also  returns the proper --rpath (or
       
  1142       -R) value if FreeType has been built as a shared library.
       
  1143 
       
  1144 
       
  1145   II. IMPORTANT CHANGES
       
  1146 
       
  1147     - Both  PCF  and BDF  drivers  now  handle  the SETWIDTH_NAME  and
       
  1148       ADD_STYLE_NAME    properties.     Values    are   appended    to
       
  1149       face->style_name; example: `Bold SemiCondensed'.
       
  1150 
       
  1151     - The PCF driver now handles bitmap  fonts compressed with the LZW
       
  1152       algorithm (extension .pcf.Z, compressed with `compress').
       
  1153 
       
  1154     - A  new  API   function  `FT_Get_CMap_Language_ID'  (declared  in
       
  1155       `tttables.h')  is  available  to   get  the  language  ID  of  a
       
  1156       TrueType/SFNT cmap.
       
  1157 
       
  1158     - The hexadecimal format of  data after the `StartData' command in
       
  1159       CID-keyed Type 1 fonts is now supported.  While this can't occur
       
  1160       in  file-based   fonts,  it  can   happen  in  document-embedded
       
  1161       resources of PostScript documents.
       
  1162 
       
  1163     - Embedded bitmaps in SFNT-based CFF fonts are now supported.
       
  1164 
       
  1165     - A simple  API is  now available  to control  FreeType's  tracing
       
  1166       mechanism if compiled  with FT_DEBUG_LEVEL_TRACE.   See the file
       
  1167       `ftdebug.h' for more details.
       
  1168 
       
  1169     - YAMATO Masatake contributed improved  handling of MacOS resource
       
  1170       forks on non-MacOS platforms (for example, Linux can mount MacOS
       
  1171       file systems).
       
  1172 
       
  1173     - Support for MacOS has been improved; there is now a new function
       
  1174       `FT_New_Face_From_FSSpec'  similar to `FT_New_Face'  except that
       
  1175       it accepts an FSSpec instead of a path.
       
  1176 
       
  1177     - The cache sub-system has been rewritten.
       
  1178 
       
  1179       - There is now support for deinstallation of faces.
       
  1180 
       
  1181       - A new  API function `FTC_Manager_RemoveFaceID'  has been added
       
  1182         to  delete  all  `idle'  nodes  that  correspond  to  a  given
       
  1183         FTC_FaceID.  All `locked' nodes  (i.e., those with a reference
       
  1184         count > 0), will be modified to prevent them from appearing in
       
  1185         further  lookups (they  will  be cleaned  normally when  their
       
  1186         reference count reaches 0).
       
  1187 
       
  1188       - There  is  now  support  for point  scaling  (i.e.,  providing
       
  1189         character sizes in points + dpis, instead of pixels).
       
  1190 
       
  1191       - Three abstract cache classes are now available:
       
  1192 
       
  1193           FTC_GCache:  Used to store  one glyph  item per  cache node,
       
  1194                       with the ability to group common attributes into
       
  1195                       `families'.      This    replaces     the    old
       
  1196                       FTC_GlyphCache class.
       
  1197 
       
  1198           FTC_ICache: Used to store one FT_Glyph per cache node.  This
       
  1199                       extends  FTC_GCache.  Family  definition, family
       
  1200                       comparison, and  glyph loading are  however left
       
  1201                       to sub-classes.
       
  1202 
       
  1203           FTC_SCache: Used to  store up to 16 small  bitmaps per cache
       
  1204                       node.    This    extends   FTC_GCache.    Family
       
  1205                       definition, family  comparison and glyph loading
       
  1206                       are however left to sub-classes.
       
  1207 
       
  1208       - The file `src/cache/ftcbasic.c' implements:
       
  1209 
       
  1210           FTC_ImageCache: Extends    FTC_ICache;   implements   family
       
  1211                           definitions and glyph loading similar to the
       
  1212                           old API.
       
  1213 
       
  1214           FTC_SBitCache: Extends    FTC_SCache,    implements   family
       
  1215                          definitions and glyph  loading similar to the
       
  1216                          old API
       
  1217 
       
  1218         Client  applications  should  be  able to  extend  FTC_GCache,
       
  1219         FTC_ICache, or FTC_SCache much more easily (i.e., less code to
       
  1220         write, and  less callbacks).  For example,  one could envision
       
  1221         caches  that are  capable of  storing  transformed (obliqued),
       
  1222         stroked,   emboldened,   or   colored   glyph   images.    Use
       
  1223         `ftcbasic.c' as an example.
       
  1224 
       
  1225       - All public  APIs are now  in `include/freetype/ftcache.h', (to
       
  1226         be    accessed   as    `FT_CACHE_H').     The   contents    of
       
  1227         `include/freetype/cache/' is only  needed by applications that
       
  1228         wish to implement their own caches.
       
  1229 
       
  1230       - There were some major performance improvements through the use
       
  1231         of  various programming  tricks.   Cache hits  are  up to  70%
       
  1232         faster than in the old code.
       
  1233 
       
  1234       - The  FTC_CMapCache has  been simplified.  Charmaps can only be
       
  1235         accessed by  index right now.  There  is also a  new API named
       
  1236         `FT_Charmap_GetIndex' for this purpose.
       
  1237 
       
  1238       - The  demo programs  have been  updated to  the new  code.  The
       
  1239         previous versions will not work with the current one.
       
  1240 
       
  1241       - Using  an invalid face  index in FT_Open_Face and friends  now
       
  1242         causes an error even if the font contains a single face only.
       
  1243 
       
  1244 
       
  1245   III. MISCELLANEOUS
       
  1246 
       
  1247     - Wolfgang Domröse contributed support files for building FreeType
       
  1248       on the Atari using the PureC compiler.  Note that the Atari is a
       
  1249       16bit platform.
       
  1250 
       
  1251     - Vitaliy Pasternak contributed project files for VS.NET 2003.
       
  1252 
       
  1253 
       
  1254 ======================================================================
       
  1255 
       
  1256 CHANGES BETWEEN 2.1.7 and 2.1.6
       
  1257 
       
  1258   I. IMPORTANT BUG FIXES
       
  1259 
       
  1260     - Updated  to newest  libtool  version, fixing  build problems  on
       
  1261       various platforms.
       
  1262 
       
  1263     - On  Unix  platforms,  `make  install' didn't  copy  the  correct
       
  1264       `ftconfig.h' file.
       
  1265 
       
  1266   Note that version 2.1.7  contains the same library  C source code as
       
  1267   version 2.1.6.
       
  1268 
       
  1269 
       
  1270 ======================================================================
       
  1271 
       
  1272 CHANGES BETWEEN 2.1.6 and 2.1.5
       
  1273 
       
  1274   I. IMPORTANT BUG FIXES
       
  1275 
       
  1276     - The PFR  font driver didn't  load kerning tables  correctly, and
       
  1277       the functions in FT_PFR_H didn't work at all.
       
  1278 
       
  1279     - Type 1 font  files in  binary format  (PFB) with  an end-of-file
       
  1280       indicator weren't accepted by the FreeType engine.
       
  1281 
       
  1282     - Fonts which contain /PaintType  and /StrokeWidth no longer cause
       
  1283       a segfault.  This bug has been introduced in version 2.1.5.
       
  1284 
       
  1285     - Fonts  loaded  with   FT_LOAD_RENDER  no  longer  cause  strange
       
  1286       results.  This bug has been introduced in version 2.1.5.
       
  1287 
       
  1288     - Some  Windows   (bitmap)  FNT/FON  files   couldn't  be  handled
       
  1289       correctly.
       
  1290 
       
  1291 
       
  1292   II. IMPORTANT CHANGES
       
  1293 
       
  1294     - The internal  module API  has been heavily  changed in  favor of
       
  1295       massive simplifications within the font engine.  This also means
       
  1296       that authors of third-party modules must adapt their code to the
       
  1297       new scheme.
       
  1298 
       
  1299       NOTE:  THE NEW SCHEME IS NOT COMPLETED YET.  PLEASE WAIT UNTIL A
       
  1300       FINAL ANNOUNCEMENT!
       
  1301 
       
  1302     - The PostScript  parser has been enhanced to  handle comments and
       
  1303       strings   correctly.   Additionally,   more  syntax   forms  are
       
  1304       recognized.
       
  1305 
       
  1306     - Added the  optional unpatented hinting system  for TrueType.  It
       
  1307       allows  typefaces which  need hinting  to produce  correct glyph
       
  1308       forms (e.g., Chinese typefaces  from Dynalab) to work acceptably
       
  1309       without infringing Apple patents.   This system is compiled only
       
  1310       if  TT_CONFIG_OPTION_COMPILE_UNPATENTED_HINTING  is  defined  in
       
  1311       ftoption.h (activated by default).
       
  1312 
       
  1313 
       
  1314   III. MISCELLANEOUS
       
  1315 
       
  1316     - There  is now  a guard  in the  public header  files  to protect
       
  1317       against inclusion of freetype.h from FreeType 1.
       
  1318 
       
  1319     - Direct inclusion of freetype.h  and other public header files no
       
  1320       longer works.  You have to use the documented scheme
       
  1321 
       
  1322         #include <ft2build.h>
       
  1323         #include FT_FREETYPE_H
       
  1324 
       
  1325       to load freetype.h with  a symbolic name.  This protects against
       
  1326       renaming  of public  header  files (which  shouldn't happen  but
       
  1327       actually  has, avoiding two  public header  files with  the same
       
  1328       name).
       
  1329 
       
  1330 
       
  1331 ======================================================================
       
  1332 
       
  1333 CHANGES BETWEEN 2.1.5 and 2.1.4
       
  1334 
       
  1335   I. IMPORTANT BUG FIXES
       
  1336 
       
  1337     - Parsing the /CIDFontName field  now removes the leading slash to
       
  1338       be in sync with other font drivers.
       
  1339 
       
  1340     - gzip support was buggy.  Some fonts could not be read.
       
  1341 
       
  1342     - Fonts which  have nested subglyphs  more than one level  deep no
       
  1343       longer cause a segfault.
       
  1344 
       
  1345     - Creation of synthetic  cmaps for fonts in CFF  format was broken
       
  1346       partially.
       
  1347 
       
  1348     - Numeric  font  dictionary entries  for  synthetic  fonts are  no
       
  1349       longer overwritten.
       
  1350 
       
  1351     - The font matrix  wasn't applied to the advance  width for Type1,
       
  1352       CID, and  CFF fonts.  This caused problems  when loading certain
       
  1353       synthetic Type 1 fonts like `Helvetica Narrow'.
       
  1354 
       
  1355     - The test  for the charset registry  in BDF and PCF  fonts is now
       
  1356       case-insensitive.
       
  1357 
       
  1358     - FT_Vector_Rotate  sometimes  returned   strange  values  due  to
       
  1359       rounding errors.
       
  1360 
       
  1361     - The  PCF  driver  now  returns  the  correct  number  of  glyphs
       
  1362       (including an artificial `notdef' glyph at index 0).
       
  1363 
       
  1364     - FreeType now  supports buggy CMaps  which are contained  in many
       
  1365       CJK fonts from Dynalab.
       
  1366 
       
  1367     - Opening  an invalid  font  on a  Mac  caused a  segfault due  to
       
  1368       double-freeing memory.
       
  1369 
       
  1370     - BDF  fonts  with  more   than  32768  glyphs  weren't  supported
       
  1371       properly.
       
  1372 
       
  1373 
       
  1374   II. IMPORTANT CHANGES
       
  1375 
       
  1376     - Accessing bitmap font formats has been synchronized.  To do that
       
  1377       the FT_Bitmap_Size  structure has  been extended to  contain new
       
  1378       fields `size', `x_ppem', and `y_ppem'.
       
  1379 
       
  1380     - The FNT driver now returns multiple faces, not multiple strikes.
       
  1381 
       
  1382     - The `psnames'  module has been  updated to the Adobe  Glyph List
       
  1383       version 2.0.
       
  1384 
       
  1385     - The `psnames' module now understands `uXXXX[X[X]]' glyph names.
       
  1386 
       
  1387     - The algorithm for guessing the font style has been improved.
       
  1388 
       
  1389     - For fonts in SFNT format, root->height is no longer increased if
       
  1390       the line gap  is zero.  There exist fonts  (containing e.g. form
       
  1391       drawing  characters) which  intentionally have  a zero  line gap
       
  1392       value.
       
  1393 
       
  1394     - ft_glyph_bbox_xxx  flags   are  now  deprecated   in  favour  of
       
  1395       FT_GLYPH_BBOX_XXX.
       
  1396 
       
  1397     - ft_module_xxx   flags   are   now   deprecated  in   favour   of
       
  1398       FT_MODULE_XXX.
       
  1399 
       
  1400     - FT_ENCODING_MS_{SJIS,GB2312,BIG5,WANSUNG,JOHAB}      are     now
       
  1401       deprecated               in               favour              of
       
  1402       FT_ENCODING_{SJIS,GB2312,GIB5,WANSONG,JOHAB}  -- those encodings
       
  1403       are not specific to Microsoft.
       
  1404 
       
  1405 
       
  1406   III. MISCELLANEOUS
       
  1407 
       
  1408     - The  autohinter  has been  further  improved;  for example,  `m'
       
  1409       glyphs now retain its vertical symmetry.
       
  1410 
       
  1411     - Partial support of Mac fonts on non-Mac platforms.
       
  1412 
       
  1413     - `make   refdoc'   (after   first   `make')   builds   the   HTML
       
  1414       documentation.  You need Python for this.
       
  1415 
       
  1416     - The make build system should  now work more reliably on DOS-like
       
  1417       platforms.
       
  1418 
       
  1419     - Support for  EMX gcc  and Watson C/C++  compilers on  MS-DOS has
       
  1420       been added.
       
  1421 
       
  1422     - Better VMS build support.
       
  1423 
       
  1424     - Support for the pkg-config  package by providing a `freetype.pc'
       
  1425       file.
       
  1426 
       
  1427     - New configure option --with-old-mac-fonts for Darwin.
       
  1428 
       
  1429     - Some source files have been  renamed (mainly to fit into the 8.3
       
  1430       naming scheme).
       
  1431 
       
  1432 
       
  1433 ======================================================================
       
  1434 
       
  1435 CHANGES BETWEEN 2.1.4 and 2.1.3
       
  1436 
       
  1437   I. IMPORTANT BUG FIXES
       
  1438 
       
  1439     - Updated  to newest  libtool  version, fixing  build problems  on
       
  1440       various platforms.
       
  1441 
       
  1442     - A fix  in the Gzip stream  reader: It couldn't  read certain .gz
       
  1443       files properly due to a  small typo.  In certain cases, FreeType
       
  1444       could  also loop  endlessly  when trying  to  load tiny  gzipped
       
  1445       files.
       
  1446 
       
  1447     - The configure script now tries  to use the system-wide zlib when
       
  1448       it  finds one  (instead of  the  copy found  in src/gzip).   And
       
  1449       `freetype-config' has  been updated to return  relevant flags in
       
  1450       this case when invoked with `--libs' (e.g. `-lzlib').
       
  1451 
       
  1452     - Certain fonts couldn't be loaded  by 2.1.3 because they lacked a
       
  1453       Unicode   charmap  (e.g.   SYMBOL.TTF).    FreeType  erroneously
       
  1454       rejected them.
       
  1455 
       
  1456     - The CFF loader was modified to accept fonts which only contain a
       
  1457       subset of  their reference charset.  This  prevented the correct
       
  1458       use of PDF-embedded fonts.
       
  1459 
       
  1460     - The logic to detect Unicode charmaps has been modified.  This is
       
  1461       required to  support fonts which include both  16-bit and 32-bit
       
  1462       charmaps (like very  recent asian ones) using the  new 10 and 12
       
  1463       SFNT formats.
       
  1464 
       
  1465     - The TrueType  loader now limits  the depth of  composite glyphs.
       
  1466       This is necessary to prevent broken fonts to break the engine by
       
  1467       blowing the stack with recursive glyph definitions.
       
  1468 
       
  1469     - The CMap cache is now  capable of managing UCS-4 character codes
       
  1470       that   are   mapped   through   extended  charmaps   in   recent
       
  1471       TrueType/OpenType fonts.
       
  1472 
       
  1473     - The   cache  sub-system   now  properly   manages  out-of-memory
       
  1474       conditions  instead of  blindly  reporting them  to the  caller.
       
  1475       This means that it will try to empty the cache before restarting
       
  1476       its allocations to see if that can help.
       
  1477 
       
  1478     - The  PFR driver  didn't return  the list  of  available embedded
       
  1479       bitmaps properly.
       
  1480 
       
  1481     - There was  a nasty  memory leak when  using embedded  bitmaps in
       
  1482       certain font formats.
       
  1483 
       
  1484 
       
  1485   II. IMPORTANT CHANGES
       
  1486 
       
  1487     - David Chester  contributed some enhancements  to the auto-hinter
       
  1488       that  significantly increase  the  quality of  its output.   The
       
  1489       Postscript hinter was also improved in several ways.
       
  1490 
       
  1491     - The FT_RENDER_MODE_LIGHT render mode was implemented.
       
  1492 
       
  1493     - A new  API function called `FT_Get_BDF_Property'  has been added
       
  1494       to FT_BDF_H to  retrieve BDF properties from BDF  _and_ PCF font
       
  1495       files.   THIS  IS  STILL  EXPERIMENTAL,  since  it  hasn't  been
       
  1496       properly tested yet.
       
  1497 
       
  1498     - A Windows FNT specific API has been added, mostly to access font
       
  1499       headers.  This is used by Wine.
       
  1500 
       
  1501     - TrueType tables  without an `hmtx' table are  now tolerated when
       
  1502       an  incremental interface  is  used.  This  happens for  certain
       
  1503       Type42 fonts passed from Ghostscript to FreeType.
       
  1504 
       
  1505     - The PFR font driver is  now capable of returning the font family
       
  1506       and style  names when  they are available  (instead of  the sole
       
  1507       `FontID').   This  is  performed  by parsing  an  *undocumented*
       
  1508       portion of the font file!
       
  1509 
       
  1510 
       
  1511   III. MISCELLANEOUS
       
  1512 
       
  1513     - The path stroker in FT_STROKER_H has entered beta stage.  It now
       
  1514       works very  well, but  its interface might  change a bit  in the
       
  1515       future.  More on this in later releases.
       
  1516 
       
  1517     - The documentation for  FT_Size_Metrics didn't appear properly in
       
  1518       the API reference.
       
  1519 
       
  1520     - The file docs/VERSION.DLL has been updated to explain versioning
       
  1521       with FreeType  (i.e., comparing release/libtool/so  numbers, and
       
  1522       how to use them in autoconf scripts).
       
  1523 
       
  1524     - The  installation  documentation  has been  seriously  revamped.
       
  1525       Everything is now in the `docs' directory.
       
  1526 
       
  1527 
       
  1528 ======================================================================
       
  1529 
       
  1530 CHANGES BETWEEN 2.1.3 and 2.1.2
       
  1531 
       
  1532   I. IMPORTANT BUG FIXES
       
  1533 
       
  1534     - FT_Vector_Transform  had  been  incorrectly modified  in  2.1.2,
       
  1535       resulting  in  incorrect   transformations  being  applied  (for
       
  1536       example, rotations were processed in opposite angles).
       
  1537 
       
  1538     - The format  8 and 12 TrueType charmap  enumeration routines have
       
  1539       been fixed (FT_Get_Next_Char returned invalid values).
       
  1540 
       
  1541     - The  PFR font driver  returned incorrect  advance widths  if the
       
  1542       outline  and metrics resolution  defined in  the font  file were
       
  1543       different.
       
  1544 
       
  1545     - FT_Glyph_To_Bitmap now returns  successfully when called with an
       
  1546       FT_BitmapGlyph argument (it previously returned an error).
       
  1547 
       
  1548     - A bug  in the Type 1  loader that prevented  valid font bounding
       
  1549       boxes to be loaded from multiple master fonts.
       
  1550 
       
  1551     - The SFNT  validation code has been rewritten.   FreeType can now
       
  1552       load `broken'  fonts that were  usable on Windows, but  not with
       
  1553       previous versions of the library.
       
  1554 
       
  1555     - The computation of bearings in the BDF driver has been fixed.
       
  1556 
       
  1557     - The Postscript hinter crashed when trying to hint certain glyphs
       
  1558       (more precisely,  when trying to  apply hints to an  empty glyph
       
  1559       outline).
       
  1560 
       
  1561     - The  TrueType glyph  loader  now supports  composites in  `Apple
       
  1562       format'  (they differ slightly  from Microsoft/OpenType  ones in
       
  1563       the way transformation offsets are computed).
       
  1564 
       
  1565     - FreeType was  very slow at opening certain  asian CID/CFF fonts,
       
  1566       due to  fixed increment  in dynamic array  re-allocations.  This
       
  1567       has  been changed  to  exponential behaviour  to get  acceptable
       
  1568       performance.
       
  1569 
       
  1570 
       
  1571 
       
  1572   II. IMPORTANT CHANGES
       
  1573 
       
  1574     - The PCF driver now supports gzip-compressed font files natively.
       
  1575       This means that  you will be able to use  all these bitmap fonts
       
  1576       that  come with  XFree86 with  FreeType (and  libXft/libXft2, by
       
  1577       extension).
       
  1578 
       
  1579     - The  automatic and  postscript hinters  have both  been updated.
       
  1580       This  results in  a relatively  important increase  of rendering
       
  1581       quality since  many nasty defaults have been suppressed.  Please
       
  1582       visit the web page:
       
  1583 
       
  1584         http://www.freetype.org/hinting/smooth-hinting.html
       
  1585 
       
  1586       for additional details on this topic.
       
  1587 
       
  1588     - The `load_flags' parameter of `FT_Load_Glyph' is now an FT_Int32
       
  1589       (instead  of just  being  an FT_Int).   This  breaks source  and
       
  1590       binary  compatibility for  16bit systems  only,  while retaining
       
  1591       both of them for 32 and 64 bit ones.
       
  1592 
       
  1593       Some new flags have been added consequently:
       
  1594 
       
  1595         FT_LOAD_NO_AUTOHINT   :: Disable the use of the auto-hinter
       
  1596                                  (but not native format hinters).
       
  1597 
       
  1598         FT_LOAD_TARGET_NORMAL :: Hint and render for normal
       
  1599                                  anti-aliased displays.
       
  1600 
       
  1601         FT_LOAD_TARGET_MONO   :: Hint and render for 1-bit displays.
       
  1602 
       
  1603         FT_LOAD_TARGET_LCD    :: Hint and render for horizontal RGB or
       
  1604                                  BGR sub-pixel displays (like LCD
       
  1605                                  screens).  THIS IS STILL
       
  1606                                  EXPERIMENTAL!
       
  1607 
       
  1608         FT_LOAD_TARGET_LCD_V  :: Same as FT_LOAD_TARGET_LCD, for
       
  1609                                  vertical sub-pixel displays (like
       
  1610                                  rotated LCD screens).  THIS IS STILL
       
  1611                                  EXPERIMENTAL!
       
  1612 
       
  1613       FT_LOAD_MONOCHROME   is  still   supported,  but   only  affects
       
  1614       rendering, not the hinting.
       
  1615 
       
  1616       Note that the `ftview'  demo program available in the `ft2demos'
       
  1617       package  has been  updated to  support LCD-optimized  display on
       
  1618       non-paletted displays (under Win32 and X11).
       
  1619 
       
  1620     - The  PFR  driver  now  supports embedded  bitmaps  (all  formats
       
  1621       supported), and returns correct kerning metrics for all glyphs.
       
  1622 
       
  1623     - The TrueType charmap loader  now supports certain `broken' fonts
       
  1624       that load under Windows without problems.
       
  1625 
       
  1626     - The cache API has been slightly modified (it's still a beta!):
       
  1627 
       
  1628        - The type  FTC_ImageDesc has been removed; it  is now replaced
       
  1629          by  FTC_ImageTypeRec.   Note that  one  of  its  fields is  a
       
  1630          `load_flag' parameter for FT_Load_Glyph.
       
  1631 
       
  1632        - The  field  `num_grays' of  FT_SBitRec  has  been changed  to
       
  1633          `max_grays'  in  order to  fit  within  a  single byte.   Its
       
  1634          maximum value is thus 255 (instead of 256 as previously).
       
  1635 
       
  1636 
       
  1637   III. MISCELLANEOUS
       
  1638 
       
  1639     - Added support  for the  DESTDIR variable during  `make install'.
       
  1640       This simplifies packaging of FreeType.
       
  1641 
       
  1642     - Included modified  copies of the  ZLib sources in  `src/gzip' in
       
  1643       order to support  gzip-compressed PCF fonts.  We do  not use the
       
  1644       system-provided  zlib  for  now,   though  this  is  a  probable
       
  1645       enhancement for future releases.
       
  1646 
       
  1647     - The DocMaker tool used to generate the on-line API reference has
       
  1648       been   completely    rewritten.    It   is    now   located   in
       
  1649       `src/tools/docmaker/docmaker.py'.  Features:
       
  1650 
       
  1651         - better cross-referenced output
       
  1652         - more polished output
       
  1653         - uses Python regular expressions  (though it didn't speed the
       
  1654           program)
       
  1655         - much  more  modular structure,  which  allows for  different
       
  1656           `backends'  in  order to  generate  HTML,  XML, or  whatever
       
  1657           format.
       
  1658 
       
  1659       One can regenerate the API reference by calling:
       
  1660 
       
  1661          python src/tools/docmaker/docmaker.py \
       
  1662                 --prefix=ft2 \
       
  1663                 --title=FreeType-2.1.3 \
       
  1664                 --output=<outputdirectory>
       
  1665                 include/freetype/*.h \
       
  1666                 include/freetype/config/*.h \
       
  1667                 include/freetype/cache/*.h
       
  1668 
       
  1669     - A new, experimental, support for incremental font loading (i.e.,
       
  1670       loading  of fonts  where the  glyphs are  not in  the  font file
       
  1671       itself, but provided by an external component, like a Postscript
       
  1672       interpreter) has been added by Graham Asher.  This is still work
       
  1673       in progress, however.
       
  1674 
       
  1675     - A new,  EXPERIMENTAL, path stroker  has been added.   It doesn't
       
  1676       suffer  from  severe  rounding  errors  and  treat  bezier  arcs
       
  1677       directly.  Still work in progress (i.e. not part of the official
       
  1678       API).   See  the file  <freetype/ftstroker.h>  for  some of  the
       
  1679       details.
       
  1680 
       
  1681     - The massive  re-formatting of sources and  internal re-design is
       
  1682       still under-way.  Many  internal functions, constants, and types
       
  1683       have been renamed.
       
  1684 
       
  1685 
       
  1686 ======================================================================
       
  1687 
       
  1688 CHANGES BETWEEN 2.1.2 and 2.1.1
       
  1689 
       
  1690   I. IMPORTANT BUG FIXES
       
  1691 
       
  1692     - Many  font drivers didn't  select a  Unicode charmap  by default
       
  1693       when a new face  was opened (with the FT_CONFIG_OPTION_USE_CMAPS
       
  1694       options enabled),  causing many applications  to not be  able to
       
  1695       display text correctly with the 2.1.x releases.
       
  1696 
       
  1697     - The  PFR driver had  a bug  in its  composite loading  code that
       
  1698       produces incorrectly placed accents with many fonts.
       
  1699 
       
  1700     - The Type42 driver crashed sometimes due to a nasty bug.
       
  1701 
       
  1702     - The Type 1 custom encoding  charmap didn't handle the case where
       
  1703       the first glyph index wasn't 0.
       
  1704 
       
  1705     - A  serious  typo  in  the  TrueType  composite  loader  produced
       
  1706       incorrectly placed  glyphs in fonts  like `Wingdings' and  a few
       
  1707       others.
       
  1708 
       
  1709 
       
  1710   II. MISCELLANEOUS
       
  1711 
       
  1712     - The Win32  Visual C++ project  file has been updated  to include
       
  1713       the PFR driver as well.
       
  1714 
       
  1715     - `freetype.m4' is  now installed by default by  `make install' on
       
  1716       Unix systems.
       
  1717 
       
  1718     - The function  FT_Get_PS_Font_Info now works with  CID and Type42
       
  1719       fonts as well.
       
  1720 
       
  1721 
       
  1722 ======================================================================
       
  1723 
       
  1724 CHANGES BETWEEN 2.1.1 and 2.1.0
       
  1725 
       
  1726   I. IMPORTANT BUG FIXES
       
  1727 
       
  1728     - The  `version_info'  returned   by  `freetype-config'  in  2.1.0
       
  1729       returned an invalid value.  It now returns 9:1:3 (2.0.9 returned
       
  1730       9:0:3).
       
  1731 
       
  1732     - Version 2.1.0  couldn't be linked against  applications on Win32
       
  1733       and  Amiga systems  due  to  a new  debug  function that  wasn't
       
  1734       properly   propagated  to   the  system-specific   directory  in
       
  1735       `builds'.
       
  1736 
       
  1737     - Various MacOS and Mac OS X specific fixes.
       
  1738 
       
  1739     - Fixed  a bug in  the TrueType  charmap validation  routines that
       
  1740       made version  2.1.0 too restrictive  -- many popular  fonts have
       
  1741       been rejected.
       
  1742 
       
  1743     - There was  still a very small difference  between the monochrome
       
  1744       glyph bitmaps produced by FreeType 1.x and FreeType 2.x with the
       
  1745       bytecode  interpreter enabled.   This was  caused by  an invalid
       
  1746       flag setting in the TrueType glyph loader, making the rasterizer
       
  1747       change  its  drop-out   control  mode.   Now  the results should
       
  1748       _really_ be completely identical.
       
  1749 
       
  1750     - The TrueType name table loader has been improved to support many
       
  1751       popular  though buggy Asian  fonts.  It  now ignores  empty name
       
  1752       entries,  invalid  pointer offsets  and  a  few other  incorrect
       
  1753       subtleties.  Moreover,  name strings  are now loaded  on demand,
       
  1754       which reduces the memory load  of many faces (e.g. the ARIAL.TTF
       
  1755       font file contains a 10kByte name table with 70 names).
       
  1756 
       
  1757     - Fixed a bug in the Postscript hinter that prevented family blues
       
  1758       substitution to happen correctly.
       
  1759 
       
  1760 
       
  1761   II. NEW FEATURES
       
  1762 
       
  1763     - Three new font drivers in this release:
       
  1764 
       
  1765       * A  BDF  font driver,  contributed  by  Franco Zappa  Nardelli,
       
  1766         heavily  modified   by  Werner  Lemberg.    It  also  supports
       
  1767         anti-aliased bitmaps (using a slightly extended BDF format).
       
  1768 
       
  1769       * A Type42  font driver, contributed by Roberto  Alameda.  It is
       
  1770         still experimental but seems to work relatively well.
       
  1771 
       
  1772       * A PFR  font driver, contributed  by David Turner  himself.  It
       
  1773         doesn't  support PFR  hinting --  note that  BitStream  has at
       
  1774         least two patents on this format!
       
  1775 
       
  1776 
       
  1777   III. MISCELLANEOUS
       
  1778 
       
  1779     - The  cache  sub-system has  been  optimized  in important  ways.
       
  1780       Cache hits are now significantly faster.  For example, using the
       
  1781       CMap cache is about  twice faster than calling FT_Get_Char_Index
       
  1782       on most platforms.  Similarly, using an SBit cache is about five
       
  1783       times faster  than loading the  bitmaps from a bitmap  file, and
       
  1784       300 to  500 times  faster than generating  them from  a scalable
       
  1785       format.
       
  1786 
       
  1787       Note that  you should recompile  your sources if you  designed a
       
  1788       custom  cache  class for  the  FT2  Cache  subsystem, since  the
       
  1789       changes performed are source, but not binary, compatible.
       
  1790 
       
  1791 
       
  1792 ======================================================================
       
  1793 
       
  1794 CHANGES BETWEEN 2.1.0 and 2.0.9
       
  1795 
       
  1796   I. IMPORTANT BUG FIXES
       
  1797 
       
  1798     - The  TrueType bytecode  interpreter  has been  fixed to  produce
       
  1799       _exactly_ the same output as FreeType 1.x.  Previous differences
       
  1800       were due  to slightly distinct  fixed-point computation routines
       
  1801       used to perform dot products and vector length measurements.
       
  1802 
       
  1803       It seems  that native TrueType hinting  is _extremely_ sensitive
       
  1804       to  rounding errors.  The  required vector  computation routines
       
  1805       have been optimized and placed within the `ttinterp.c' file.
       
  1806 
       
  1807     - Fixed the parsing of accelerator tables in the PCF font driver.
       
  1808 
       
  1809     - Fixed the Type1 glyph loader  routine used to compute the font's
       
  1810       maximum advance width.
       
  1811 
       
  1812 
       
  1813   II. NEW FEATURES
       
  1814 
       
  1815     - The `configure' script used on Unix systems has been modified to
       
  1816       check  that  GNU  Make  is  being used  to  build  the  library.
       
  1817       Otherwise,  it  will display  a  message  proposing  to use  the
       
  1818       GNUMAKE environment variable to name it.
       
  1819 
       
  1820       The Unix-specific file README.UNX has been modified accordingly.
       
  1821 
       
  1822 
       
  1823   III. MISCELLANEOUS
       
  1824 
       
  1825     - The  FreeType  License in  `docs/FTL.TXT'  has  been updated  to
       
  1826       include  a  proposed preferred  disclaimer.   If  you are  using
       
  1827       FreeType in your products, you are encouraged (but not mandated)
       
  1828       to use the following text in your documentation:
       
  1829 
       
  1830       """
       
  1831         Portions of this software are copyright © 1996-2002 The
       
  1832         FreeType Project (www.freetype.org).  All rights reserved.
       
  1833       """
       
  1834 
       
  1835     - The default size of the render pool has been reduced to 16kByte.
       
  1836       This  shouldn't result  in any  noticeable  performance penalty,
       
  1837       unless you are  using the engine as-is to  render very large and
       
  1838       complex glyphs.
       
  1839 
       
  1840     - The  FreeType 2  redesign has  begun.  More  information  can be
       
  1841       found at this URL:
       
  1842 
       
  1843         http://www.freetype.org/freetype2/redesign.html
       
  1844 
       
  1845       The following  internal changes  have been performed  within the
       
  1846       sources of this release:
       
  1847 
       
  1848         - Many   internal  types   have  been   renamed   to  increase
       
  1849           consistency.   The  following  should  be true,  except  for
       
  1850           public types:
       
  1851 
       
  1852             * All structure  types have a name ending  in `Rec' (short
       
  1853               for `record').
       
  1854 
       
  1855             * A  pointer-to-structure type  has the  same name  as the
       
  1856               structure, _without_ the `Rec' suffix.
       
  1857 
       
  1858               Example:
       
  1859 
       
  1860                 typedef struct FooRec_
       
  1861                 {
       
  1862                   ...
       
  1863 
       
  1864                 } FooRec, *Foo;
       
  1865 
       
  1866         - Many   internal  macros  have   been  renamed   to  increase
       
  1867           consistency.  The following should be true:
       
  1868 
       
  1869             * All  macros  have a  name  beginning  with `FT_'.   This
       
  1870               required a few changes like
       
  1871 
       
  1872                 ALLOC   => FT_ALLOC
       
  1873                 FREE    => FT_FREE
       
  1874                 REALLOC => FT_REALLOC
       
  1875 
       
  1876             * All  macros are completely  UPPERCASE.  This  required a
       
  1877               few changes like:
       
  1878 
       
  1879                 READ_Short  => FT_READ_SHORT
       
  1880                 NEXT_Short  => FT_NEXT_SHORT
       
  1881                 GET_ULongLE => FT_GET_ULONG_LE
       
  1882                 MEM_Set     => FT_MEM_SET
       
  1883                 MEM_Copy    => FT_MEM_COPY
       
  1884                 etc.
       
  1885 
       
  1886             * Whenever   possible,   all   macro  names   follow   the
       
  1887               FT_<OBJECT>_<METHOD> pattern.  For example
       
  1888 
       
  1889                 ACCESS_Frame   => FT_FRAME_ENTER
       
  1890                 FORGET_Frame   => FT_FRAME_EXIT
       
  1891                 EXTRACT_Frame  => FT_FRAME_EXTRACT
       
  1892                 RELEASE_Frame  => FT_FRAME_RELEASE
       
  1893 
       
  1894                 FILE_Pos       => FT_STREAM_POS
       
  1895                 FILE_Seek      => FT_STREAM_SEEK
       
  1896                 FILE_Read      => FT_STREAM_READ
       
  1897                 FILE_ReadAt    => FT_STREAM_READ_AT
       
  1898                 READ_Fields    => FT_STREAM_READ_FIELDS
       
  1899 
       
  1900         - Many  internal functions  have  been renamed  to follow  the
       
  1901           FT_<Object>_<Method> pattern.  For example:
       
  1902 
       
  1903             FT_Seek_Stream       => FT_Stream_Seek
       
  1904             FT_Read_Stream_At    => FT_Stream_ReadAt
       
  1905             FT_Done_Stream       => FT_Stream_Close
       
  1906             FT_New_Stream        => FT_Stream_Open
       
  1907             FT_New_Memory_Stream => FT_Stream_OpenMemory
       
  1908             FT_Extract_Frame     => FT_Stream_ExtractFrame
       
  1909 
       
  1910           Note that method names do not contain `_'.
       
  1911 
       
  1912         - The FT_ALLOC_ARRAY  and FT_REALLOC_ARRAY have  been replaced
       
  1913           with  FT_NEW_ARRAY and  FT_RENEW_ARRAY which  do not  take a
       
  1914           type  as the  fourth argument.   Instead, the  array element
       
  1915           type  size is computed  automatically from  the type  of the
       
  1916           target pointer used.
       
  1917 
       
  1918         - A  new object  class, FT_CMap,  has been  introduced.  These
       
  1919           internal  objects are  used to  model character  maps.  This
       
  1920           eases  the support  of additional  charmap types  within the
       
  1921           engine.
       
  1922 
       
  1923         - A new  configuration file named `ftstdlib.h'  has been added
       
  1924           to `include/freetype/config'.  It  is used to define aliases
       
  1925           for  _every_ routine  of the  ISO  C library  that the  font
       
  1926           engine   uses.    Each    aliases   has   a   `ft_'   prefix
       
  1927           (e.g. `ft_strlen' is an alias for `strlen').
       
  1928 
       
  1929           This is  used to  ease the porting  of FreeType 2  to exotic
       
  1930           runtime environments where the ISO C Library isn't available
       
  1931           (e.g.  XFree86 extension modules).
       
  1932 
       
  1933       More details are available in the `ChangeLog' file.
       
  1934 
       
  1935 
       
  1936 ======================================================================
       
  1937 
       
  1938 CHANGES BETWEEN 2.0.9 and 2.0.8
       
  1939 
       
  1940   I. IMPORTANT BUG FIXES
       
  1941 
       
  1942     - Certain fonts like `foxjump.ttf' contain broken name tables with
       
  1943       invalid entries and wild offsets.  This caused FreeType to crash
       
  1944       when trying to load them.
       
  1945 
       
  1946       The  SFNT `name'  table  loader has  been  fixed to  be able  to
       
  1947       support these strange fonts.
       
  1948 
       
  1949       Moreover, the code  in charge of processing this  table has been
       
  1950       changed  to always favour  Windows-formatted entries  over other
       
  1951       ones.  Hence,  a font that works  on Windows but not  on the Mac
       
  1952       will  load cleanly in  FreeType and  report accurate  values for
       
  1953       Family & PostScript names.
       
  1954 
       
  1955     - The CID font driver has been fixed.  It unfortunately returned a
       
  1956       Postscript   Font   name   with   a   leading   slash,   as   in
       
  1957       `/MunhwaGothic-Regular'.
       
  1958 
       
  1959     - FreeType  2 should now  compile fine  on AIX  4.3.3 as  a shared
       
  1960       library.
       
  1961 
       
  1962     - A  bug  in the  Postscript  hinter  has  been found  and  fixed,
       
  1963       removing un-even stem widths at small pixel sizes (like 14-17).
       
  1964 
       
  1965       This  improves the  quality of  a certain  number  of Postscript
       
  1966       fonts.
       
  1967 
       
  1968 
       
  1969   II. NEW FEATURES
       
  1970 
       
  1971     - A  new function  named  `FT_Library_Version' has  been added  to
       
  1972       return  the current  library's major,  minor, and  patch version
       
  1973       numbers.   This is  important since  the  macros FREETYPE_MAJOR,
       
  1974       FREETYPE_MINOR,  and  FREETYPE_PATCH  cannot  be used  when  the
       
  1975       library is dynamically linked by a program.
       
  1976 
       
  1977     - Two   new  APIs   have  been   added:   `FT_Get_First_Char'  and
       
  1978       `FT_Get_Next_Char'.
       
  1979 
       
  1980       Together,  these can  be used  to iterate  efficiently  over the
       
  1981       currently  selected  charmap of  a  given  face.   Read the  API
       
  1982       reference for more details.
       
  1983 
       
  1984 
       
  1985   III. MISCELLANEOUS
       
  1986 
       
  1987     - The FreeType sources are  under heavy internal re-factoring.  As
       
  1988       a consequence,  we have created  a branch named `STABLE'  on the
       
  1989       CVS to hold all future releases/fixes in the 2.0.x family.
       
  1990 
       
  1991       The  HEAD  branch  now  contains  the  re-factored  sources  and
       
  1992       shouldn't  be used for  testing or  packaging new  releases.  In
       
  1993       case you  would like  to access the  2.0.9 sources from  our CVS
       
  1994       repository, use the tag `VER-2-0-9'.
       
  1995 
       
  1996 
       
  1997 ======================================================================
       
  1998 
       
  1999 CHANGES BETWEEN 2.0.8 and 2.0.7
       
  2000 
       
  2001   I. IMPORTANT BUG FIXES
       
  2002 
       
  2003     - There was  a small but  nasty bug in  `freetype-config.in' which
       
  2004       caused the `freetype-config' script to fail on Unix.
       
  2005 
       
  2006       This didn't prevent the installation  of the library or even its
       
  2007       execution, but caused problems  when trying to compile many Unix
       
  2008       packages that depend on it.
       
  2009 
       
  2010     - Some TrueType or OpenType fonts embedded in PDF documents do not
       
  2011       have  a  'cmap',  'post'  and  'name'  as  is  required  by  the
       
  2012       specification.  FreeType no longer refuses to load such fonts.
       
  2013 
       
  2014     - Various fixes to the PCF font driver.
       
  2015 
       
  2016 
       
  2017 ======================================================================
       
  2018 
       
  2019 CHANGES BETWEEN 2.0.7 and 2.0.6
       
  2020 
       
  2021   I. IMPORTANT BUG FIXES
       
  2022 
       
  2023     - Fixed  two  bugs in  the  Type 1  font  driver.   The first  one
       
  2024       resulted in a memory leak in subtle cases.  The other one caused
       
  2025       FreeType to crash when  trying to load `.gsf' files (Ghostscript
       
  2026       so-called Postscript fonts).
       
  2027 
       
  2028       (This  made _many_  KDE applications  crash on  certain systems.
       
  2029        FreeType _is_ becoming a critical system component on Linux :-)
       
  2030 
       
  2031     - Fixed a memory leak in the CFF font driver.
       
  2032 
       
  2033     - Fixed a memory leak in the PCF font driver.
       
  2034 
       
  2035     - Fixed       the        Visual       C++       project       file
       
  2036       `builds/win32/visualc/freetype.dsp' since  it didn't include the
       
  2037       Postscript hinter component, causing errors at build time.
       
  2038 
       
  2039     - Fixed a  small rendering bug  in the anti-aliased  renderer that
       
  2040       only  occurred when  trying to  draw  thin (less  than 1  pixel)
       
  2041       strokes.
       
  2042 
       
  2043     - Fixed  `builds/unix/freetype2.a4' which  is used  to  generate a
       
  2044       valid `freetype2.m4' for use with autoconf.
       
  2045 
       
  2046     - Fixed the OpenVMS Makefiles.
       
  2047 
       
  2048 
       
  2049   II. MISCELLANEOUS
       
  2050 
       
  2051     - Added  `configure'  and   `install'  scripts  to  the  top-level
       
  2052       directory.  A GNU-style installation is thus now easily possible
       
  2053       with
       
  2054 
       
  2055         ./configure  <options>
       
  2056         make
       
  2057         make install
       
  2058 
       
  2059 
       
  2060 ======================================================================
       
  2061 
       
  2062 CHANGES BETWEEN 2.0.6 and 2.0.5
       
  2063 
       
  2064   I. IMPORTANT BUG FIXES
       
  2065 
       
  2066     - It wasn't possible to load embedded bitmaps when the auto-hinter
       
  2067       was used.  This is now fixed.
       
  2068 
       
  2069     - The TrueType  font driver  didn't load some  composites properly
       
  2070       (the  sub-glyphs  were  slightly  shifted,  and  this  was  only
       
  2071       noticeable when using monochrome rendering).
       
  2072 
       
  2073     - Various  fixes  to the  auto-hinter.   They  merely improve  the
       
  2074       output of sans-serif fonts.   Note that there are still problems
       
  2075       with serifed fonts and composites (accented characters).
       
  2076 
       
  2077     - All scalable  font drivers erroneously  returned un-fitted glyph
       
  2078       advances when hinting was  requested.  This created problems for
       
  2079       a number  of layout applications.  This  is a very  old bug that
       
  2080       got  undetected mainly  because most  test/demo  program perform
       
  2081       rounding explicitly or implicitly (through the cache).
       
  2082 
       
  2083     - `FT_Glyph_To_Bitmap' did erroneously  modify the source glyph in
       
  2084       certain cases.
       
  2085 
       
  2086     - `glnames.py'  still contained  a bug  that made  FreeType return
       
  2087       invalid names for certain glyphs.
       
  2088 
       
  2089     - The  library crashed  when  loading certain  Type  1 fonts  like
       
  2090       `sadn.pfb'  (`Stalingrad  Normal'),   which  appear  to  contain
       
  2091       pathetic font info dictionaries.
       
  2092 
       
  2093     - The TrueType glyph  loader is now much more  paranoid and checks
       
  2094       everything when loading a given glyph image.  This was necessary
       
  2095       to avoid problems (crashes and/or memory overwrites) with broken
       
  2096       fonts that came from a really buggy automatic font converter.
       
  2097 
       
  2098 
       
  2099   II. IMPORTANT UPDATES AND NEW FEATURES
       
  2100 
       
  2101     - Important updates to the Mac-specific parts of the library.
       
  2102 
       
  2103     - The caching sub-system has  been completely re-designed, and its
       
  2104       API has  evolved (the  old one is  still supported  for backward
       
  2105       compatibility).
       
  2106 
       
  2107       The documentation for it is  not yet completed, sorry.  For now,
       
  2108       you are encouraged to continue  using the old API.  However, the
       
  2109       ftview  demo program in  the ft2demos  package has  already been
       
  2110       updated to use the new caching functions.
       
  2111 
       
  2112     - A new charmap cache is provided too.  See `FTC_CMapCache'.  This
       
  2113       is useful to perform  character code -> glyph index translations
       
  2114       quickly, without the need for an opened FT_Face.
       
  2115 
       
  2116     - A NEW POSTSCRIPT HINTER module  has been added to support native
       
  2117       hints in  the following  formats: PostScript Type  1, PostScript
       
  2118       CID, and CFF/CEF.
       
  2119 
       
  2120       Please test!  Note that  the auto-hinter produces better results
       
  2121       for a number of  badly-hinted fonts (mostly auto-generated ones)
       
  2122       though.
       
  2123 
       
  2124     - A memory debugger is now  part of the standard FreeType sources.
       
  2125       To      enable      it,      define      FT_DEBUG_MEMORY      in
       
  2126       <freetype/config/ftoption.h>, and recompile the library.
       
  2127 
       
  2128       Additionally, define  the _environment_ variable FT_DEBUG_MEMORY
       
  2129       and run any program using FreeType.  When the library is exited,
       
  2130       a  summary  of memory  footprints  and  possible  leaks will  be
       
  2131       displayed.
       
  2132 
       
  2133       This works transparently with  _any_ program that uses FreeType.
       
  2134       However, you  will need a lot  of memory to  use this (allocated
       
  2135       blocks are never  released to the heap to  detect double deletes
       
  2136       easily).
       
  2137 
       
  2138 
       
  2139   III. MISCELLANEOUS
       
  2140 
       
  2141     - We  are  aware  of  subtle  differences between  the  output  of
       
  2142       FreeType  versions   1  and  2  when  it   comes  to  monochrome
       
  2143       TrueType-hinted glyphs.   These are  most probably due  to small
       
  2144       differences in the monochrome rasterizers and will be worked out
       
  2145       in an upcoming release.
       
  2146 
       
  2147     - We have decided to fork the sources in a `stable' branch, and an
       
  2148       `unstable' one, since FreeType  is becoming a critical component
       
  2149       of many Unix systems.
       
  2150 
       
  2151       The next  bug-fix releases of  the library will be  named 2.0.7,
       
  2152       2.0.8, etc.,  while the `2.1'  branch will contain a  version of
       
  2153       the sources where we will start major reworking of the library's
       
  2154       internals, in order to produce FreeType 2.2.0 (or even 3.0) in a
       
  2155       more distant future.
       
  2156 
       
  2157       We  also hope  that this  scheme will  allow much  more frequent
       
  2158       releases than in the past.
       
  2159 
       
  2160 
       
  2161 ======================================================================
       
  2162 
       
  2163 CHANGES BETWEEN 2.0.5 and 2.0.4
       
  2164 
       
  2165   NOTE THAT 2.0.5 DOES NOT CONTAIN THE POSTSCRIPT HINTER.  THIS MODULE
       
  2166   WILL BE PART OF THE NEXT RELEASE (EITHER 2.0.6 or 2.1)
       
  2167 
       
  2168   - Fixed a bug that made  certain glyphs, like `Cacute', `cacute' and
       
  2169     `lslash'  unavailable from Unicode  charmaps of  Postscript fonts.
       
  2170     This prevented the correct display of Polish text, for example.
       
  2171 
       
  2172   - The kerning table of Type 1 fonts was loaded by FreeType, when its
       
  2173     AFM    file    was    attached    to    its    face,    but    the
       
  2174     FT_FACE_FLAG_HAS_KERNING   bit  flags   was  not   set  correctly,
       
  2175     preventing FT_Get_Kerning to return meaningful values.
       
  2176 
       
  2177   - Improved  SFNT (TrueType  & OpenType)  charmap  support.  Slightly
       
  2178     better performance, as well as support for the new formats defined
       
  2179     by the OpenType 1.3 specification (8, 10, and 12)
       
  2180 
       
  2181   - Fixed a  serious typo in `src/base/ftcalc.c'  which caused invalid
       
  2182     computations in certain rare cases, producing ugly artefacts.
       
  2183 
       
  2184   - The  size  of the  EM  square is  computed  with  a more  accurate
       
  2185     algorithm for Postscript fonts.   The old one caused slight errors
       
  2186     with embedded fonts found in PDF documents.
       
  2187 
       
  2188   - Fixed  a  bug in  the  cache  manager  that prevented  normal  LRU
       
  2189     behaviour  within the cache  manager, causing  unnecessary reloads
       
  2190     (for FT_Face and FT_Size objects only).
       
  2191 
       
  2192   - Added  a new  function named  `FT_Get_Name_Index' to  retrieve the
       
  2193     glyph index of a given glyph name, when found in a face.
       
  2194 
       
  2195   - Added  a new function  named `FT_Get_Postscript_Name'  to retrieve
       
  2196     the `unique' Postscript font name of a given face.
       
  2197 
       
  2198   - Added   a   new   public   header  size   named   FT_SIZES_H   (or
       
  2199     <freetype/ftsizes.h>) providing  new FT_Size-management functions:
       
  2200     FT_New_Size, FT_Activate_Size, FT_Done_Size.
       
  2201 
       
  2202   - Fixed a  reallocation bug that  generated a dangling  pointer (and
       
  2203     possibly    memory    leaks)    with    Postscript    fonts    (in
       
  2204     src/psaux/psobjs.c).
       
  2205 
       
  2206   - Many fixes for 16-bit correctness.
       
  2207 
       
  2208   - Removed many pedantic compiler warnings from the sources.
       
  2209 
       
  2210   - Added an Amiga build directory in `builds/amiga'.
       
  2211 
       
  2212 
       
  2213 ======================================================================
       
  2214 
       
  2215 CHANGES BETWEEN 2.0.4 and 2.0.3
       
  2216 
       
  2217   - Fixed a rather annoying bug that was introduced in 2.0.3.  Namely,
       
  2218     the font  transformation set through  FT_Set_Transform was applied
       
  2219     twice to auto-hinted glyphs, resulting in incorrectly rotated text
       
  2220     output.
       
  2221 
       
  2222   - Fixed _many_  compiler warnings.   FT2 should now  compile cleanly
       
  2223     with Visual  C++'s most pedantic warning level  (/W4).  It already
       
  2224     compiled fine with GCC and a few other compilers.
       
  2225 
       
  2226   - Fixed a bug  that prevented the linear advance  width of composite
       
  2227     TrueType glyphs to be correctly returned.
       
  2228 
       
  2229   - Fixed    the    Visual    C++    project    files    located    in
       
  2230     `builds/win32/visualc' (previous versions  used older names of the
       
  2231     library).
       
  2232 
       
  2233   - Many  32-bit constants  have an  `L' appended  to their  value, in
       
  2234     order to improve the 16-bitness  of the code.  Someone is actually
       
  2235     trying to use FT2 on an Atari ST machine!
       
  2236 
       
  2237   - Updated  the  `builds/detect.mk' file  in  order to  automatically
       
  2238     build FT2  on AIX systems.   AIX uses `/usr/sbin/init'  instead of
       
  2239     `/sbin/init' and wasn't previously  detected as a Unix platform by
       
  2240     the FreeType build system.
       
  2241 
       
  2242   - Updated  the  Unix-specific  portions  of the  build  system  (new
       
  2243     libtool version, etc.).
       
  2244 
       
  2245   - The  SFNT kerning  loader now  ensures  that the  table is  sorted
       
  2246     (since some problem fonts do not meet this requirement).
       
  2247 
       
  2248 
       
  2249 =======================================================================
       
  2250 
       
  2251 CHANGES BETWEEN 2.0.3 and 2.0.2
       
  2252 
       
  2253   I. CHANGES TO THE MODULES / FONT DRIVERS
       
  2254 
       
  2255     - THE  AUTO-HINTER HAS  BEEN SLIGHTLY  IMPROVED, in  order  to fix
       
  2256       several annoying artefacts, mainly:
       
  2257 
       
  2258         - Blue  zone alignment  of  horizontal stems  wasn't performed
       
  2259           correctly, resulting in artefacts  like the `d' being placed
       
  2260           one pixel below the `b' in some fonts like Time New Roman.
       
  2261 
       
  2262         - Overshoot thresholding  wasn't performed correctly, creating
       
  2263           unpleasant artefacts at large character pixel sizes.
       
  2264 
       
  2265         - Composite glyph loading has  been simplified.  This gets rid
       
  2266           of  various artefacts  where the  components of  a composite
       
  2267           glyphs were not correctly spaced.
       
  2268 
       
  2269       These are  the last changes to the  current auto-hinting module.
       
  2270       A new  hinting sub-system is currently  in the work  in order to
       
  2271       support native hints  in Type 1 / CFF /  OpenType fonts, as well
       
  2272       as globally improve rendering.
       
  2273 
       
  2274     - The  PCF  driver has  been  fixed.   It  reported invalid  glyph
       
  2275       dimensions for the fonts available on Solaris.
       
  2276 
       
  2277     - The Type  1, CID and CFF  drivers have been modified  to fix the
       
  2278       computation of the EM size.
       
  2279 
       
  2280     - The Type 1  driver has been fixed to avoid  a dangerous bug that
       
  2281       crashed the library with non-conforming fonts (i.e. ones that do
       
  2282       not place the .notdef glyph at position 0).
       
  2283 
       
  2284     - The TrueType  driver had a  rather subtle bug  (dangling pointer
       
  2285       when loading  composite glyphs) that could crash  the library in
       
  2286       rare occasions!
       
  2287 
       
  2288 
       
  2289   II. HIGH-LEVEL API CHANGES
       
  2290 
       
  2291     - The error  code enumeration values have been  changed.  An error
       
  2292       value  is decomposed  in  a  generic error  code,  and a  module
       
  2293       number.  see <freetype/fterrors.h> for details.
       
  2294 
       
  2295     - A   new  public   header   file  has   been  introduced,   named
       
  2296       FT_TRIGONOMETRY_H     (include/freetype/fttrig.h),     providing
       
  2297       trigonometric functions to  compute sines, cosines, arctangents,
       
  2298       etc. with 16.16 fixed precision.  The implementation is based on
       
  2299       the CORDIC  algorithm and is very fast  while being sufficiently
       
  2300       accurate.
       
  2301 
       
  2302 
       
  2303   III. INTERNALS
       
  2304 
       
  2305     - Added  BeOS-specific files  in the  old build  sub-system.  Note
       
  2306       that no changes were required to compile the library with Jam.
       
  2307 
       
  2308     - The  configuration  is now  capable  of automatically  detecting
       
  2309       64-bit integers  on a set  of predefined compilers  (GCC, Visual
       
  2310       C++, Borland C++) and will use them by default.  This provides a
       
  2311       small performance boost.
       
  2312 
       
  2313     - A  small memory leak  that happened  when opening  0-sized files
       
  2314       (duh!)  have been fixed.
       
  2315 
       
  2316     - Fixed bezier  stack depth  bug in the  routines provided  by the
       
  2317       FT_BBOX_H  header   file.   Also  fixed  similar   bugs  in  the
       
  2318       rasterizers.
       
  2319 
       
  2320     - The outline bounding  box code has been rewritten  to use direct
       
  2321       computations,  instead of  bezier sub-division,  to  compute the
       
  2322       exact bounding box of glyphs.   This is slightly slower but more
       
  2323       accurate.
       
  2324 
       
  2325     - The build system has been  improved and fixed, mainly to support
       
  2326       `make'  on Windows  2000  correctly, avoid  problems with  `make
       
  2327       distclean' on non Unix systems, etc.
       
  2328 
       
  2329     - Hexadecimal  constants  have been  suffixed  with  `U' to  avoid
       
  2330       problems with certain compilers on 64-bit platforms.
       
  2331 
       
  2332     - A new directory named `src/tools' has been created.  It contains
       
  2333       Python scripts and simple unit test programs used to develop the
       
  2334       library.
       
  2335 
       
  2336     - The DocMaker tool has been  moved from `docs' to `src/tools' and
       
  2337       has been updated with the following:
       
  2338 
       
  2339          - Now accepts the `--title=XXXX' or `-t XXXX' option from the
       
  2340            command line to set the project's name in the generated API
       
  2341            reference.
       
  2342 
       
  2343          - Now accepts the `--output=DIR'  or `-o DIR' option from the
       
  2344            command line to set  the output directory for all generated
       
  2345            HTML files.
       
  2346 
       
  2347          - Now accepts the `--prefix=XXXX' or `-p XXX' option from the
       
  2348            command  line  to  set  the  file prefix  to  use  for  all
       
  2349            generated HTML files.
       
  2350 
       
  2351          - Now generates the current  time/data on each generated page
       
  2352            in order to distinguish between versions.
       
  2353 
       
  2354       DocMaker  can be  used with  other  projects now,  not only  FT2
       
  2355       (e.g. MLib, FTLayout, etc.).
       
  2356 
       
  2357 
       
  2358 ======================================================================
       
  2359 
       
  2360 CHANGES BETWEEN 2.0.2 and 2.0.1
       
  2361 
       
  2362   I. CHANGES TO THE MODULES / FONT DRIVERS
       
  2363 
       
  2364     - THE TRUETYPE BYTECODE INTERPRETER IS NOW TURNED OFF, in order to
       
  2365       avoid legal problems  with the Apple patents.  It  seems that we
       
  2366       mistakenly  turned this option  on in  previous releases  of the
       
  2367       build.
       
  2368 
       
  2369       Note that if  you want to use the  bytecode interpreter in order
       
  2370       to get high-quality TrueType  rendering, you will need to toggle
       
  2371       by        hand        the        definition        of        the
       
  2372       TT_CONFIG_OPTION_BYTECODE_INTERPRETER   macro    in   the   file
       
  2373       `include/freetype/config/ftoption.h'.
       
  2374 
       
  2375     - The CFF driver has been improved by Tom Kacvinsky and Sander van
       
  2376       der Wal:
       
  2377 
       
  2378       * Support for `seac' emulation.
       
  2379       * Support for `dotsection'.
       
  2380       * Support for retrieving glyph names through
       
  2381         `FT_Get_Glyph_Name'.
       
  2382 
       
  2383       The first two items are necessary to correctly a large number of
       
  2384       Type 1 fonts converted to the CFF formats by Adobe Acrobat.
       
  2385 
       
  2386     - The Type 1 driver was also improved by Tom & others:
       
  2387 
       
  2388       * Better EM size computation.
       
  2389       * Better support for synthetic (transformed) fonts.
       
  2390       * The  Type 1  driver returns  the charstrings  corresponding to
       
  2391         each glyph in the  `glyph->control_data' field after a call to
       
  2392         `FT_Load_Glyph' (thanks Ha Shao).
       
  2393 
       
  2394     - Various other bugfixes, including the following:
       
  2395 
       
  2396       * Fixed a nasty memory leak in the Type 1 driver.
       
  2397       * The autohinter  and the pcf  driver used static  writable data
       
  2398         when they shouldn't.
       
  2399       * Many casts were added to  make the code more 64-bits safe.  It
       
  2400         also now compiles on Windows XP 64-bits without warnings.
       
  2401       * Some incorrect writable statics were removed in the `autohint'
       
  2402         and `pcf' drivers.  FreeType 2 now compiles on Epoc again.
       
  2403 
       
  2404 
       
  2405   II. CHANGES TO THE HIGH-LEVEL API
       
  2406 
       
  2407     - The library header files inclusion scheme has been changed.  The
       
  2408       old scheme looked like:
       
  2409 
       
  2410         #include <freetype/freetype.h>
       
  2411         #include <freetype/ftglyph.h>
       
  2412         #include <freetype/ftcache.h>
       
  2413         #include <freetype/cache/ftimage.h>
       
  2414 
       
  2415       Now you should use:
       
  2416 
       
  2417         #include <ft2build.h>
       
  2418         #include FT_FREETYPE_H
       
  2419         #include FT_GLYPH_H
       
  2420         #include FT_CACHE_H
       
  2421         #include FT_CACHE_IMAGE_H
       
  2422 
       
  2423       NOTE THAT  THE OLD  INCLUSION SCHEME WILL  STILL WORK  WITH THIS
       
  2424       RELEASE.  HOWEVER, WE  DO NOT GUARANTEE THAT THIS  WILL STILL BE
       
  2425       TRUE IN THE NEXT ONE (A.K.A. FREETYPE 2.1).
       
  2426 
       
  2427       The  file <ft2build.h>  is used  to define  the  header filename
       
  2428       macros.  The complete and  commented list of macros is available
       
  2429       in the API reference under the section name `Header File Macros'
       
  2430       in Chapter I.
       
  2431 
       
  2432       For more information, see section I of the following document:
       
  2433 
       
  2434         http://www.freetype.org/
       
  2435           freetype2/docs/tutorial/step1.html
       
  2436 
       
  2437       or
       
  2438 
       
  2439         http://freetype.sourceforge.net/
       
  2440           freetype2/docs/tutorial/step1.html
       
  2441 
       
  2442     - Many, many comments have been added to the public source file in
       
  2443       order to  automatically generate  the API Reference  through the
       
  2444       `docmaker.py' Python script.
       
  2445 
       
  2446       The latter has been updated  to support the grouping of sections
       
  2447       in chapters and better index sort.  See:
       
  2448 
       
  2449         http://www.freetype.org/freetype2/docs/reference/ft2-toc.html
       
  2450 
       
  2451 
       
  2452   III. CHANGES TO THE BUILD PROCESS
       
  2453 
       
  2454     - If you  are not  building FreeType 2  with its own  build system
       
  2455       (but with your own Makefiles or project files), you will need to
       
  2456       be  aware that  the  build  process has  changed  a little  bit.
       
  2457 
       
  2458       You don't  need to put the  `src' directory in  the include path
       
  2459       when  compiling  any FT2  component.   Instead,  simply put  the
       
  2460       component's directory in the current include path.
       
  2461 
       
  2462       So, if you were doing something like:
       
  2463 
       
  2464         cc -c -Iinclude -Isrc src/base/ftbase.c
       
  2465 
       
  2466       change the line to:
       
  2467 
       
  2468         cc -c -Iinclude -Isrc/base src/base/ftbase.c
       
  2469 
       
  2470       If you were doing something like:
       
  2471 
       
  2472         cd src/base
       
  2473         cc -c -I../../include -I.. ftbase.c
       
  2474 
       
  2475       change it to:
       
  2476 
       
  2477         cd src/base
       
  2478         cc -c -I../../include ftbase.c
       
  2479 
       
  2480 
       
  2481 ======================================================================
       
  2482 
       
  2483 CHANGES BETWEEN 2.0.1 and 2.0
       
  2484 
       
  2485   2.0.1 introduces a few changes:
       
  2486 
       
  2487     - Fixed many bugs related to  the support of CFF / OpenType fonts.
       
  2488       These  formats are  now much  better supported  though  there is
       
  2489       still work planned to  deal with charset tables and PDF-embedded
       
  2490       CFF files that use the old `seac' command.
       
  2491 
       
  2492     - The  library could not  be compiled  in debug  mode with  a very
       
  2493       small  number   of  C  compilers   whose  pre-processors  didn't
       
  2494       implement the `##'  directive correctly (i.e. per se  the ANSI C
       
  2495       specification!)  An elegant fix was found.
       
  2496 
       
  2497     - Added  support for  the  free Borland  command-line C++  Builder
       
  2498       compiler.   Use `make  setup bcc32'.   Also fixed  a  few source
       
  2499       lines that generated new warnings with BCC32.
       
  2500 
       
  2501     - Fixed a bug in FT_Outline_Get_BBox when computing the extrema of
       
  2502       a conic Bezier arc.
       
  2503 
       
  2504     - Updated the INSTALL file to add IDE compilation.
       
  2505 
       
  2506     - Other  minor bug  fixes,  from  invalid Type  1  style flags  to
       
  2507       correct   support   of  synthetic   (obliqued)   fonts  in   the
       
  2508       auto-hinter, better support for embedded bitmaps in a SFNT font.
       
  2509 
       
  2510     - Fixed some problems with `freetype-config'.
       
  2511 
       
  2512   Finally, the `standard' scheme for including FreeType headers is now
       
  2513   gradually changing,  but this will  be explained in a  later release
       
  2514   (probably 2.0.2).
       
  2515 
       
  2516   And very  special thanks to Tom Kacvinsky  and YAMANO-UCHI Hidetoshi
       
  2517   for their contributions!
       
  2518 
       
  2519 
       
  2520 ======================================================================
       
  2521 
       
  2522 CHANGES BETWEEN beta8 and 2.0
       
  2523 
       
  2524   - Changed  the default  installation  path for  public headers  from
       
  2525     `include/freetype' to `include/freetype2'.
       
  2526 
       
  2527     Also added a new `freetype-config' that is automatically generated
       
  2528     and installed  on Unix and  Cygwin systems.  The script  itself is
       
  2529     used to retrieve the current  install path, C compilation flags as
       
  2530     well as linker flags.
       
  2531 
       
  2532   - Fixed several small bugs:
       
  2533 
       
  2534     * Incorrect max advance width for fixed-pitch Type 1 fonts.
       
  2535     * Incorrect glyph names for certain TrueType fonts.
       
  2536     * The  glyph advance  was not  copied when  FT_Glyph_To_Bitmap was
       
  2537       called.
       
  2538     * The  linearHoriAdvance  and  linearVertAdvance  fields  were not
       
  2539       correctly returned for glyphs processed by the auto-hinter.
       
  2540     * `type1z'  renamed back to  `type1'; the  old `type1'  module has
       
  2541       been removed.
       
  2542 
       
  2543   - Revamped the  build system  to make it  a lot more  generic.  This
       
  2544     will  allow us  to  re-use  nearly un-modified  in  lots of  other
       
  2545     projects (including FreeType Layout).
       
  2546 
       
  2547   - Changed `cid' to use `psaux' too.
       
  2548 
       
  2549   - Added the  cache sub-system.  See <freetype/ftcache.h>  as well as
       
  2550     the sources  in `src/cache'.  Note  that it compiles but  is still
       
  2551     untested for now.
       
  2552 
       
  2553   - Updated `docs/docmaker.py', a draft  API reference is available at
       
  2554     http://www.freetype.org/ft2api.html.
       
  2555 
       
  2556   - Changed `type1' to use `psaux'.
       
  2557 
       
  2558   - Created a  new module named  `psaux' to hold  the Type 1 &  Type 2
       
  2559     parsing routines.  It should be  used by `type1', `cid', and `cff'
       
  2560     in the future.
       
  2561 
       
  2562   - Fixed an important bug in `FT_Glyph_Get_CBox'.
       
  2563 
       
  2564   - Fixed  some compiler  warnings  that happened  since the  TrueType
       
  2565     bytecode decoder was deactivated by default.
       
  2566 
       
  2567   - Fixed two memory leaks:
       
  2568 
       
  2569     * The    memory   manager   (16    bytes)   isn't    released   in
       
  2570       FT_Done_FreeType!
       
  2571     * Using custom input streams, the  copy of the original stream was
       
  2572       never released.
       
  2573 
       
  2574   - Fixed the  auto-hinter by performing automatic  computation of the
       
  2575     `filling direction' of each glyph.   This is done through a simple
       
  2576     and  fast approximation, and  seems to  work (problems  spotted by
       
  2577     Werner though).  The Arphic fonts are a lot nicer though there are
       
  2578     still a lot of things to do to handle Asian fonts correctly.
       
  2579 
       
  2580 
       
  2581 ======================================================================
       
  2582 
       
  2583 BETA-8 (RELEASE CANDIDATE) CHANGES
       
  2584 
       
  2585   - Deactivated the TrueType bytecode interpreter by default.
       
  2586 
       
  2587   - Deactivated the `src/type1' font driver.  Now `src/type1z' is used
       
  2588     by default.
       
  2589 
       
  2590   - Updates to the build system.  We now compile the library correctly
       
  2591     under  Unix  system  through  `configure' which  is  automatically
       
  2592     called on the first `make' invocation.
       
  2593 
       
  2594   - Added the auto-hinting module!  Fixing some bugs here and there.
       
  2595 
       
  2596   - Found some bugs in the  composite loader (seac) of the Type1-based
       
  2597     font drivers.
       
  2598 
       
  2599   - Renamed the directory `freetype2/config' to `freetype2/builds' and
       
  2600     updated all relevant files.
       
  2601 
       
  2602   - Found a memory leak in the `type1' driver.
       
  2603 
       
  2604   - Incorporated Tom's patches to  support flex operators correctly in
       
  2605     OpenType/CFF fonts.  Now all I need is to support pure CFF and CEF
       
  2606     fonts to be done with this driver :-)
       
  2607 
       
  2608   - Added the  Windows FNT/FON driver in `src/winfonts'.   For now, it
       
  2609     always  `simulates'   a  Unicode  charmap,  so   it  shouldn't  be
       
  2610     considered completed right now.
       
  2611 
       
  2612     It  is there  to be  more a  proof of  concept than  anything else
       
  2613     anyway.  The driver is a single  C source file, that compiles to 3
       
  2614     Kb of code.
       
  2615 
       
  2616     I'm  still working on  the PCF/BDF  drivers, but  I'm too  lazy to
       
  2617     finish them now.
       
  2618 
       
  2619   - CHANGES TO THE HIGH-LEVEL API
       
  2620 
       
  2621     * FT_Get_Kerning has a new parameter that allows you to select the
       
  2622       coordinates of the kerning  vector (font units, scaled, scaled +
       
  2623       grid-fitted).
       
  2624     * The  outline functions are  now in <freetype/ftoutln.h>  and not
       
  2625       part of <freetype/freetype.h> anymore.
       
  2626     * <freetype/ftmodule.h>    now     contains    declarations    for
       
  2627        FT_New_Library, FT_Done_Library, FT_Add_Default_Modules.
       
  2628     * The so-called convenience  functions have moved from `ftoutln.c'
       
  2629       to  `ftglyph.c',  and  are  thus available  with  this  optional
       
  2630       component    of   the   library.     They   are    declared   in
       
  2631       <freetype/ftglyph.h> now.
       
  2632     * Anti-aliased  rendering is now  the default  for FT_Render_Glyph
       
  2633       (i.e. corresponds to render_mode == 0 == ft_render_mode_normal).
       
  2634       To generate a monochrome bitmap, use ft_render_mode_mono, or the
       
  2635       FT_LOAD_MONOCHROME     flag    in    FT_Load_Glyph/FT_Load_Char.
       
  2636       FT_LOAD_ANTI_ALIAS is still defined, but values to 0.
       
  2637     * <freetype/freetype.h>  now include <freetype/config/ftconfig.h>,
       
  2638       solving a few headaches :-)
       
  2639     * The type FT_GlyphSlotRec has now a `library' field.
       
  2640 
       
  2641   - CHANGES TO THE `ftglyph.h' API
       
  2642 
       
  2643     This API has  been severely modified in order  to make it simpler,
       
  2644     clearer, and more  efficient.  It certainly now looks  like a real
       
  2645     `glyph factory'  object, and allows client  applications to manage
       
  2646     (i.e.  transform,  bbox  and  render) glyph  images  without  ever
       
  2647     knowing their original format.
       
  2648 
       
  2649   - Added  support  for CID-keyed  fonts  to  the  CFF driver.   Maybe
       
  2650     support for pure CFF + CEF fonts should come in?
       
  2651 
       
  2652   - Cleaned up  source code in order  to avoid two  functions with the
       
  2653     same name.  Also  changed the names of the  files in `type1z' from
       
  2654     `t1XXXX' to `z1XXXX' in order to avoid any conflicts.
       
  2655 
       
  2656     `make multi' now works well :-)
       
  2657 
       
  2658     Also removed the use of `cidafm' for now, even if the source files
       
  2659     are  still there.  This  functionality will  certainly  go into  a
       
  2660     specific module.
       
  2661 
       
  2662   - ADDED SUPPORT FOR THE AUTO-HINTER
       
  2663 
       
  2664     It  works :-) I  have a  demo program  which simply  is a  copy of
       
  2665     `ftview'       that      does       a      `FT_Add_Module(library,
       
  2666     &autohinter_module_class)' after  library initialization, and Type
       
  2667     1 & OpenType/CFF fonts are now hinted.
       
  2668 
       
  2669     CID  fonts are  not hinted,  as they  include no  charmap  and the
       
  2670     auto-hinter doesn't include  `generic' global metrics computations
       
  2671     yet.
       
  2672 
       
  2673     Now, I need to release this thing to the FreeType 2 source.
       
  2674 
       
  2675   - CHANGES TO THE RENDERER MODULES
       
  2676 
       
  2677     The  monochrome  and smooth  renderers  are  now  in two  distinct
       
  2678     directories, namely `src/raster1' and `src/smooth'.  Note that the
       
  2679     old `src/renderer' is now gone.
       
  2680 
       
  2681     I ditched  the 5-gray-levels renderers.  Basically,  it involved a
       
  2682     simple #define toggle in 'src/raster1/ftraster.c'.
       
  2683 
       
  2684     FT_Render_Glyph,  FT_Outline_Render  &  FT_Outline_Get_Bitmap  now
       
  2685     select the best renderer  available, depending on render mode.  If
       
  2686     the current renderer for a  given glyph image format isn't capable
       
  2687     of supporting  the render mode, another  one will be  found in the
       
  2688     library's list.   This means that client applications  do not need
       
  2689     to  switch or  set  the  renderers themselves  (as  in the  latest
       
  2690     change), they'll get what they want automatically.  At last.
       
  2691 
       
  2692     Changed the demo programs accordingly.
       
  2693 
       
  2694   - MAJOR INTERNAL REDESIGN:
       
  2695 
       
  2696     A lot of internal modifications  have been performed lately on the
       
  2697     source in order to provide the following enhancements:
       
  2698 
       
  2699     * More generic module support:
       
  2700 
       
  2701       The FT_Module  type is  now defined to  represent a handle  to a
       
  2702       given  module.   The  file  <freetype/ftmodule.h>  contains  the
       
  2703       FT_Module_Class definition, as well as the module-loading public
       
  2704       API.
       
  2705 
       
  2706       The  FT_Driver type  is still  defined, and  still  represents a
       
  2707       pointer to  a font driver.  Note that  FT_Add_Driver is replaced
       
  2708       by FT_Add_Module, FT_Get_Driver by FT_Get_Module, etc.
       
  2709 
       
  2710     * Support for generic glyph image types:
       
  2711 
       
  2712       The FT_Renderer  type is a pointer  to a module  used to perform
       
  2713       various operations on glyph image.
       
  2714 
       
  2715       Each renderer is  capable of handling images in  a single format
       
  2716       (e.g. ft_glyph_format_outline).  Its functions are used to:
       
  2717 
       
  2718       - transform an glyph image
       
  2719       - render a glyph image into a bitmap
       
  2720       - return the control box (dimensions) of a given glyph image
       
  2721 
       
  2722       The scan converters `ftraster.c' and `ftgrays.c' have been moved
       
  2723       to the new directory `src/renderer', and are used to provide two
       
  2724       default renderer modules.
       
  2725 
       
  2726       One corresponds  to the `standard' scan-converter,  the other to
       
  2727       the `smooth' one.
       
  2728 
       
  2729       he  current  renderer  can  be  set  through  the  new  function
       
  2730       FT_Set_Renderer.
       
  2731 
       
  2732       The old raster-related function FT_Set_Raster, FT_Get_Raster and
       
  2733       FT_Set_Raster_Mode have now disappeared, in favor of the new:
       
  2734 
       
  2735         FT_Get_Renderer
       
  2736         FT_Set_Renderer
       
  2737 
       
  2738       See the file <freetype/ftrender.h> for more details.
       
  2739 
       
  2740       These  changes  were  necessary  to properly  support  different
       
  2741       scalable formats in the future, like bi-color glyphs, etc.
       
  2742 
       
  2743     * Glyph loader object:
       
  2744 
       
  2745       A  new  internal  object,  called  a  'glyph  loader'  has  been
       
  2746       introduced in the base layer.  It is used by all scalable format
       
  2747       font drivers to load glyphs and composites.
       
  2748 
       
  2749       This object  has been  created to reduce  the code size  of each
       
  2750       driver,  as  each  one  of  them  basically  re-implemented  its
       
  2751       functionality.
       
  2752 
       
  2753       See <freetype/internal/ftobjs.h> and the FT_GlyphLoader type for
       
  2754       more information.
       
  2755 
       
  2756     * FT_GlyphSlot has new fields:
       
  2757 
       
  2758       In  order   to  support  extended  features   (see  below),  the
       
  2759       FT_GlyphSlot structure has a few new fields:
       
  2760 
       
  2761       linearHoriAdvance:
       
  2762 
       
  2763         This  field  gives  the   linearly  scaled  (i.e.  scaled  but
       
  2764         unhinted) advance  width for the  glyph, expressed as  a 16.16
       
  2765         fixed pixel value.  This is useful to perform WYSIWYG text.
       
  2766 
       
  2767       linearVertAdvance:
       
  2768         This field  gives the linearly  scaled advance height  for the
       
  2769         glyph  (relevant in  vertical  glyph layouts  only).  This  is
       
  2770         useful to perform WYSIWYG text.
       
  2771 
       
  2772         Note that  the two above field replace  the removed `metrics2'
       
  2773         field in the glyph slot.
       
  2774 
       
  2775       advance:
       
  2776         This field is a vector  that gives the transformed advance for
       
  2777         the glyph.   By default, it corresponds to  the advance width,
       
  2778         unless  FT_LOAD_VERTICAL_LAYOUT  was  specified  when  calling
       
  2779         FT_Load_Glyph or FT_Load_Char.
       
  2780 
       
  2781       bitmap_left:
       
  2782         This  field gives  the  distance in  integer  pixels from  the
       
  2783         current pen position  to the left-most pixel of  a glyph image
       
  2784         IF IT IS  A BITMAP.  It is only valid  when the `format' field
       
  2785         is set to `ft_glyph_format_bitmap', for example, after calling
       
  2786         the new function FT_Render_Glyph.
       
  2787 
       
  2788       bitmap_top:
       
  2789         This  field gives  the  distance in  integer  pixels from  the
       
  2790         current pen position (located on the baseline) to the top-most
       
  2791         pixel of the  glyph image IF IT IS  A BITMAP.  Positive values
       
  2792         correspond to upwards Y.
       
  2793 
       
  2794       loader:
       
  2795         This  is a  new  private  field for  the  glyph slot.   Client
       
  2796         applications should not touch it.
       
  2797 
       
  2798 
       
  2799     * Support for transforms and direct rendering in FT_Load_Glyph:
       
  2800 
       
  2801       Most of the functionality found in <freetype/ftglyph.h> has been
       
  2802       moved to the core library.  Hence, the following:
       
  2803 
       
  2804       - A   transform   can   be   specified  for   a   face   through
       
  2805         FT_Set_Transform.  this transform  is applied by FT_Load_Glyph
       
  2806         to  scalable glyph  images (i.e.  NOT TO  BITMAPS)  before the
       
  2807         function returns, unless the bit flag FT_LOAD_IGNORE_TRANSFORM
       
  2808         was set in the load flags.
       
  2809 
       
  2810       - Once  a  glyph image  has  been  loaded,  it can  be  directly
       
  2811         converted  to  a  bitmap  by  using  the  new  FT_Render_Glyph
       
  2812         function.  Note that this  function takes the glyph image from
       
  2813         the glyph slot,  and converts it to a  bitmap whose properties
       
  2814         are returned  in `face.glyph.bitmap', `face.glyph.bitmap_left'
       
  2815         and `face.glyph.bitmap_top'.  The  original native image might
       
  2816         be lost after the conversion.
       
  2817 
       
  2818       - When using the new  bit flag FT_LOAD_RENDER, the FT_Load_Glyph
       
  2819         and   FT_Load_Char   functions   will   call   FT_Render_Glyph
       
  2820         automatically when needed.
       
  2821 
       
  2822   - Reformatted all  modules source  code in order  to get rid  of the
       
  2823     basic data types redifinitions (i.e. `TT_Int' instead of `FT_Int',
       
  2824     `T1_Fixed'  instead  of  `FT_Fixed').  Hence  the  format-specific
       
  2825     prefixes like  `TT_', `T1_',  `T2_' and `CID_'  are only  used for
       
  2826     relevant structures.
       
  2827 
       
  2828 
       
  2829 ======================================================================
       
  2830 
       
  2831 OLD CHANGES FOR BETA 7
       
  2832 
       
  2833   - bug-fixed the  OpenType/CFF parser.  It  now loads and displays my
       
  2834     two  fonts nicely,  but I'm  pretty certain  that more  testing is
       
  2835     needed :-)
       
  2836 
       
  2837   - fixed the crummy Type 1 hinter, it now handles accented characters
       
  2838     correctly (well, the accent is  not always well placed, but that's
       
  2839     another problem..)
       
  2840 
       
  2841   - added the CID-keyed Type 1 driver in `src/cid'.  Works pretty well
       
  2842     for only 13 Kb of code  ;-) Doesn't read AFM files though, nor the
       
  2843     really useful CMAP files..
       
  2844 
       
  2845   - fixed  two  bugs  in  the  smooth  renderer  (src/base/ftgrays.c).
       
  2846     Thanks to Boris Letocha for spotting them and providing a fix.
       
  2847 
       
  2848   - fixed potential `divide by zero' bugs in ftcalc.c.
       
  2849 
       
  2850   - added source  code for  the OpenType/CFF driver  (still incomplete
       
  2851     though..)
       
  2852 
       
  2853   - modified the  SFNT driver slightly  to perform more  robust header
       
  2854     checks  in TT_Load_SFNT_Header.  This prevents certain  font files
       
  2855     (e.g.  some  Type  1  Multiple  Masters)  from  being  incorrectly
       
  2856     `recognized' as TrueType font files..
       
  2857 
       
  2858   - moved a lot of stuff from  the TrueType driver to the SFNT module,
       
  2859     this   allows   greater   code   re-use   between   font   drivers
       
  2860     (e.g. TrueType, OpenType, Compact-TrueType, etc..)
       
  2861 
       
  2862   - added a tiny segment cache to the SFNT Charmap 4 decoder, in order
       
  2863     to minimally speed it up..
       
  2864 
       
  2865   - added  support for  Multiple Master  fonts in  `type1z'.  There is
       
  2866     also a new file named <freetype/ftmm.h> which defines functions to
       
  2867     manage them from client applications.
       
  2868 
       
  2869     The new file `src/base/ftmm.c' is also optional to the engine..
       
  2870 
       
  2871   - various  formatting changes (e.g.  EXPORT_DEF ->  FT_EXPORT_DEF) +
       
  2872     small bug fixes in FT_Load_Glyph, the `type1' driver, etc..
       
  2873 
       
  2874   - a minor fix to the Type 1 driver to let them apply the font matrix
       
  2875     correctly (used for many oblique fonts..)
       
  2876 
       
  2877   - some fixes for 64-bit systems (mainly changing some FT_TRACE calls
       
  2878     to use %p instead of %lx).  Thanks to Karl Robillard.
       
  2879 
       
  2880   - fixed  some bugs  in  the sbit  loader (src/base/sfnt/ttsbit.c)  +
       
  2881     added  a new flag,  FT_LOAD_CROP_BITMAP to  query that  bitmaps be
       
  2882     cropped when  loaded from a file  (maybe I should  move the bitmap
       
  2883     cropper to the base layer ??).
       
  2884 
       
  2885   - changed the default  number of gray levels of  the smooth renderer
       
  2886     to 256  (instead of  the previous 128).  Of course, the  human eye
       
  2887     can't see any difference ;-)
       
  2888 
       
  2889   - removed TT_MAX_SUBGLYPHS,  there is no static limit  on the number
       
  2890     of subglyphs in a TrueType font now..
       
  2891 
       
  2892 
       
  2893 ======================================================================
       
  2894 
       
  2895 OLD CHANGES 16 May 2000
       
  2896 
       
  2897   - tagged `BETA-6'  in the  CVS tree.  This one is a  serious release
       
  2898     candidate even though it doesn't incorporate the auto-hinter yet..
       
  2899 
       
  2900   - various obsolete files were removed, and copyright header updated
       
  2901 
       
  2902   - finally  updated  the  standard   raster  to  fix  the  monochrome
       
  2903     rendering bug + re-enable  support for 5-gray levels anti-aliasing
       
  2904     (suck, suck..)
       
  2905 
       
  2906   - created new header files, and modified sources accordingly:
       
  2907 
       
  2908      <freetype/fttypes.h>
       
  2909        - simple FreeType types, without the API
       
  2910      <freetype/internal/ftmemory.h>
       
  2911        - definition of memory-management macros
       
  2912 
       
  2913   - added   the   `DSIG'   (OpenType   Digital   Signature)   tag   to
       
  2914     <freetype/tttags.h>
       
  2915 
       
  2916   - light update/cleaning of the build system + changes to the sources
       
  2917     in  order  to  get  rid  of _all_  compiler  warnings  with  three
       
  2918     compilers, i.e:
       
  2919 
       
  2920     gcc with `-ansi -pedantic -Wall -W', Visual C++ with `/W3 /WX' and
       
  2921     LCC
       
  2922 
       
  2923     IMPORTANT NOTE FOR WIN32-LCC USERS:
       
  2924     |
       
  2925     |  It seems the C pre-processor  that comes with LCC is broken, it
       
  2926     |  doesn't  recognize  the  ANSI  standard  directives  #  and  ##
       
  2927     |  correctly   when  one  of   the  argument  is  a  macro.  Also,
       
  2928     |  something like:
       
  2929     |
       
  2930     |     #define F(x)  print##x
       
  2931     |
       
  2932     |     F(("hello"))
       
  2933     |
       
  2934     |  will get incorrectly translated to:
       
  2935     |
       
  2936     |     print "hello")
       
  2937     |
       
  2938     |  by its pre-processor.  For this reason, you simply cannot build
       
  2939     |  FreeType 2 in debug mode with this compiler..
       
  2940 
       
  2941   - yet  another massive grunt work.  I've  changed the  definition of
       
  2942     the EXPORT_DEF,  EXPORT_FUNC, BASE_DEF &  BASE_FUNC macros.  These
       
  2943     now take an argument, which is the function's return value type.
       
  2944 
       
  2945     This  is necessary to  compile FreeType  as a  DLL on  Windows and
       
  2946     OS/2.  Depending on the compiler used, a compiler-specific keyword
       
  2947     like  __export or __system  must be  placed before  (VisualC++) or
       
  2948     after (BorlandC++) the type..
       
  2949 
       
  2950     Of course, this needed a lot of changes throughout the source code
       
  2951     to make it compile again...  All cleaned up now, apparently..
       
  2952 
       
  2953     Note also  that there is a  new EXPORT_VAR macro  defined to allow
       
  2954     the   _declaration_    of   an   exportable    public   (constant)
       
  2955     variable.  This  is  the   case  of  the  raster  interfaces  (see
       
  2956     ftraster.h and ftgrays.h), as well as each module's interface (see
       
  2957     sfdriver.h, psdriver.h, etc..)
       
  2958 
       
  2959   - new feature: it  is now possible to pass  extra parameters to font
       
  2960                  drivers  when creating  a new  face object.  For now,
       
  2961                  this capability is unused.  It could however prove to
       
  2962                  be useful in a near future..
       
  2963 
       
  2964       the FT_Open_Args structure was  changes, as well as the internal
       
  2965       driver interface  (the specific `init_face'  module function has
       
  2966       now a different signature).
       
  2967 
       
  2968   - updated the tutorial (not finished though).
       
  2969 
       
  2970   - updated the top-level BUILD  document
       
  2971 
       
  2972   - fixed  a  potential memory  leak  that  could  occur when  loading
       
  2973     embedded bitmaps.
       
  2974 
       
  2975   - added     the     declaration     of     FT_New_Memory_Face     in
       
  2976     <freetype/freetype.h>, as  it was  missing from the  public header
       
  2977     (the implementation was already in `ftobjs.c').
       
  2978 
       
  2979   - the file <freetype/fterrors.h> has been seriously updated in order
       
  2980     to allow  the automatic generation  of error message tables.   See
       
  2981     the comments within it for more information.
       
  2982 
       
  2983   - major directory  hierarchy re-organisation.  This was done for two
       
  2984     things:
       
  2985 
       
  2986       * first,  to ease  the `manual'  compilation of  the  library by
       
  2987         requiring at lot less include paths :-)
       
  2988 
       
  2989       * second,  to  allow  external  programs to  effectively  access
       
  2990         internal  data  fields.  For example,  this  can be  extremely
       
  2991         useful if  someone wants  to write a  font producer or  a font
       
  2992         manager on top of FreeType.
       
  2993 
       
  2994     Basically, you  should now use  the 'freetype/' prefix  for header
       
  2995     inclusion, as in:
       
  2996 
       
  2997         #include <freetype/freetype.h>
       
  2998         #include <freetype/ftglyph.h>
       
  2999 
       
  3000     Some new include sub-directories are available:
       
  3001 
       
  3002      a. the  `freetype/config' directory,  contains two files  used to
       
  3003         configure  the  build  of  the  library.  Client  applications
       
  3004         should  not need  to look  at these  normally, but they can if
       
  3005         they want.
       
  3006 
       
  3007         #include <freetype/config/ftoption.h>
       
  3008         #include <freetype/config/ftconfig.h>
       
  3009 
       
  3010      b. the `freetype/internal'  directory, contains header files that
       
  3011         describes library  internals.  These are the header files that
       
  3012         were  previously  found  in  the `src/base'  and  `src/shared'
       
  3013         directories.
       
  3014 
       
  3015 
       
  3016     As  usual, the build  system and  the demos  have been  updated to
       
  3017     reflect the change..
       
  3018 
       
  3019     Here's a layout of the new directory hierarchy:
       
  3020 
       
  3021     TOP_DIR
       
  3022       include/
       
  3023          freetype/
       
  3024             freetype.h
       
  3025             ...
       
  3026             config/
       
  3027               ftoption.h
       
  3028               ftconfig.h
       
  3029               ftmodule.h
       
  3030 
       
  3031             internal/
       
  3032               ftobjs.h
       
  3033               ftstream.h
       
  3034               ftcalc.h
       
  3035               ...
       
  3036 
       
  3037       src/
       
  3038          base/
       
  3039             ...
       
  3040 
       
  3041          sfnt/
       
  3042          psnames/
       
  3043          truetype/
       
  3044          type1/
       
  3045          type1z/
       
  3046 
       
  3047 
       
  3048     Compiling a module is now  much easier, for example, the following
       
  3049     should work when in the TOP_DIR directory on an ANSI build:
       
  3050 
       
  3051        gcc -c -I./include -I./src/base src/base/ftbase.c
       
  3052        gcc -c -I./include -I./src/sfnt src/sfnt/sfnt.c
       
  3053        etc..
       
  3054 
       
  3055     (of course, using -Iconfig/<system> if you provide system-specific
       
  3056      configuration files).
       
  3057 
       
  3058   - updated the structure of FT_Outline_Funcs in order to allow direct
       
  3059     coordinate scaling within  the outline decomposition routine (this
       
  3060     is  important for virtual  `on' points  with TrueType  outlines) +
       
  3061     updates to the rasters to support this..
       
  3062 
       
  3063   - updated  the OS/2  table  loading code  in `src/sfnt/ttload.c'  in
       
  3064     order to support version 2 of the table (see OpenType 1.2 spec)
       
  3065 
       
  3066   - created  `include/tttables.h'  and  `include/t1tables.h' to  allow
       
  3067     client applications to access some of  the SFNT and T1 tables of a
       
  3068     face  with  a  procedural  interface (see  `FT_Get_Sfnt_Table')  +
       
  3069     updates to internal source files to reflect the change..
       
  3070 
       
  3071   - some  cleanups in  the source  code to  get rid  of  warnings when
       
  3072     compiling with the `-Wall -W -ansi -pedantic' options in gcc.
       
  3073 
       
  3074   - debugged and moved the smooth renderer to `src/base/ftgrays.c' and
       
  3075     its header to `include/ftgrays.h'
       
  3076 
       
  3077   - updated TT_MAX_SUBGLYPHS  to 96 as some CJK  fonts have composites
       
  3078     with up to 80 sub-glyphs !! Thanks to Werner
       
  3079 
       
  3080 
       
  3081 ======================================================================
       
  3082 
       
  3083 OLD CHANGES - 14-apr-2000
       
  3084 
       
  3085   - fixed  a bug  in  the  TrueType glyph  loader  that prevented  the
       
  3086     correct loading of some CJK glyphs in mingli.ttf
       
  3087 
       
  3088   - improved the standard Type 1 hinter in `src/type1'
       
  3089 
       
  3090   - fixed two bugs  in the experimental Type 1  driver in `src/type1z'
       
  3091     to handle the new XFree86 4.0 fonts (and a few other ones..)
       
  3092 
       
  3093   - the smooth  renderer is now  complete and supports  sub-banding to
       
  3094     render large glyphs  at high speed.  However, it is still  located
       
  3095     in `demos/src/ftgrays.c' and should move to the  library itself in
       
  3096     the next  beta.  NOTE: The  smooth  renderer  doesn't  compile  in
       
  3097     stand-alone mode anymore, but this should be fixed RSN..
       
  3098 
       
  3099   - introduced convenience  functions to  more easily deal  with glyph
       
  3100     images, see  `include/ftglyph.h' for more details, as  well as the
       
  3101     new  demo program  named `demos/src/ftstring.c'  that demonstrates
       
  3102     its use
       
  3103 
       
  3104   - implemented  FT_LOAD_NO_RECURSE in  both the  TrueType and  Type 1
       
  3105     drivers  (this  is required  by  the  auto-hinter  to improve  its
       
  3106     results).
       
  3107 
       
  3108   - changed   the  raster   interface,  in   order  to   allow  client
       
  3109     applications  to   provide  their   own  span-drawing   callbacks.
       
  3110     However,   only   the   smooth   renderer   supports   this.   See
       
  3111     `FT_Raster_Params' in the file `include/ftimage.h'.
       
  3112 
       
  3113   - fixed  a small bug  in FT_MulFix  that caused  incorrect transform
       
  3114     computation!
       
  3115 
       
  3116   - Note: The tutorial is out-of-date.
       
  3117 
       
  3118 
       
  3119 ======================================================================
       
  3120 
       
  3121 OLD CHANGES - 12-mar-2000
       
  3122 
       
  3123   - changed  the  layout  of  configuration  files  :  now,  all  ANSI
       
  3124     configuration         files         are         located         in
       
  3125     `freetype2/config'.  System-specific over-rides  can be  placed in
       
  3126     `freetype2/config/<system>'.
       
  3127 
       
  3128   - moved all configuration macros to `config/ftoption.h'
       
  3129 
       
  3130   - improvements in the Type 1 driver with AFM support
       
  3131 
       
  3132   - changed the fields  in the FT_Outline structure :  the old `flags'
       
  3133     array is re-named `tags', while all ancient flags are encoded into
       
  3134     a single unsigned int named `flags'.
       
  3135 
       
  3136   - introduced     new      flags     in     FT_Outline.flags     (see
       
  3137     ft_outline_.... enums in `ftimage.h').
       
  3138 
       
  3139   - changed outline functions to `FT_Outline_<action>' syntax
       
  3140 
       
  3141   - added a smooth anti-alias renderer to the demonstration programs
       
  3142 
       
  3143   - added Mac graphics driver (thanks Just)
       
  3144 
       
  3145   - FT_Open_Face  changed  in  order   to  received  a  pointer  to  a
       
  3146     FT_Open_Args descriptor..
       
  3147 
       
  3148   - various  cleanups,  a  few  more API  functions  implemented  (see
       
  3149     FT_Attach_File)
       
  3150 
       
  3151   - updated some docs
       
  3152 
       
  3153 
       
  3154 ======================================================================
       
  3155 
       
  3156 OLD CHANGES - 22-feb-2000
       
  3157 
       
  3158   - introduced the `psnames' module.  It is used to:
       
  3159 
       
  3160       o convert  a Postscript glyph  name into the  equivalent Unicode
       
  3161         character code (used by the  Type 1 driver(s) to synthesize on
       
  3162         the fly a Unicode charmap).
       
  3163 
       
  3164       o provide an  interface to retrieve the Postscript  names of the
       
  3165         Macintosh,  Adobe  Standard &  Adobe  Expert character  codes.
       
  3166         (the Macintosh  names are  used by the  SFNT-module postscript
       
  3167         names support routines, while the other two tables are used by
       
  3168         the Type 1 driver(s)).
       
  3169 
       
  3170   - introduced the `type1z' alternate Type 1 driver.  This is a (still
       
  3171     experimental) driver  for the Type  1 format that  will ultimately
       
  3172     replace the one  in `src/type1'.  It uses pattern matching to load
       
  3173     data from the font, instead of a finite  state analyzer.  It works
       
  3174     much better than the `old' driver with `broken' fonts.  It is also
       
  3175     much smaller (under 15 Kb).
       
  3176 
       
  3177   - the  Type 1  drivers (both  in `src/type1'  and  `src/type1z') are
       
  3178     nearly  complete.  They  both  provide automatic  Unicode  charmap
       
  3179     synthesis through  the `psnames' module.  No re-encoding vector is
       
  3180     needed.  (note  that they  still  leak  memory  due to  some  code
       
  3181     missing, and I'm getting lazy).
       
  3182 
       
  3183     Trivial AFM support has been added to read kerning information but
       
  3184     wasn't exactly tested as it should ;-)
       
  3185 
       
  3186   - The TrueType  glyph loader has  been seriously rewritten  (see the
       
  3187     file  `src/truetype/ttgload.c'.  It is now  much, much  simpler as
       
  3188     well as  easier to read,  maintain and understand  :-) Preliminary
       
  3189     versions introduced a  memory leak that has been  reported by Jack
       
  3190     Davis, and is now fixed..
       
  3191 
       
  3192   - introduced  the new  `ft_glyph_format_plotter', used  to represent
       
  3193     stroked outlines  like Windows `Vector' fonts, and  certain Type 1
       
  3194     fonts  like `Hershey'.  The corresponding  raster will  be written
       
  3195     soon.
       
  3196 
       
  3197   - FT_New_Memory_Face  is  gone.  Likewise,  FT_Open_Face has  a  new
       
  3198     interface that uses a structure  to describe the input stream, the
       
  3199     driver (if required), etc..
       
  3200 
       
  3201 
       
  3202 TODO
       
  3203 
       
  3204   - Write FT_Get_Glyph_Bitmap and FT_Load_Glyph_Bitmap
       
  3205 
       
  3206   - Add a function like FT_Load_Character(face, char_code, load_flags)
       
  3207     that  would   really  embed  a  call   to  FT_Get_Char_Index  then
       
  3208     FT_Load_Glyph to ease developer's work.
       
  3209 
       
  3210   - Update the tutorial!
       
  3211 
       
  3212   - consider adding  support for Multiple  Master fonts in the  Type 1
       
  3213     drivers.
       
  3214 
       
  3215   - Test the AFM routines of the  Type 1 drivers to check that kerning
       
  3216     information is returned correctly.
       
  3217 
       
  3218   - write a decent auto-gridding component  !! We need this to release
       
  3219     FreeType 2.0 gold !
       
  3220 
       
  3221 
       
  3222 less urgent needs:
       
  3223 
       
  3224   - add a CFF/Type2 driver
       
  3225   - add a BDF driver
       
  3226   - add a FNT/PCF/HBF driver
       
  3227   - add a Speedo driver from the X11 sources
       
  3228 
       
  3229 
       
  3230 ======================================================================
       
  3231 
       
  3232 OLDER CHANGES - 27-jan-2000
       
  3233 
       
  3234   - updated the  `sfnt' module  interface to allow  several SFNT-based
       
  3235     drivers to co-exist peacefully
       
  3236 
       
  3237   - updated  the `T1_Face'  type  to better  separate Postscript  font
       
  3238     content  from the  rest of  the FT_Face  structure.  Might be used
       
  3239     later by the CFF/Type2 driver..
       
  3240 
       
  3241   - added an experimental replacement Type 1 driver featuring advanced
       
  3242     (and speedy) pattern matching to retrieve the data from postscript
       
  3243     fonts.
       
  3244 
       
  3245   - very minor  changes in the implementation  of FT_Set_Char_Size and
       
  3246     FT_Set_Pixel_Sizes (they now implement default to lighten the font
       
  3247     driver's code).
       
  3248 
       
  3249 
       
  3250 ======================================================================
       
  3251 
       
  3252 OLD MESSAGE
       
  3253 
       
  3254 This file summarizes the changes  that occurred  since the last `beta'
       
  3255 of FreeType 2. Because the list is important, it has been divided into
       
  3256 separate sections:
       
  3257 
       
  3258 Table Of Contents:
       
  3259 
       
  3260     I   High-Level Interface (easier !)
       
  3261    II   Directory Structure
       
  3262   III   Glyph Image Formats
       
  3263    IV   Build System
       
  3264     V   Portability
       
  3265    VI   Font Drivers
       
  3266 
       
  3267 
       
  3268 ----------------------------------------------------------------------
       
  3269 
       
  3270 High-Level Interface:
       
  3271 
       
  3272   The high-level API has been considerably simplified.  Here is how:
       
  3273 
       
  3274     - resource objects have disappeared.  this means that face objects
       
  3275       can now be created with  a single function call (see FT_New_Face
       
  3276       and FT_Open_Face)
       
  3277 
       
  3278     - when calling  either FT_New_Face  & FT_Open_Face, a  size object
       
  3279       and a glyph slot object  are automatically created for the face,
       
  3280       and can  be accessed  through `face->glyph' and  `face->size' if
       
  3281       one really  needs to.   In most cases,  there's no need  to call
       
  3282       FT_New_Size or FT_New_Glyph.
       
  3283 
       
  3284     - similarly,  FT_Load_Glyph  now  only  takes  a  `face'  argument
       
  3285       (instead  of a  glyph  slot  and a  size).  Also,  its  `result'
       
  3286       parameter is  gone, as the glyph  image type is  returned in the
       
  3287       field `face->glyph.format'
       
  3288 
       
  3289     - the list  of available  charmaps is directly  accessible through
       
  3290       `face->charmaps', counting `face->num_charmaps'  elements.  Each
       
  3291       charmap  has an  'encoding'  field which  specifies which  known
       
  3292       encoding it deals with.  Valid values are, for example:
       
  3293 
       
  3294           ft_encoding_unicode      (for ASCII, Latin-1 and Unicode)
       
  3295           ft_encoding_apple_roman
       
  3296           ft_encoding_sjis
       
  3297           ft_encoding_adobe_standard
       
  3298           ft_encoding_adobe_expert
       
  3299 
       
  3300       other  values may  be added  in the  future.  Each charmap still
       
  3301       holds  its `platform_id'  and `encoding_id'  values in  case the
       
  3302       encoding is too exotic for the current library
       
  3303 
       
  3304 
       
  3305 ----------------------------------------------------------------------
       
  3306 
       
  3307 Directory Structure:
       
  3308 
       
  3309   Should seem obvious to most of you:
       
  3310 
       
  3311      freetype/
       
  3312          config/        -- configuration sub-makefiles
       
  3313             ansi/
       
  3314             unix/       -- platform-specific configuration files
       
  3315             win32/
       
  3316             os2/
       
  3317             msdos/
       
  3318 
       
  3319          include/       -- public header  files, those to  be included
       
  3320                            directly by client apps
       
  3321 
       
  3322          src/           -- sources of the library
       
  3323            base/        -- the base layer
       
  3324            sfnt/        -- the sfnt `driver'  (see the drivers section
       
  3325                            below)
       
  3326            truetype/    -- the truetype driver
       
  3327            type1/       -- the type1 driver
       
  3328            shared/      -- some header files shared between drivers
       
  3329 
       
  3330          demos/         -- demos/tools
       
  3331 
       
  3332          docs/          -- documentation (a bit empty for now)
       
  3333 
       
  3334 
       
  3335 ----------------------------------------------------------------------
       
  3336 
       
  3337 Glyph Image Formats:
       
  3338 
       
  3339   Drivers are now able to  register new glyph image formats within the
       
  3340   library.  For  now, the  base layer supports  of course  bitmaps and
       
  3341   vector  outlines, but  one  could imagine  something different  like
       
  3342   colored bitmaps, bi-color vectors or whatever else (Metafonts anyone
       
  3343   ??).
       
  3344 
       
  3345   See  the   file  `include/ftimage.h'.   Note  also  that   the  type
       
  3346   FT_Raster_Map  is gone,  and  is now  replaced  by FT_Bitmap,  which
       
  3347   should encompass all known bitmap types.
       
  3348 
       
  3349   Each new  image format  must provide at  least one `raster',  i.e. a
       
  3350   module capable of  transforming the glyph image into a bitmap.  It's
       
  3351   also possible  to change the default  raster used for  a given glyph
       
  3352   image format.
       
  3353 
       
  3354   The default outline  scan-converter now uses 128 levels  of grays by
       
  3355   default,  which tends  to smooth  many  things.  Note that the  demo
       
  3356   programs have been updated significantly in order to display these..
       
  3357 
       
  3358 
       
  3359 ----------------------------------------------------------------------
       
  3360 
       
  3361 Build system:
       
  3362 
       
  3363   You still need  GNU Make to build the library.  The build system has
       
  3364   been very seriously re-vamped in order to provide things like :
       
  3365 
       
  3366    - automatic host platform  detection (reverting to 'config/ansi' if
       
  3367      it is not detected, with pseudo-standard compilation flags)
       
  3368 
       
  3369    - the ability to compile from the Makefiles with very different and
       
  3370      exotic compilers.  Note that linking the library can be difficult
       
  3371      for some platforms.
       
  3372 
       
  3373      For example, the file `config/win32/lcclib.bat' is invoked by the
       
  3374      build system to create the `.lib' file with LCC-Win32 because its
       
  3375      librarian  has too  many flaws  to be  invoked directly  from the
       
  3376      Makefile.
       
  3377 
       
  3378   Here's how it works:
       
  3379 
       
  3380   - the first time you type `make',  the build system runs a series of
       
  3381     sub-makefiles  in order  to detect  your host  platform.  It  then
       
  3382     dumps what it found, and creates a file called `config.mk' in  the
       
  3383     current  directory.  This is a  sub-Makefile used  to  define many
       
  3384     important Make variables used to build the library.
       
  3385 
       
  3386   - the second time, the build system detects the `config.mk' then use
       
  3387     it  to  build the  library.  All object  files  go  into 'obj'  by
       
  3388     default,  as well  as the  library file,  but this  can  easily be
       
  3389     changed.
       
  3390 
       
  3391   Note that  you can run `make  setup' to force  another host platform
       
  3392   detection  even   if  a  `config.mk'  is  present   in  the  current
       
  3393   directory.  Another solution  is  simply to  delete  the file,  then
       
  3394   re-run make.
       
  3395 
       
  3396   Finally, the  default compiler  for all platforms  is gcc  (for now,
       
  3397   this will hopefully changed in the future).  You can however specify
       
  3398   a different  compiler by specifying  it after the 'setup'  target as
       
  3399   in:
       
  3400 
       
  3401       gnumake setup lcc         on Win32 to use the LCC compiler
       
  3402       gnumake setup visualc     on Win32 to use Visual C++
       
  3403 
       
  3404   See  the file  `config/<system>/detect.mk' for  a list  of supported
       
  3405   compilers for your platforms.
       
  3406 
       
  3407   It should be relatively easy  to write new detection rules files and
       
  3408   config.mk..
       
  3409 
       
  3410   Finally, to  build the demo programs,  go to `demos'  and launch GNU
       
  3411   Make, it will use the `config.mk'  in the top directory to build the
       
  3412   test programs..
       
  3413 
       
  3414 
       
  3415 ----------------------------------------------------------------------
       
  3416 
       
  3417 Portability:
       
  3418 
       
  3419   In  the  previous  beta,  a  single FT_System  object  was  used  to
       
  3420   encompass  all  low-level  operations like  thread  synchronisation,
       
  3421   memory management and i/o access.  This has been greatly simplified:
       
  3422 
       
  3423     - thread synchronisation  has been dropped, for  the simple reason
       
  3424       that the library  is already re-entrant, and that  if you really
       
  3425       need  two  threads accessing  the  same  FT_Library, you  should
       
  3426       really synchronize access to it yourself with a simple mutex.
       
  3427 
       
  3428     - memory  management is  performed  through a  very simple  object
       
  3429       called `FT_Memory',  which really is a table  containing a table
       
  3430       of pointers to  functions like malloc, realloc and  free as well
       
  3431       as some user data (closure).
       
  3432 
       
  3433     - resources have disappeared (they created more problems than they
       
  3434       solved), and  i/o management have  been simplified greatly  as a
       
  3435       result.  Streams are  defined through  FT_Stream objects,  which
       
  3436       can be either memory-based or disk-based.
       
  3437 
       
  3438       Note that  each face  has its own  stream, which is  closed only
       
  3439       when  the  face object  is  destroyed.  Hence,  a function  like
       
  3440       TT_Flush_Face in 1.x cannot be directly  supported.  However, if
       
  3441       you really need something like  this, you can easily tailor your
       
  3442       own streams  to achieve the same  feature at a  lower level (and
       
  3443       use FT_Open_Face instead of FT_New_Face to create the face).
       
  3444 
       
  3445   See the file  `include/ftsystem.h' for more details, as  well as the
       
  3446   implementations found in `config/unix' and `config/ansi'.
       
  3447 
       
  3448 
       
  3449 ----------------------------------------------------------------------
       
  3450 
       
  3451 Font Drivers:
       
  3452 
       
  3453   The  Font Driver  interface has  been modified  in order  to support
       
  3454   extensions & versioning.
       
  3455 
       
  3456 
       
  3457   The  list of  the font  drivers that  are statically  linked  to the
       
  3458   library at compile time is  managed through a new configuration file
       
  3459   called `config/<platform>/ftmodule.h'.
       
  3460 
       
  3461   This  file is  autogenerated  when  invoking  `make modules'.   This
       
  3462   target  will  parse  all  sub-directories  of  'src', looking  for a
       
  3463   `module.mk' rules  file, used  to describe  the driver to  the build
       
  3464   system.
       
  3465 
       
  3466   Hence, one  should call  `make modules' each  time a font  driver is
       
  3467   added or removed from the `src' directory.
       
  3468 
       
  3469   Finally, this  version  provides  a `pseudo-driver'  in  `src/sfnt'.
       
  3470   This  driver  doesn't  support  font  files  directly, but  provides
       
  3471   services used by all TrueType-like font drivers.  Hence, its code is
       
  3472   shared between  the TrueType & OpenType  font formats,  and possibly
       
  3473   more formats to come if we're lucky..
       
  3474 
       
  3475 
       
  3476 ----------------------------------------------------------------------
       
  3477 
       
  3478 Extensions support:
       
  3479 
       
  3480   The extensions support is inspired by the one found in 1.x.
       
  3481 
       
  3482   Now, each font driver has  its own `extension registry', which lists
       
  3483   which extensions  are available  for the font  faces managed  by the
       
  3484   driver.
       
  3485 
       
  3486   Extension ids are  now strings, rather than 4-byte  tags, as this is
       
  3487   usually more readable.
       
  3488 
       
  3489   Each extension has:
       
  3490     - some data, associated to each face object
       
  3491     - an interface (table of function pointers)
       
  3492 
       
  3493   An extension  that is format-specific should  simply register itself
       
  3494   to the correct font driver.  Here is some example code:
       
  3495 
       
  3496    // Registering an extensions
       
  3497    //
       
  3498    FT_Error  FT_Init_XXXX_Extension( FT_Library  library )
       
  3499    {
       
  3500      FT_DriverInterface*  tt_driver;
       
  3501 
       
  3502      driver = FT_Get_Driver( library, "truetype" );
       
  3503      if (!driver) return FT_Err_Unimplemented_Feature;
       
  3504 
       
  3505      return FT_Register_Extension( driver, &extension_class );
       
  3506    }
       
  3507 
       
  3508 
       
  3509    // Implementing the extensions
       
  3510    //
       
  3511    FT_Error  FT_Proceed_Extension_XXX( FT_Face  face )
       
  3512    {
       
  3513      FT_XXX_Extension            ext;
       
  3514      FT_XXX_Extension_Interface  ext_interface;
       
  3515 
       
  3516      ext = FT_Get_Extension( face, "extensionid", &ext_interface );
       
  3517      if (!ext) return error;
       
  3518 
       
  3519      return ext_interface->do_it(ext);
       
  3520    }
       
  3521 
       
  3522 ------------------------------------------------------------------------
       
  3523 
       
  3524 Copyright 2000-2011 by
       
  3525 David Turner, Robert Wilhelm, and Werner Lemberg.
       
  3526 
       
  3527 This  file  is  part  of the  FreeType  project, and may  only be  used,
       
  3528 modified,  and  distributed  under  the  terms of  the FreeType  project
       
  3529 license, LICENSE.TXT.   By continuing to use, modify, or distribute this
       
  3530 file you  indicate that  you have  read the  license and understand  and
       
  3531 accept it fully.
       
  3532 
       
  3533 
       
  3534 Local Variables:
       
  3535 version-control: never
       
  3536 coding: utf-8
       
  3537 End:
       
  3538 
       
  3539 --- end of CHANGES ---