114 lines
3.8 KiB
Plaintext
114 lines
3.8 KiB
Plaintext
|
|
There are several ways to build the FreeType library, depending on
|
|
your system and the level of customization you need. Here is a short
|
|
overview of the documentation available:
|
|
|
|
|
|
I. Prerequisites and dependencies
|
|
=================================
|
|
|
|
FreeType is a low level C library that only depends on the standard
|
|
C library with very few platform-dependent optimizations utilized at
|
|
build time. System libraries, such as zlib, Gzip, bzip2, Brotli,
|
|
and libpng, might be used to handle compressed fonts or decode
|
|
embedded PNG glyphs.
|
|
|
|
FreeType auto-configuration scripts should be able to detect the
|
|
prerequisites if the necessary headers are available at the default
|
|
locations. Otherwise, modify `include/freetype/config/ftoption.h'
|
|
to control how the FreeType library gets built. Normally, you don't
|
|
need to change anything.
|
|
|
|
Applications have very limited control over FreeType's behaviour at
|
|
run-time; look at the documentation of function `FT_Property_Set'.
|
|
|
|
|
|
II. Normal installation and upgrades
|
|
====================================
|
|
|
|
1. Unix and Unix-like systems
|
|
|
|
This also includes MacOS, Cygwin, MinGW + MSYS, Mingw-w64 + MSYS2,
|
|
and possibly other, similar environments.
|
|
|
|
Please read `INSTALL.UNIX' to install or upgrade FreeType 2 on a
|
|
Unix system. Note that you *need* GNU Make for automatic
|
|
compilation, since other make tools won't work (this includes BSD
|
|
Make).
|
|
|
|
GNU Make VERSION 3.81 OR NEWER IS NEEDED!
|
|
|
|
[For `cmake' see below.]
|
|
|
|
|
|
2. On VMS with the `mms' build tool
|
|
|
|
See `INSTALL.VMS' for installation instructions on this platform.
|
|
|
|
|
|
3. Other systems using GNU Make
|
|
|
|
On some non-Unix platforms, it is possible to build the library
|
|
using only the GNU Make utility. Note that *NO OTHER MAKE TOOL
|
|
WILL WORK*[1]! This methods supports several compilers on
|
|
Windows, OS/2, and BeOS, including MinGW* (without MSYS*), Visual
|
|
C++, Borland C++, and more.
|
|
|
|
Instructions are provided in the file `INSTALL.GNU'.
|
|
|
|
|
|
4. With an IDE Project File (e.g., for Visual Studio or CodeWarrior)
|
|
|
|
We provide a small number of `project files' for various IDEs to
|
|
automatically build the library as well. Note that these files
|
|
are not supported and only sporadically maintained by FreeType
|
|
developers, so don't expect them to work in each release.
|
|
|
|
To find them, have a look at the content of the `builds/<system>'
|
|
directory, where <system> stands for your OS or environment.
|
|
|
|
|
|
5. Using cmake
|
|
|
|
See the top-level `CMakeLists.txt' file for more information.
|
|
|
|
|
|
6. From you own IDE, or own Makefiles
|
|
|
|
If you want to create your own project file, follow the
|
|
instructions given in the `INSTALL.ANY' document of this
|
|
directory.
|
|
|
|
|
|
III. Custom builds of the library
|
|
=================================
|
|
|
|
Customizing the compilation of FreeType is easy, and allows you to
|
|
select only the components of the font engine that you really need.
|
|
For more details read the file `CUSTOMIZE'.
|
|
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
[1] make++, a make tool written in Perl, has sufficient support of GNU
|
|
make extensions to build FreeType. See
|
|
|
|
https://makepp.sourceforge.net
|
|
|
|
for more information; you need version 2.0 or newer, and you must
|
|
pass option `--norc-substitution'.
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
Copyright (C) 2000-2021 by
|
|
David Turner, Robert Wilhelm, and Werner Lemberg.
|
|
|
|
This file is part of the FreeType project, and may only be used,
|
|
modified, and distributed under the terms of the FreeType project
|
|
license, LICENSE.TXT. By continuing to use, modify, or distribute
|
|
this file you indicate that you have read the license and understand
|
|
and accept it fully.
|
|
|
|
|
|
--- end of INSTALL ---
|