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