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