contrib/OWB: add correct SDL dependency, fix compilers used
[AROS-Contrib.git] / freetype1 / contrib / ftos2 / readme.1st
blobea5f403d4d744c96fa8108cac1b8217050b64770
1 This is the source code from the FreeType/2 OS/2 font driver.
2 Copyright (C) 1997-1998 Michal Necasek (mike@mendelu.cz).
4 Here's a description of the files in this package :
6   readme.1st     This file
8   readme.txt     The FreeType/2 Readme
10   FAQ            The FreeType/2 user faq
12   DEVELFAQ       The FreeType/2 developer faq. Read it before trying to
13                  compile this program
15   install.cmd    The FreeType/2 installation script
16   uninstall.cmd  The FreeType/2 uninstallation script
17   query.cmd      A script used to query the name of the current font driver
19   limit.cmd      The driver controls the number of font files it keeps
20                  opened at the same time, in order to save system resources
21                  and memory (of course, this _doesn't_ limit the number of
22                  opened fonts in PM, it just saves a _lot_ of memory when
23                  many fonts are installed on your system).
25                  This script let you change this limit. It can be useful
26                  if you use font-intensive applications (like DTP) and
27                  want better performance (to the sake of memory).
29   update.cmd     The FreeType/2 update script
30   ifi/           Source code of the FreeType/2 font driver proper
33   lib/           files that must be added to the standard FreeType 1.1
34                  release. They take the place of the files located in
35                  the corresponding "lib" file.
37       lib/ttmemory.c         replacement for the FreeType memory
38                              manager component. This one uses the GRE
39                              shared memory segment allocater, and is
40                              required.
42       lib/arch/makefile.icc  Makefile to compile the FreeType library for
43                              FreeType/2 with Visual Age. You'll need nmake.
45       lib/arch/makefile.wat  Makefile to compile with Watcom. NOTE that
46                              you'll ALSO need nmake (wmake won't work !!)
49 Here's how to compile the font driver.
51 0. Read the DEVELFAQ ! Now ! Then make a WPS backup !
53 1. Get the FreeType library, and copy the "lib" hierarchy into it to
54    replace the related files (i.e. ttmemory.c and makefiles).
56 2. Compile FreeType with the new files, simply go to "freetype/lib"
57    and type :
59      nmake -f arch\os2\makefile.icc          for VisualAge
60      nmake -f arch\os2\makefile.wat          for Watcom
62 3. Adjust the makefiles in "ifi" to reflect the location of the
63    library file "libttf.lib" that was generated previously.
65 5. Compile the font driver. Go to the "ft_os2/ifi" directory, then type
67      nmake -f freetype.icc       for VisualAge
68      nmake -f freetype.wat       for Watcom
70    You should have created a file called "FreeType.dll". Copy it to
71    your "ft_os2" directory..
73 6. Run the "install.cmd" script, then reboot after closing all
74    applications.
76 7. When your desktop is back, go to the font palette and try to
77    install some new TrueType fonts. Enjoy the difference :-)
79 8. You can also compile a small memory usage dumper called "ftmem.c"
80    to know how much memory the driver is using. Simply do
82      nmake -f ftmem.icc       for VisualAge
83      nmake -f ftmem.wat       for Watcom
85    Then launch it. A small window will appear with the current amount
86    of memory allocated by the driver.