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