blob: 9b598966a00c57e433280da74ed2bf3acecf0dfc [file] [log] [blame]
Werner Lemberg1639c792006-05-06 16:44:58 +00001This file describes various problems that have been encountered in
2compiling, installing and running FreeType 2. Suggestions for
3additions or other improvements to this file are welcome.
Werner Lemberg764b2512006-04-03 16:42:39 +00004
Werner Lemberg1639c792006-05-06 16:44:58 +00005----------------------------------------------------------------------
Werner Lemberg764b2512006-04-03 16:42:39 +00006
Werner Lemberg986ea4b2007-07-04 04:53:15 +00007Running Problems
8================
9
10
11* Some Type 1, Multiple Masters, and CID-keyed PostScript fonts aren't
12 handled correctly.
13
14-----
15
16Of course, there might be bugs in FreeType, but some fonts based on
17the PostScript format can't behandled indeed. The reason is that
18FreeType doesn't contain a full PostScript interpreter but applies
19pattern matching instead. In case a font doesn't follow the standard
20structure of the given font format, FreeType fails. A typical example
21is Adobe's `Optima' font family which contains extra code to switch
22between low and high resolution versions of the glyphs.
23
24It might be possible to patch FreeType in some situations, though.
25Please report failing fonts so that we investigate the problem and set
26up a list of such problematic fonts.
27
28----------------------------------------------------------------------
29
Werner Lemberg764b2512006-04-03 16:42:39 +000030
31Compilation Problems
32====================
33
34
Werner Lemberg1639c792006-05-06 16:44:58 +000035* I get an `internal compilation error' (ICE) while compiling FreeType
36 2.2.1 with Intel C++.
Werner Lemberg764b2512006-04-03 16:42:39 +000037
Werner Lembergde2d90a2006-05-17 08:54:30 +000038 This has been reported for the following compiler version:
39
40 Intel(R) C++ Compiler for 32-bit applications,
41 Version 9.0 Build 20050430Z Package ID: W_CC_P_9.0.019
42
43-----
44
45The best solution is to update the compiler to version
Werner Lemberg764b2512006-04-03 16:42:39 +000046
47 Intel(R) C++ Compiler for 32-bit applications,
Werner Lembergde2d90a2006-05-17 08:54:30 +000048 Version 9.1 Build 20060323Z Package ID: W_CC_P_9.1.022
Werner Lemberg764b2512006-04-03 16:42:39 +000049
Werner Lembergde2d90a2006-05-17 08:54:30 +000050or newer. If this isn't feasible, apply the following patch.
Werner Lemberg764b2512006-04-03 16:42:39 +000051
52
Werner Lembergde2d90a2006-05-17 08:54:30 +000053--- src/cache/ftcbasic.c 20 Mar 2006 12:10:24 -0000 1.20
54+++ src/cache/ftcbasic.c.patched 15 May 2006 02:51:02 -0000
55@@ -252,7 +252,7 @@
56 */
57
58 FT_CALLBACK_TABLE_DEF
59- const FTC_IFamilyClassRec ftc_basic_image_family_class =
60+ FTC_IFamilyClassRec ftc_basic_image_family_class =
61 {
62 {
63 sizeof ( FTC_BasicFamilyRec ),
Werner Lemberg764b2512006-04-03 16:42:39 +000064@@ -266,7 +266,7 @@
Werner Lembergde2d90a2006-05-17 08:54:30 +000065
66
Werner Lemberg764b2512006-04-03 16:42:39 +000067 FT_CALLBACK_TABLE_DEF
68- const FTC_GCacheClassRec ftc_basic_image_cache_class =
69+ FTC_GCacheClassRec ftc_basic_image_cache_class =
70 {
71 {
72 ftc_inode_new,
73
74
Werner Lemberg1639c792006-05-06 16:44:58 +000075----------------------------------------------------------------------
Werner Lemberg986ea4b2007-07-04 04:53:15 +000076
77--- end of PROBLEMS ---