Thu, 22 Jan 2015 13:21:57 +0100
Incorporate requested changes from Mozilla in review:
https://bugzilla.mozilla.org/show_bug.cgi?id=1123480#c6
michael@0 | 1 | This file describes various problems that have been encountered in |
michael@0 | 2 | compiling, installing and running FreeType 2. Suggestions for |
michael@0 | 3 | additions or other improvements to this file are welcome. |
michael@0 | 4 | |
michael@0 | 5 | ---------------------------------------------------------------------- |
michael@0 | 6 | |
michael@0 | 7 | Running Problems |
michael@0 | 8 | ================ |
michael@0 | 9 | |
michael@0 | 10 | |
michael@0 | 11 | * Some Type 1, Multiple Masters, and CID-keyed PostScript fonts aren't |
michael@0 | 12 | handled correctly. |
michael@0 | 13 | |
michael@0 | 14 | ----- |
michael@0 | 15 | |
michael@0 | 16 | Of course, there might be bugs in FreeType, but some fonts based on |
michael@0 | 17 | the PostScript format can't be handled indeed. The reason is that |
michael@0 | 18 | FreeType doesn't contain a full PostScript interpreter but applies |
michael@0 | 19 | pattern matching instead. In case a font doesn't follow the standard |
michael@0 | 20 | structure of the given font format, FreeType fails. A typical example |
michael@0 | 21 | is Adobe's `Optima' font family which contains extra code to switch |
michael@0 | 22 | between low and high resolution versions of the glyphs. |
michael@0 | 23 | |
michael@0 | 24 | It might be possible to patch FreeType in some situations, though. |
michael@0 | 25 | Please report failing fonts so that we investigate the problem and set |
michael@0 | 26 | up a list of such problematic fonts. |
michael@0 | 27 | |
michael@0 | 28 | |
michael@0 | 29 | * Why do identical FreeType versions render differently on different |
michael@0 | 30 | platforms? |
michael@0 | 31 | |
michael@0 | 32 | ----- |
michael@0 | 33 | |
michael@0 | 34 | Different distributions compile FreeType with different options. The |
michael@0 | 35 | developer version of a distribution's FreeType package, which is |
michael@0 | 36 | needed to compile your program against FreeType, includes the file |
michael@0 | 37 | ftoption.h. Compare each platform's copy of ftoption.h to find the |
michael@0 | 38 | differences. |
michael@0 | 39 | |
michael@0 | 40 | |
michael@0 | 41 | ---------------------------------------------------------------------- |
michael@0 | 42 | |
michael@0 | 43 | |
michael@0 | 44 | Compilation Problems |
michael@0 | 45 | ==================== |
michael@0 | 46 | |
michael@0 | 47 | |
michael@0 | 48 | * I get an `internal compilation error' (ICE) while compiling FreeType |
michael@0 | 49 | 2.2.1 with Intel C++. |
michael@0 | 50 | |
michael@0 | 51 | This has been reported for the following compiler version: |
michael@0 | 52 | |
michael@0 | 53 | Intel(R) C++ Compiler for 32-bit applications, |
michael@0 | 54 | Version 9.0 Build 20050430Z Package ID: W_CC_P_9.0.019 |
michael@0 | 55 | |
michael@0 | 56 | ----- |
michael@0 | 57 | |
michael@0 | 58 | The best solution is to update the compiler to version |
michael@0 | 59 | |
michael@0 | 60 | Intel(R) C++ Compiler for 32-bit applications, |
michael@0 | 61 | Version 9.1 Build 20060323Z Package ID: W_CC_P_9.1.022 |
michael@0 | 62 | |
michael@0 | 63 | or newer. If this isn't feasible, apply the following patch. |
michael@0 | 64 | |
michael@0 | 65 | |
michael@0 | 66 | --- src/cache/ftcbasic.c 20 Mar 2006 12:10:24 -0000 1.20 |
michael@0 | 67 | +++ src/cache/ftcbasic.c.patched 15 May 2006 02:51:02 -0000 |
michael@0 | 68 | @@ -252,7 +252,7 @@ |
michael@0 | 69 | */ |
michael@0 | 70 | |
michael@0 | 71 | FT_CALLBACK_TABLE_DEF |
michael@0 | 72 | - const FTC_IFamilyClassRec ftc_basic_image_family_class = |
michael@0 | 73 | + FTC_IFamilyClassRec ftc_basic_image_family_class = |
michael@0 | 74 | { |
michael@0 | 75 | { |
michael@0 | 76 | sizeof ( FTC_BasicFamilyRec ), |
michael@0 | 77 | @@ -266,7 +266,7 @@ |
michael@0 | 78 | |
michael@0 | 79 | |
michael@0 | 80 | FT_CALLBACK_TABLE_DEF |
michael@0 | 81 | - const FTC_GCacheClassRec ftc_basic_image_cache_class = |
michael@0 | 82 | + FTC_GCacheClassRec ftc_basic_image_cache_class = |
michael@0 | 83 | { |
michael@0 | 84 | { |
michael@0 | 85 | ftc_inode_new, |
michael@0 | 86 | |
michael@0 | 87 | |
michael@0 | 88 | ---------------------------------------------------------------------- |
michael@0 | 89 | |
michael@0 | 90 | --- end of PROBLEMS --- |