"SfR Fresh" - the SfR Freeware/Shareware Archive

Member "freetype-2.3.7/docs/INSTALL.ANY" of archive freetype-2.3.7.tar.gz:


As a special service "SfR Fresh" has tried to format the requested source page into HTML format using source code syntax highlighting with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.
    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
    5 specific 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
   17     C compliant!
   18 
   19   * You  need  to  add  the directories  `freetype2/include'  to  your
   20     include path when compiling the library.
   21 
   22   * FreeType 2 is made of  several components; each of them is located
   23     in    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 
   34       src/base/ftbase.c
   35 
   36       src/base/ftbbox.c       -- recommended, see <freetype/ftbbox.h>
   37       src/base/ftglyph.c      -- recommended, see <freetype/ftglyph.h>
   38 
   39       src/base/ftbdf.c        -- optional, see <freetype/ftbdf.h>
   40       src/base/ftbitmap.c     -- optional, see <freetype/ftbitmap.h>
   41       src/base/ftgxval.c      -- optional, see <freetype/ftgxval.h>
   42       src/base/ftmm.c         -- optional, see <freetype/ftmm.h>
   43       src/base/ftotval.c      -- optional, see <freetype/ftotval.h>
   44       src/base/ftpfr.c        -- optional, see <freetype/ftpfr.h>
   45       src/base/ftstroke.c     -- optional, see <freetype/ftstroke.h>
   46       src/base/ftsynth.c      -- optional, see <freetype/ftsynth.h>
   47       src/base/fttype1.c      -- optional, see <freetype/t1tables.h>
   48       src/base/ftwinfnt.c     -- optional, see <freetype/ftwinfnt.h>
   49 
   50       src/base/ftmac.c        -- only on the Macintosh
   51 
   52     -- font drivers (optional; at least one is needed)
   53 
   54       src/bdf/bdf.c           -- BDF font driver
   55       src/cff/cff.c           -- CFF/OpenType font driver
   56       src/cid/type1cid.c      -- Type 1 CID-keyed font driver
   57       src/pcf/pcf.c           -- PCF font driver
   58       src/pfr/pfr.c           -- PFR/TrueDoc font driver
   59       src/sfnt/sfnt.c         -- SFNT files support
   60                                  (TrueType & OpenType)
   61       src/truetype/truetype.c -- TrueType font driver
   62       src/type1/type1.c       -- Type 1 font driver
   63       src/type42/type42.c     -- Type 42 font driver
   64       src/winfonts/winfnt.c   -- Windows FONT / FNT font driver
   65 
   66     -- rasterizers (optional; at least one is needed for
   67        vector formats)
   68 
   69       src/raster/raster.c     -- monochrome rasterizer
   70       src/smooth/smooth.c     -- anti-aliasing rasterizer
   71 
   72     -- auxiliary modules (optional)
   73 
   74       src/autofit/autofit.c   -- auto hinting module
   75       src/cache/ftcache.c     -- cache sub-system (in beta)
   76       src/gzip/ftgzip.c       -- support for compressed fonts (.gz)
   77       src/lzw/ftlzw.c         -- support for compressed fonts (.Z)
   78       src/gxvalid/gxvalid.c   -- TrueTypeGX/AAT table validation
   79       src/otvalid/otvalid.c   -- OpenType table validation
   80       src/psaux/psaux.c       -- PostScript Type 1 parsing
   81       src/pshinter/pshinter.c -- PS hinting module
   82       src/psnames/psnames.c   -- PostScript glyph names support
   83 
   84 
   85     Notes:
   86 
   87       `cff.c'      needs `sfnt.c', `pshinter.c', and `psnames.c'
   88       `truetype.c' needs `sfnt.c' and `psnames.c'
   89       `type1.c'    needs `psaux.c' `pshinter.c', and `psnames.c'
   90       `type1cid.c' needs `psaux.c', `pshinter.c', and `psnames.c'
   91       `type42.c'   needs `truetype.c'
   92 
   93 
   94   Read the file `CUSTOMIZE' in case  you want to compile only a subset
   95   of  the  drivers,  renderers,   and  optional  modules;  a  detailed
   96   description of the various base  extension is given in the top-level
   97   file `modules.cfg'.
   98 
   99   You are done.  In case of problems, see the archives of the FreeType
  100   development mailing list.
  101 
  102 
  103 II. Support for flat-directory compilation
  104 ------------------------------------------
  105 
  106   It is  possible to  put all  FreeType 2 source  files into  a single
  107   directory, with the *exception* of the `include' hierarchy.
  108 
  109   1. Copy all files in current directory
  110 
  111       cp freetype2/src/base/*.[hc] .
  112       cp freetype2/src/raster1/*.[hc] .
  113       cp freetype2/src/smooth/*.[hc] .
  114       etc.
  115 
  116   2. Compile sources
  117 
  118       cc -c -Ifreetype2/include ftsystem.c
  119       cc -c -Ifreetype2/include ftinit.c
  120       cc -c -Ifreetype2/include ftdebug.c
  121       cc -c -Ifreetype2/include ftbase.c
  122       etc.
  123 
  124     You don't  need to define  the FT_FLAT_COMPILATION macro  (as this
  125     was required in previous releases of FreeType 2).
  126 
  127 ----------------------------------------------------------------------
  128 
  129 Copyright 2003, 2005, 2006 by
  130 David Turner, Robert Wilhelm, and Werner Lemberg.
  131 
  132 This  file is  part of  the FreeType  project, and  may only  be used,
  133 modified,  and distributed  under the  terms of  the  FreeType project
  134 license,  LICENSE.TXT.  By  continuing to  use, modify,  or distribute
  135 this file you  indicate that you have read  the license and understand
  136 and accept it fully.
  137 
  138 
  139 --- end of INSTALL.ANY ---