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