Supplements for True Type to PostScript Type 1 Converter 

(Do not edit this file, it is generated from README.html!!!)

bz
--

A small program to draw the Bezier curves on an alphanumeric display.
The recommended way of uing it is to run it from xterm with "Tiny"
(if you want higher magnification) or "Unreadable" (if you want
higher resolution) font and as big window size as possible. The size
of the window can be obtained by running "stty -a". For everything else 
just "Use the source, Luke!"

cmpf
----

A small program to compare the rendering of two supposedly
nearly-identical fonts at low resolutions. It requires the
T1LIB library. This program may be used to compare the
effect of various options of the converter on the resulting
fonts. Create two .pfa files, one with one set of options,
another with another set of options, then use this program
to compare them.

dmpf
----

A small program to dump the bitmaps of all glyphs of the font
at low pixel sizes, up to 20 pixels. It requires the
T1LIB library. This program may be used to compare the
effect of changes in the T1LIB rasterizer and just for visual
search for rendering anomalies.

lst.pl
------

A simple PERL script that generates an HTML file
with the full list of all characters in all
possible styles of the Variable-width and Fixed-width
fonts. This file is quite convenient to look
at the converted fonts in Netscape (or other
graphical browser).

cntstems.pl
------

A simple PERL script that counts the required hint stack in the
interpreter to rasterize the glyphs of the font. May be quite
useful in search for missing glyphs which may be aborted due to
insufficient stack depth.

showg
-----

A PERL script that draws the glyphs and their interesting
metrics (such as coordinates of the dots, hints and blue zones)
in PostScript. It works only with un-encoded font files generated
by ttf2pt1. The intended use is like:

  showg [-c <fontfile.t1a>]...  <fontfile.t1a> <glyph-to-draw>... >file.ps
  gv file.ps # start the Ghostscript viewer

As you can see, multiple glyphs may be specified. The glyphs may be
specified in one of three ways:
  - as a decimal code (for example, 43 )
  - as a glyph name preceded by a slash (for example, /plus )
  - as a literal character preceded by a dot (for example, .+ )

So for example the following command would draw the same glyph "left
parenthesis" three times:

  showg file.t1a 40 /parenleft .\( >/file.ps

Don't forget that some characters have to be protected from the shell
by backslash as shown above, or else the shell would try to interpret
them before passing to the program.

One file (given as the first argument) is considered the main file
but multiple files can be specified with option -c for visual comparison
of the outlines. The glyphs from the main file are drawn in black
and supplemented with coordinate grid and sidebars for hints. The
glyphs from the comparison files are drawn in slightly lighter colors 
(red, cyan, brown) and no supplemental information is provided for them. 
Each use of option -c adds one comparison file, this option may be used 
multiple times. If there are more than 3 comparison files the colors
repeat cyclically.

So for example the following command would draw the same glyph "left
parenthesis" from three files on the same page:

  showg -c fileA.t1a -c fileB.t1a file.t1a .\( >/file.ps

This program is quite valuable it you want to take a close-up view at 
the font.

The outlines are drawn in black, the ends of the curves and
lines are marked as dots, the first dots of the outlines
are fatter. The Blue Zones are drawn in light blue. The
substituted hints are marked in red, the global hints are
marked in blue. The coordinate grid is drawn in green.
The stems and the values of coordinates are for convenience
marked twice, on each size of the picture.

