|
5172
|
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 ---
|