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