short:    	TrueType text rendering engine (v 4.1)
uploader: 	krashan@amiga.pl
author:   	krashan@amiga.pl
type:     	util/libs
distribution:	public domain
replaces:       ttrender.lha

version:  4.1 (29.9.2002)
requires: OS 3.0+, 68020

The library is fast, AmigaOS friendly TrueType render engine. It has
nothing to do with Amiga outline font system. This system has a lot of
limitations which make it useless for high speed and quality text
output. If someone wants an integration of TrueType with AmigaOS
bullet.library like outline font system, should consider using
ttf.library. Ttengine.library opens TrueType font by itself and renders
high quality glyphs directly into any RastPort.

The render engine of the library is based on FreeType2 project
(http://www.freetype.org). This version of ttrender.library uses 2.0.9
FreeType build.

See http://amiga.pl/ttengine for news, downloads, online autodoc and
programming tutorial.
 
CHANGES (from older ttrender package)

v 3.2 (9.6.2002)

   - Internal changes, some bytes of executable saved.

v 3.3 (9.6.2002)

   - More internal changes, much of common code moved into subroutines,
     140 bytes of executable saved. Minor speedups here and there.
   - Internal tt_putstr() calls tt_strwidth() only when JAM2 drawmode is
     used, a minor speedup.

v 3.4 (10.6.2002)

   - The library now recognizes (but not yet supports) planar and 8-bit
     chunky destination bitmaps.

v 3.5 (10.6.2002)

   - Full 8-bit chunky and AGA/ECS/OCS planar bitmaps. Not sure of
     HAM6/HAM8... ;-). Well not that slow I've expected.

v 4.0 beta1 (16.9.2002)

   - API changed completely as well as some library internals.

v 4.0 beta2 (17.9.2002)

   - Library caused Avail FLUSH to crash if opened more than one time,
     system memory lists were corrupted. Fixed.
   - TT_TextExtent() tested throughly. Test program ('txex') with
     sources included into distribution.

v 4.0 beta3 (18.9.2002)

   - Library name changed to "ttengine.library" to avoid backward
     compatibility problems.
   - TT_TextFit() implemented partially (no right-to-left fitting). Test
     program ('txfit') with sources included into distribution.
   - Gamma correction for antialiased dark text on light background
     implemented.

v 4.0 beta 4 (20.9.2002)

   - Library API changed slightly, TT_SetFont() introduced.
   - Library initialization failed if "ENV:ttengine.database" could not
     be opened. Fixed.

v 4.1 (29.9.2002)

   - Added SYMBOL_CS character mapping for fonts with non-standard mapping
     like Symbol or Wingdings. Now these fonts can be used with Unicode
     16-bit encoding.
   - Added new attributes TT_FontName, TT_FontFamily, TT_FontSubfamily for
     TT_GetAttrs(). Font names are extracted from the font file. If the font
     file contains names in multiple languages, language is selected
     according to "preferred languages" locale settings.
   - Added "FontNames" example program demonstrating feature described above.
   - Added TT_Transparency tag allowing for transparent text.
   - Added 'background' example program.

    
FEATURES

The library expands FreeType functionality making usage of TrueType
fonts easy and comfortable. Below you can find key features:

   - renders whole strings (not single glyphs) with kerning.
   - antialiasing to any (not neccesarily uniform color) background.
   - optional text transparency.
   - system compatible output to any (including planar) RastPort.
   - supports JAM1. JAM2, INVERSVID, COMPLEMENT RastPort modes.
   - supports 8-bit to Unicode mapping with "ENV:ttfcodepage" table
     compatible with ttf.library.
   - allows for direct 16-bit Unicode string rendering.
   - easy to use, graphics.library like API.
   - efficient system-wide glyph cache system.
   - font database system allows flexible font files storage and
     advanced faces classification.

INSTALL

copy Libs/ttengine.library to LIBS:
modify example database file and place it in ENV: and ENVARC:
You can download quality and free TrueType fonts from MicroSoft website.