modules/freetype2/docs/PROBLEMS

Thu, 22 Jan 2015 13:21:57 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Thu, 22 Jan 2015 13:21:57 +0100
branch
TOR_BUG_9701
changeset 15
b8a032363ba2
permissions
-rw-r--r--

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

mercurial