Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / freetype / 3aaebe3a91e55021d99b06f95594c5ff9181968a / . / docs / PROBLEMS
blob: 40bdc35a67629030515b4d7aaa803b5844a4b6a0 [file] [log] [blame]
Werner Lemberg1639c792006-05-06 16:44:58 +0000[diff] [blame]1This 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 +0000[diff] [blame]4
Werner Lemberg1639c792006-05-06 16:44:58 +0000[diff] [blame]5----------------------------------------------------------------------
Werner Lemberg764b2512006-04-03 16:42:39 +0000[diff] [blame]6
Werner Lemberg986ea4b2007-07-04 04:53:15 +0000[diff] [blame]7Running 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
Werner Lemberge7d1fb32011-02-24 20:01:00 +0100[diff] [blame]17the PostScript format can't be handled indeed. The reason is that
Werner Lemberg986ea4b2007-07-04 04:53:15 +0000[diff] [blame]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
Werner Lemberge7d1fb32011-02-24 20:01:00 +0100[diff] [blame]28
29* Why do identical FreeType versions render differently on different
30 platforms?
31
32-----
33
34Different distributions compile FreeType with different options. The
35developer version of a distribution's FreeType package, which is
36needed to compile your program against FreeType, includes the file
37ftoption.h. Compare each platform's copy of ftoption.h to find the
38differences.
39
40
Werner Lemberg986ea4b2007-07-04 04:53:15 +0000[diff] [blame]41----------------------------------------------------------------------
42
Werner Lemberg764b2512006-04-03 16:42:39 +0000[diff] [blame]43
44Compilation Problems
45====================
46
47
Werner Lemberg1639c792006-05-06 16:44:58 +0000[diff] [blame]48* I get an `internal compilation error' (ICE) while compiling FreeType
49 2.2.1 with Intel C++.
Werner Lemberg764b2512006-04-03 16:42:39 +0000[diff] [blame]50
Werner Lembergde2d90a2006-05-17 08:54:30 +0000[diff] [blame]51 This has been reported for the following compiler version:
52
53 Intel(R) C++ Compiler for 32-bit applications,
54 Version 9.0 Build 20050430Z Package ID: W_CC_P_9.0.019
55
56-----
57
58The best solution is to update the compiler to version
Werner Lemberg764b2512006-04-03 16:42:39 +0000[diff] [blame]59
60 Intel(R) C++ Compiler for 32-bit applications,
Werner Lembergde2d90a2006-05-17 08:54:30 +0000[diff] [blame]61 Version 9.1 Build 20060323Z Package ID: W_CC_P_9.1.022
Werner Lemberg764b2512006-04-03 16:42:39 +0000[diff] [blame]62
Werner Lembergde2d90a2006-05-17 08:54:30 +0000[diff] [blame]63or newer. If this isn't feasible, apply the following patch.
Werner Lemberg764b2512006-04-03 16:42:39 +0000[diff] [blame]64
65
Werner Lembergde2d90a2006-05-17 08:54:30 +0000[diff] [blame]66--- src/cache/ftcbasic.c 20 Mar 2006 12:10:24 -0000 1.20
67+++ src/cache/ftcbasic.c.patched 15 May 2006 02:51:02 -0000
68@@ -252,7 +252,7 @@
69 */
70
71 FT_CALLBACK_TABLE_DEF
72- const FTC_IFamilyClassRec ftc_basic_image_family_class =
73+ FTC_IFamilyClassRec ftc_basic_image_family_class =
74 {
75 {
76 sizeof ( FTC_BasicFamilyRec ),
Werner Lemberg764b2512006-04-03 16:42:39 +0000[diff] [blame]77@@ -266,7 +266,7 @@
Werner Lembergde2d90a2006-05-17 08:54:30 +0000[diff] [blame]78
79
Werner Lemberg764b2512006-04-03 16:42:39 +0000[diff] [blame]80 FT_CALLBACK_TABLE_DEF
81- const FTC_GCacheClassRec ftc_basic_image_cache_class =
82+ FTC_GCacheClassRec ftc_basic_image_cache_class =
83 {
84 {
85 ftc_inode_new,
86
87
Werner Lemberg1639c792006-05-06 16:44:58 +0000[diff] [blame]88----------------------------------------------------------------------
Werner Lemberg986ea4b2007-07-04 04:53:15 +0000[diff] [blame]89
90--- end of PROBLEMS ---