2000-07-26 21:13:51 +02:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
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:
|
2000-10-31 21:42:18 +01:00
|
|
|
|
2002-01-09 22:01:18 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
I. Normal installation and upgrades
|
|
|
|
===================================
|
|
|
|
|
|
|
|
1. Native TrueType Hinting
|
|
|
|
|
|
|
|
Native TrueType hinting is disabled by default[1]. If you really
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
need it, read the file `TRUETYPE' for information.
|
|
|
|
|
2002-01-09 22:01:18 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
2. Unix Systems (as well as Cygwin or MSys on Windows)
|
2002-01-09 22:01:18 +01:00
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
Please read *both* `UPGRADE.UNX' and `INSTALL.UNX' to install or
|
|
|
|
upgrade FreeType 2 on a Unix system. Note that you *need* GNU Make,
|
2003-04-21 15:30:27 +02:00
|
|
|
since other make tools won't work (this includes BSD Make).
|
2002-01-09 22:01:18 +01:00
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
|
|
|
|
3. On VMS with the `mms' build tool
|
2003-03-20 08:04:40 +01:00
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
See `INSTALL.VMS' for installation instructions on this platform.
|
|
|
|
|
2002-01-09 22:01:18 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
4. Other systems using GNU Make
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
On non-Unix platforms, it is possible to build the library using GNU
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
Make utility. Note that *NO OTHER MAKE TOOL WILL WORK*[2]! This
|
2003-04-21 15:30:27 +02:00
|
|
|
methods supports several compilers on Windows, OS/2, and BeOS,
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
including MinGW, Visual C++, Borland C++, and more.
|
|
|
|
|
|
|
|
Instructions are provided in the file `INSTALL.GNU'.
|
2002-01-08 19:33:55 +01:00
|
|
|
|
2000-12-14 23:57:17 +01:00
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
5. With an IDE Project File (e.g., for Visual Studio or CodeWarrior)
|
2003-03-20 08:04:40 +01:00
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
We provide a small number of `project files' for various IDEs to
|
2003-04-21 15:30:27 +02:00
|
|
|
automatically build the library as well. Note that these files are
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
not supported and only sporadically maintained by FreeType
|
|
|
|
developers, so don't expect them to work in each release.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
To find them, have a look at the content of the `builds/<system>'
|
2003-03-20 08:04:40 +01:00
|
|
|
directory, where <system> stands for your OS or environment.
|
2001-12-11 14:14:41 +01:00
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
6. From you own IDE, or own Makefiles
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
If you want to create your own project file, follow the instructions
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
given in the `INSTALL.ANY' document of this directory.
|
2001-12-11 14:14:41 +01:00
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
II. Custom builds of the library
|
|
|
|
================================
|
2001-12-11 14:14:41 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
Customizing the compilation of FreeType is easy, and allows you to
|
|
|
|
select only the components of the font engine that you really need.
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
For more details read the file `CUSTOMIZE'.
|
2001-12-11 14:14:41 +01:00
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
------------------------------------------------------------------------
|
2001-12-11 14:14:41 +01:00
|
|
|
|
2003-03-20 08:04:40 +01:00
|
|
|
[1] More details on: http://www.freetype.org/patents.html
|
2001-12-11 14:14:41 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
[2] make++, a make tool written in Perl, has sufficient support of GNU
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
make extensions to build FreeType. See
|
|
|
|
|
|
|
|
http://makepp.sourceforge.net
|
|
|
|
|
|
|
|
for more information; you need version 1.19 or newer, and you must
|
|
|
|
pass option `--norc-substitution'.
|
2001-05-29 12:52:34 +02:00
|
|
|
|
2005-06-05 01:00:25 +02:00
|
|
|
------------------------------------------------------------------------
|
|
|
|
|
|
|
|
Copyright 2000, 2001, 2002, 2003, 2004, 2005 by
|
|
|
|
David Turner, Robert Wilhelm, and Werner Lemberg.
|
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
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
|
2005-06-05 01:00:25 +02:00
|
|
|
accept it fully.
|
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
--- end of INSTALL ---
|