1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/modules/freetype2/docs/INSTALL.ANY Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,156 @@
1.4 +Instructions on how to build FreeType with your own build tool
1.5 +==============================================================
1.6 +
1.7 +See the file `CUSTOMIZE' to learn how to customize FreeType to
1.8 +specific environments.
1.9 +
1.10 +
1.11 +I. Standard procedure
1.12 +---------------------
1.13 +
1.14 + * DISABLE PRE-COMPILED HEADERS! This is very important for Visual
1.15 + C++, because FreeType uses lines like:
1.16 +
1.17 + #include FT_FREETYPE_H
1.18 +
1.19 + which are not correctly supported by this compiler while being ISO
1.20 + C compliant!
1.21 +
1.22 + * You need to add the directories `freetype2/include' to your
1.23 + include path when compiling the library.
1.24 +
1.25 + * FreeType 2 is made of several components; each of them is located
1.26 + in a subdirectory of `freetype2/src'. For example,
1.27 + `freetype2/src/truetype/' contains the TrueType font driver.
1.28 +
1.29 + * DO NOT COMPILE ALL C FILES! Rather, compile the following ones.
1.30 +
1.31 + -- base components (required)
1.32 +
1.33 + src/base/ftsystem.c
1.34 + src/base/ftinit.c
1.35 + src/base/ftdebug.c
1.36 +
1.37 + src/base/ftbase.c
1.38 +
1.39 + src/base/ftbbox.c -- recommended, see <ftbbox.h>
1.40 + src/base/ftglyph.c -- recommended, see <ftglyph.h>
1.41 +
1.42 + src/base/ftbdf.c -- optional, see <ftbdf.h>
1.43 + src/base/ftbitmap.c -- optional, see <ftbitmap.h>
1.44 + src/base/ftcid.c -- optional, see <ftcid.h>
1.45 + src/base/ftfstype.c -- optional
1.46 + src/base/ftgasp.c -- optional, see <ftgasp.h>
1.47 + src/base/ftgxval.c -- optional, see <ftgxval.h>
1.48 + src/base/ftlcdfil.c -- optional, see <ftlcdfil.h>
1.49 + src/base/ftmm.c -- optional, see <ftmm.h>
1.50 + src/base/ftotval.c -- optional, see <ftotval.h>
1.51 + src/base/ftpatent.c -- optional
1.52 + src/base/ftpfr.c -- optional, see <ftpfr.h>
1.53 + src/base/ftstroke.c -- optional, see <ftstroke.h>
1.54 + src/base/ftsynth.c -- optional, see <ftsynth.h>
1.55 + src/base/fttype1.c -- optional, see <t1tables.h>
1.56 + src/base/ftwinfnt.c -- optional, see <ftwinfnt.h>
1.57 + src/base/ftxf86.c -- optional, see <ftxf86.h>
1.58 +
1.59 + src/base/ftmac.c -- only on the Macintosh
1.60 +
1.61 + -- font drivers (optional; at least one is needed)
1.62 +
1.63 + src/bdf/bdf.c -- BDF font driver
1.64 + src/cff/cff.c -- CFF/OpenType font driver
1.65 + src/cid/type1cid.c -- Type 1 CID-keyed font driver
1.66 + src/pcf/pcf.c -- PCF font driver
1.67 + src/pfr/pfr.c -- PFR/TrueDoc font driver
1.68 + src/sfnt/sfnt.c -- SFNT files support
1.69 + (TrueType & OpenType)
1.70 + src/truetype/truetype.c -- TrueType font driver
1.71 + src/type1/type1.c -- Type 1 font driver
1.72 + src/type42/type42.c -- Type 42 font driver
1.73 + src/winfonts/winfnt.c -- Windows FONT / FNT font driver
1.74 +
1.75 + -- rasterizers (optional; at least one is needed for vector
1.76 + formats)
1.77 +
1.78 + src/raster/raster.c -- monochrome rasterizer
1.79 + src/smooth/smooth.c -- anti-aliasing rasterizer
1.80 +
1.81 + -- auxiliary modules (optional)
1.82 +
1.83 + src/autofit/autofit.c -- auto hinting module
1.84 + src/cache/ftcache.c -- cache sub-system (in beta)
1.85 + src/gzip/ftgzip.c -- support for compressed fonts (.gz)
1.86 + src/lzw/ftlzw.c -- support for compressed fonts (.Z)
1.87 + src/bzip2/ftbzip2.c -- support for compressed fonts (.bz2)
1.88 + src/gxvalid/gxvalid.c -- TrueTypeGX/AAT table validation
1.89 + src/otvalid/otvalid.c -- OpenType table validation
1.90 + src/psaux/psaux.c -- PostScript Type 1 parsing
1.91 + src/pshinter/pshinter.c -- PS hinting module
1.92 + src/psnames/psnames.c -- PostScript glyph names support
1.93 +
1.94 +
1.95 + Notes:
1.96 +
1.97 + `ftcache.c' needs `ftglyph.c'
1.98 + `ftfstype.c' needs `fttype1.c'
1.99 + `ftglyph.c' needs `ftbitmap.c'
1.100 + `ftstroke.c' needs `ftglyph.c'
1.101 + `ftsynth.c' needs `ftbitmap.c'
1.102 +
1.103 + `cff.c' needs `sfnt.c', `pshinter.c', and `psnames.c'
1.104 + `truetype.c' needs `sfnt.c' and `psnames.c'
1.105 + `type1.c' needs `psaux.c' `pshinter.c', and `psnames.c'
1.106 + `type1cid.c' needs `psaux.c', `pshinter.c', and `psnames.c'
1.107 + `type42.c' needs `truetype.c'
1.108 +
1.109 + To use `ftbzip2.c', an application must be linked with a library
1.110 + which implements bzip2 support (and the bzip2 header files must
1.111 + be available also during compilation).
1.112 +
1.113 +
1.114 + Read the file `CUSTOMIZE' in case you want to compile only a subset
1.115 + of the drivers, renderers, and optional modules; a detailed
1.116 + description of the various base extension is given in the top-level
1.117 + file `modules.cfg'.
1.118 +
1.119 + You are done. In case of problems, see the archives of the FreeType
1.120 + development mailing list.
1.121 +
1.122 +
1.123 +II. Support for flat-directory compilation
1.124 +------------------------------------------
1.125 +
1.126 + It is possible to put all FreeType 2 source files into a single
1.127 + directory, with the *exception* of the `include' hierarchy.
1.128 +
1.129 + 1. Copy all files in current directory
1.130 +
1.131 + cp freetype2/src/base/*.[hc] .
1.132 + cp freetype2/src/raster1/*.[hc] .
1.133 + cp freetype2/src/smooth/*.[hc] .
1.134 + etc.
1.135 +
1.136 + 2. Compile sources
1.137 +
1.138 + cc -c -Ifreetype2/include -DFT2_BUILD_LIBRARY ftsystem.c
1.139 + cc -c -Ifreetype2/include -DFT2_BUILD_LIBRARY ftinit.c
1.140 + cc -c -Ifreetype2/include -DFT2_BUILD_LIBRARY ftdebug.c
1.141 + cc -c -Ifreetype2/include -DFT2_BUILD_LIBRARY ftbase.c
1.142 + etc.
1.143 +
1.144 + You don't need to define the FT_FLAT_COMPILATION macro (as this
1.145 + was required in previous releases of FreeType 2).
1.146 +
1.147 +----------------------------------------------------------------------
1.148 +
1.149 +Copyright 2003, 2005, 2006, 2009, 2010, 2013 by
1.150 +David Turner, Robert Wilhelm, and Werner Lemberg.
1.151 +
1.152 +This file is part of the FreeType project, and may only be used,
1.153 +modified, and distributed under the terms of the FreeType project
1.154 +license, LICENSE.TXT. By continuing to use, modify, or distribute
1.155 +this file you indicate that you have read the license and understand
1.156 +and accept it fully.
1.157 +
1.158 +
1.159 +--- end of INSTALL.ANY ---
