Home | History | Annotate | only in /external/freetype/builds/amiga
Up to higher level directory
NameDateSize
include/21-Aug-2018
makefile21-Aug-20187.3K
makefile.os421-Aug-20188.1K
README21-Aug-20184.6K
smakefile21-Aug-20187.4K
src/21-Aug-2018

README

      1 
      2 README for the builds/amiga subdirectory.
      3 
      4 Copyright 2005-2018 by
      5 Werner Lemberg and Detlef Wrkner.
      6 
      7 This file is part of the FreeType project, and may only be used, modified,
      8 and distributed under the terms of the FreeType project license,
      9 LICENSE.TXT.  By continuing to use, modify, or distribute this file you
     10 indicate that you have read the license and understand and accept it
     11 fully.
     12 
     13 
     14 The makefile.os4 is for the AmigaOS4 SDK.  To use it, type
     15 "make -f makefile.os4", it produces a link library libft2_ppc.a.
     16 
     17 The makefile is for ppc-morphos-gcc-2.95.3-bin.tgz (gcc 2.95.3 hosted on
     18 68k-Amiga producing MorphOS-PPC-binaries from http://www.morphos.de).
     19 To use it, type "make assign", then "make"; it produces a link library
     20 libft2_ppc.a.
     21 
     22 The smakefile is a makefile for Amiga SAS/C 6.58 (no longer available,
     23 latest sold version was 6.50, updates can be found in Aminet).  It is
     24 based on the version found in the sourcecode of ttf.library 0.83b for
     25 FreeType 1.3.1 from Richard Griffith (ragriffi (a] sprynet.com,
     26 http://ragriffi.home.sprynet.com).
     27 
     28 You will also need the latest include files and amiga.lib from the
     29 Amiga web site (http://www.amiga.com/3.9/download/NDK3.9.lha) for
     30 AmigaOS 3.9; the generated code should work under AmigaOS 2.04 and up.
     31 
     32 To use it, call "smake assign" and then "smake" from the builds/amiga
     33 directory.  The results are:
     34 
     35 - A link library "ft2_680x0.lib" (where x depends on the setting of
     36   the CPU entry in the smakefile) containing all FreeType2 parts
     37   except of the init code, debugging code, and the system interface
     38   code.
     39 
     40 - ftsystem.o, an object module containing the standard version of the
     41   system interface code which uses fopen() fclose() fread() fseek()
     42   ftell() malloc() realloc() and free() from lib:sc.lib (not pure).
     43 
     44 - ftsystempure.o, an object module containing the pure version of the
     45   system interface code which uses Open() Close() Read() Seek()
     46   ExamineFH() AsmAllocPooled() AsmFreePooled() etc.  This version can
     47   be used in both normal programs and in Amiga run-time shared system
     48   librarys (can be linked with lib:libinit.o, no copying of DATA and
     49   BSS hunks for each OpenLibrary() necessary).  Source code is in
     50   src/base/ftsystem.c.
     51 
     52 - ftdebug.o, an object module containing the standard version of the
     53   debugging code which uses vprintf() and exit() (not pure).
     54   Debugging can be turned on in FT:include/freetype/config/ftoption.h
     55   and with FT_SetTraceLevel().
     56 
     57 - ftdebugpure.o, an object module containing the pure version of the
     58   debugging code which uses KVPrintf() from lib:debug.lib and no
     59   exit().  For debugging of Amiga run-time shared system libraries.
     60   Source code is in src/base/ftdebug.c.
     61 
     62 - NO ftinit.o.  Because linking with a link library should result in
     63   linking only the needed object modules in it, but standard
     64   ftsystem.o would force ALL FreeType2 modules to be linked to your
     65   program, I decided to use a different scheme: You must #include
     66   FT:src/base/ftinit.c in your sourcecode and specify with #define
     67   statements which modules you need.  See
     68   include/freetype/config/ftmodule.h.
     69 
     70 
     71 To use in your own programs:
     72 
     73 - Insert the #define and #include statements from top of
     74   include/freetype/config/ftmodule.h in your source code and
     75   uncomment the #define statements for the FreeType2 modules you need.
     76 
     77 - You can use either PARAMETERS=REGISTER or PARAMETERS=STACK for
     78   calling the FreeType2 functions, because the link library and the
     79   object files are compiled with PARAMETERS=BOTH.
     80 
     81 - "smake assign" (assign "FT:" to the FreeType2 main directory).
     82 
     83 - Compile your program.
     84 
     85 - Link with either ftsystem.o or ftsystempure.o, if debugging enabled
     86   with either ftdebug.o or (ftdebugpure.o and lib:debug.lib), and with
     87   ft2_680x0.lib as link library.
     88 
     89 
     90 To adapt to other compilers:
     91 
     92 - The standard ANSI C maximum length of 31 significant characters in
     93   identifiers is not enough for FreeType2.  Check if your compiler has
     94   a minimum length of 40 significant characters or can be switched to
     95   it.  "idlen=40" is the option for SAS/C.  Setting #define
     96   HAVE_LIMIT_ON_IDENTS in an include file may also work (not tested).
     97 
     98 - Make sure that the include directory in builds/amiga is searched
     99   before the normal FreeType2 include directory, so you are able to
    100   replace problematic include files with your own version (same may be
    101   useful for the src directory).
    102 
    103 - An example of how to replace/workaround a problematic include file
    104   is include/freetype/config/ftconfig.h; it changes a #define that
    105   would prevent SAS/C from generating XDEF's where it should do that and
    106   then includes the standard FreeType2 include file.
    107 
    108 Local Variables:
    109 coding: latin-1
    110 End:
    111