reactos/dll/3rdparty/freetype/docs/INSTALL.ANY

   1 Instructions on how to build FreeType with your own build tool
   2 ==============================================================
   3
   4 See the file "CUSTOMIZE" to  learn how to customize FreeType to specific
   5 environments.
   6
   7
   8 I. Standard procedure
   9 ---------------------
  10
  11   * DISABLE  PRE-COMPILED HEADERS!   This is  very important  for Visual
  12     C++, because FreeType uses lines like:
  13
  14       #include FT_FREETYPE_H
  15
  16     which are not correctly supported by this compiler while being ISO C
  17     compliant!
  18
  19   * You need to add  the directories "freetype2/include" to your include
  20     path when compiling the library.
  21
  22   * FreeType 2 is made of several components; each of them is located in
  23     a     subdirectory     of     "freetype2/src".      For     example,
  24     'freetype2/src/truetype/' contains the TrueType font driver.
  25
  26   * DO NOT COMPILE ALL C FILES!  Rather, compile the following ones:
  27
  28     -- base components (required)
  29
  30       src/base/ftsystem.c
  31       src/base/ftinit.c
  32       src/base/ftdebug.c
  33       src/base/ftbase.c
  34       src/base/ftglyph.c
  35       src/base/ftbbox.c
  36       src/base/ftmm.c
  37       src/base/ftpfr.c        -- optional, see <freetype/ftpfr.h>
  38       src/base/ftbdf.c        -- optional, see <freetype/ftbdf.h>
  39       src/base/ftwinfnt.c     -- optional, see <freetype/ftwinfnt.h>
  40
  41       src/base/ftmac.c        -- only on the Macintosh
  42
  43     -- other components (optional)
  44
  45       src/autofit/autofit.c   -- auto hinting module
  46       src/cache/ftcache.c     -- cache sub-system (in beta)
  47       src/sfnt/sfnt.c         -- SFNT files support
  48                                  (TrueType & OpenType)
  49       src/cff/cff.c           -- CFF/OpenType font driver
  50       src/pfr/pfr.c           -- PFR/TrueDoc font driver
  51       src/bdf/bdf.c           -- BDF font driver
  52       src/pcf/pcf.c           -- PCF font driver
  53       src/psnames/psnames.c   -- PostScript glyph names support
  54       src/psaux/psaux.c       -- PostScript Type 1 parsing
  55       src/truetype/truetype.c -- TrueType font driver
  56       src/type1/type1.c       -- Type 1 font driver
  57       src/cid/type1cid.c      -- Type 1 CID-keyed font driver
  58       src/winfonts/winfonts.c -- Windows FONT / FNT font driver
  59       src/raster1/raster1.c   -- monochrome rasterizer
  60       src/smooth/smooth.c     -- anti-aliasing rasterizer
  61
  62     Notes:
  63
  64       `truetype.c' needs `sfnt.c' and `psnames.c'
  65       `type1.c'    needs `psaux.c' and `psnames.c'
  66       `type1cid.c' needs `psaux.c' and `psnames.c'
  67       `cff.c'      needs `sfnt.c', `psaux.c', and `psnames.c'
  68
  69
  70   You are done.   In case of problems, see the  archives of the FreeType
  71   development mailing list.
  72
  73
  74 II. Support for flat-directory compilation
  75 ------------------------------------------
  76
  77   It  is possible  to put  all  FreeType 2  source files  into a  single
  78   directory, with the *exception* of the `include' hierarchy.
  79
  80   1. Copy all files in current directory
  81
  82       cp freetype2/src/base/*.[hc] .
  83       cp freetype2/src/raster1/*.[hc] .
  84       cp freetype2/src/smooth/*.[hc] .
  85       etc.
  86
  87   2. Compile sources
  88
  89       cc -c -Ifreetype2/include ftsystem.c
  90       cc -c -Ifreetype2/include ftinit.c
  91       cc -c -Ifreetype2/include ftdebug.c
  92       cc -c -Ifreetype2/include ftbase.c
  93       etc.
  94
  95     You don't need to define  the FT_FLAT_COMPILATION macro (as this was
  96     required in previous releases of FreeType 2).
  97
  98 ------------------------------------------------------------------------
  99
 100 Copyright 2003, 2005 by
 101 David Turner, Robert Wilhelm, and Werner Lemberg.
 102
 103 This  file  is  part  of the  FreeType  project, and may  only be  used,
 104 modified,  and  distributed  under  the  terms of  the FreeType  project
 105 license, LICENSE.TXT.   By continuing to use, modify, or distribute this
 106 file you  indicate that  you have  read the  license and understand  and
 107 accept it fully.
 108
 109
 110 --- end of INSTALL.ANY ---