misc/libfreetype/docs/PROBLEMS
author koda
Fri, 06 Jan 2012 01:51:04 +0100
changeset 6551 a2f39cb9af62
parent 5172 88f2e05288ba
permissions -rw-r--r--
fix a couple of loose ends: sdl_mixer is informed of that OGG is provided by Tremor with its own macro, there is no more a segfault on Tremor cleanup, added new event type and timestamp entry for SDL, removed spurious characters from the japanese translation, uSound errors now are output with SDLTry, uSound doesn't need sound preloading any more
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 ---