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