Short:        FreeType 2.15.0 library + font engine
Author:       Serkan Dursun
Uploader:     Serkan Dursun <blasterreal gmail com>
Type:         util/libs
Version:      2.15
Requires:     68020+, AmigaOS 3.0+
Architecture: m68k-amigaos >= 3.0.0
Distribution: Aminet

freetype2.library 2.15 is the library of AAText (util/wb/AAText):
FreeType 2.15.0 (2026) as an AmigaOS 3 shared library, and an outline
font engine for diskfont.library. It replaces freetype2.library 1.x
(FreeType 2.1, 2002, installed with FTManager). Versions 1.0-1.2 were
called aatext.library.

- FreeType API: the full FreeType 2.15.0 API for programs (165 functions),
  with the same function order as freetype2.library 1.3, so programs
  written for 1.x run unchanged.
- diskfont engine: fonts whose .otag file names OT_Engine "freetype2",
  so fonts installed with FTManager for 1.x use it unchanged. Fonts
  installed with AATextManager before 2.15 name the engine "aatext":
  AATextManager's Repair tab changes them (until then keep
  LIBS:aatext.library).

What the engine does better than freetype2.library 1.3
- FreeType 2.15.0: TrueType, OpenType/CFF (.otf), CFF2 and variable
  fonts, WOFF, Type 1 (.pfb/.pfa), CID, Type 42, PFR, Windows FNT, PCF
  and BDF bitmap fonts (also gzip or LZW compressed).
- 1-bit glyphs hinted for monochrome output (the font's own TrueType
  instructions), not antialiasing hints thresholded to black and white.
  Letters like W, a, e no longer break apart at small sizes.
- 8-bit antialiased glyph maps (OT_GlyphMap8Bit of the AmigaOS 3.2 NDK).
- Symbol fonts (Symbol and other MS symbol encoded fonts) find their
  glyphs.
- Kerning from the GPOS table (as HarfBuzz applies the 'kern' feature),
  so newer fonts without a 'kern' table are kerned too.
- OT_EmboldenX/Y (algorithmic bold), OT_SetFactor (width), 32-bit glyph
  codes (OT_GlyphCode_32, OT_WidthList32), OT_NumGlyphs.
- OT_Spec9_Hinter: default, autohinter, none, and new "light".
- Glyph maps and width lists agree (1.3 measured widths and drew glyphs
  with different hinting).
- FreeType runs on its own 48 KB stack when the caller has less than
  32 KB left: no crashes in programs with small stacks.
- FREETYPE_PROPERTIES environment variable for FreeType driver settings,
  e.g. SetEnv FREETYPE_PROPERTIES "cff:no-stem-darkening=0".
- Colour emoji for programs: COLR fonts (e.g. Twemoji Mozilla) render
  in colour with FT_LOAD_COLOR. Tools/ft2color shows them in a window.

Installation
  Copy LIBS:freetype2.library LIBS:freetype2.library.bak
  Copy Libs/freetype2.library LIBS:
(Libs/freetype2.library.060 is the 68060 build, copy it as
LIBS:freetype2.library; the .debug build prints to the serial port.)
To go back to 1.x, copy the .bak file back.

Code page: characters are mapped to Unicode with the code page in the
.otag file, or ENV:ftcodepage (256 big-endian words, as for
freetype2.library 1.x), or ISO-8859-1.

For programmers
Developer/ has the headers (proto, inline, clib, fd, libraries and the
FreeType 2.15.0 headers), freetype2_SDK.txt (API rules, colour glyphs,
building) and Examples/ with the source of the tools. With gcc:

  #include <proto/aatext.h>
  struct Library *AATextBase;
  ...
  AATextBase = OpenLibrary("freetype2.library", 2);
  FT_Init_FreeType(&library);   /* and so on: the normal FreeType API */

  m68k-amigaos-gcc -m68020 -O2 -noixemul -Iinclude \
      -o ft2color Examples/ft2color.c

FreeType functions take their arguments on the stack (C order), not in
registers; the inline header does this for you. Each task should use its
own FT_Library.

Tools
  ft2color   colour emoji of a COLR font in a window (RTG screen)
  ft2info    library/FreeType version, font names, text as ASCII art
  ft2bullet  the font engine as diskfont.library uses it
  ft2dfont   a font through diskfont.library, drawn in a window

License: FreeType License (FTL.txt) for FreeType, MIT for the library
around it (LICENSE.txt). Portions of this software are copyright (C) 2026
The FreeType Project (www.freetype.org). All rights reserved.