Fontinator 0.10
---------------

Fontinator is a command line tool for converting RISC OS fonts into sprites, suitable for use in games.


Usage:

fontinator <fontname> <outname> [options]


Options are as follows:

-pt=<n>		Size of font, in points (default 20)
-fill=<bbggrr>	Fill colour for font (default black if no fill sprite or
		outline; transparent if there is a fill sprite/outline)
-aal=<n>,<bbggrr>	Anti-aliasing depth (0-14) and colour. (default is no
			anti-aliasing; option has no effect if an outline or
			background sprite is used)
-back=<sprfile>	Spritefile to use as the background (interior) of outline fonts
-ol=<width>,<bbggrr>	Add an outline to the list of outlines to render.
-fixedw[=<n>]	Produce fixed-width font (default off)
-fixedh[=<n>]	Produce fixed-height font (default off)
-pad[tlbr]=<n>	Pad top/left/bottom/right of each letter with <n> pixels
		(default 0)
-pad=<n>	Pad all sides with <n> pixels (default 0)
-max=<n>	Max character code to export (inclusive; default no limit)
-xeig=<n>	X eigen value of output sprite (default=1, i.e. 90dpi)
-yeig=<n>	Y eigen value of output sprite (default=1, i.e. 90dpi)
-bpp=<n>	Colour depth of sprites, in bpp (1,2,4,8,16,24) (default 24)
-spacew=<n>	Width of space character
-findbbox	Find character bounding boxes manually (for broken font files)
-alignv		Produce variable-height font, but with chars aligned vertically
-append		Append sprites to the <outname> spritefile
-range=<x>	Range of character codes to export - e.g. -range=48-58,64-92
		for just numbers and upper-case letters

For example:

fontinator Homerton.Bold test

... would convert Homerton.Bold into the 24bpp spritefile 'test', at 20pt.

fontinator Homerton.Bold test2 -fill=ffffff -pt=40 -ol=1,808080 -ol=0.85,c0c0c0 -ol=0.7,000000

... would convert Homerton.Bold into the 24bpp spritefile 'test2', at 40pt, with 3 outlines applied to produce a simple anti-aliasing effect.


Notes:

* Background sprites may not always be aligned correctly
* Writing spritefiles with <256 colours may result in incorrect colours
* 256 colour sprites with masks may not be output correctly


Legal gumpf:

fontinator was written by Jeffrey Lee, me@phlamethrower.co.uk
http://www.quote-egnufeb-quote-greaterthan-colon-hash-comma-underscore-at.info/
