Titlepage - Title Page printing utility. 
                     by Joel Swank 9-23-88

  Titlepage prints banner title pages for identifying listings. It uses 
amiga fonts to build large headings that are printed across the page.
Each pixel from a font character is represented by a printer character.
Titlepage should work with any Amiga font except for reversed fonts (are 
there any?). It generates standard Amiga printer escape sequences, so it 
should work with any printer. It allows the printer to be set to a variety 
of different modes. Some printers may not have all the different modes
allowed for by the Amiga escape sequences, so all modes may not work on 
all printers. Usage:

   titlepage [options] [strings] . . .

   The options set up the printer. The strings are printed in the most
recently set options. Any number of options/strings combinations may
be specified. They will be executed in order, left to right from the 
command line.

Strings:

   These are groups of ASCII characters. Each group will be printed on
a separate line. They may contain any character from 1 through 255.
Some fonts have patterns for non-printing characters (ASCII 128 and
up). Since these are difficult to put in a command line or text file, there
is a special syntax to access these characters: Any character preceded by
a '~' (tilde) will have 128 added to its ASCII value. To print a tilde
specify two ('~~'). These patterns will be printed in their -128 character.
To see what characters a font has, use the '-u' flag. Some fonts may
also have patterns for non-printing characters less than 128. These
may also be inserted in strings and will be printed in the letter 'O'.

Options:

-fxxxx  'xxxx' is the name of the font to use. Default is 'topaz'

-sxx    'xx' is the size of the font. Default is 8. The font and
        size are submitted to OpenDiskFont() which selects the closest
        match available.

-lxx    Set linesize to 'xx'. Default is 80. If condensed is selected
        default is 132. If elite is selected, default is 96. If both
        condensed and elite are selected, default is 160. If wide is
        select the above defaults are halved. This number is used for
        truncating lines and centering, when centering is requested.

-oxxxx  'xxxx' is the name of the file to receive the output. Default
        is 'PRT:' (the Amiga print device). If 'xxxx' is omitted,
        output is sent to stdout. This option must be specified before
        any parameter that causes printing (any except a,h,t,f,s,u and l).

-axxxx  'xxxx' is the name of an alternate input file. The file may
        contain any of these options and strings to print, separated
        by space tab or newline. To put blanks in a string, enclose
        it in quotes ("). To put quotes in a string precede it with
        a backslash (\).

-nxx    Causes 'xx' newlines to be output immediately. If xx is omitted,
        one newline is output.

-hx     Set the print character to 'x'. By default the print character is
+h      the character being drawn. This can result in uneven darkness.
        if '-hx' is specified, all printing will be done in this character.
        '-h' alone or '+h' can be used to return to the default.

-p      Causes a formfeed to be output immediately.

-d      Causes the date and time to be output immediately. It is printed
        in the currently selected printer mode (not banner).

The following options set and clear modes. A leading '-' sets
the mode and a leading '+' clears it.

-t/+t   Causes all subsequent printing to be centered.

-e/+e   Set/clear elite.

-c/+c   Set/clear condensed.

-b/+b   Set/clear bold.

-q/+q   Set/clear NLQ.

-w/+w   Set/clear wide or enlarged.

-8/+8   Set/clear 8 lines per inch (6 lines per inch is the default).

-i/+i   Set/clear italics. This selects the printer's italics character
        set and italicizes the font being printing. Italics takes more
        print line space than standard characters.

-u/+u   Set/clear upper mode. Upper mode causes all characters in the
        following string(s) to have 128 added to their value. This is
        is for accessing the 'upper' characters contained in some fonts.

Notes:
   Not all modes and combinations of modes will work for all printers.
The default linesizes are set for a narrow printer. A wide printer can 
print more characters in each mode. The actual number of characters 
that a string can contain varys greatly depending on the font selected 
and the mode the printer is in. You will have to experiment to see what 
you get.

Limits:
   Linesize may be from 20 to 1000. The fontname can be up to 95
characters. Input filenames, lines in alternate files, and parameters
can be up to 100 characters.

Examples:

titlepage -fruby -s15 -c -8 -n8 TitlePage -d -p

  Use the ruby15 font to print a header page for Titlepage in condensed,
8lpi, 8 lines from the top of the page, print the date and do a page eject.


titlepage -fsapphire -s14 -c -e Sapphire

   Try the sapphire14 font in condensed, elite mode.


titlepage -fruby -s15 -c -t Ruby -n3 -ftopaz -s11 Topaz11 

   Try the ruby15 font in condensed, centered, skip 3 lines and try the
topaz11 font.


titlepage -b GRONK +b -fruby -s15 -c -t Ruby -n3 -ftopaz -s11 Topaz11 

   Print GRONK in bold topaz8, then Ruby in ruby15, centered in condensed,
then skip 3 lines and print Topaz11 in topaz11 font centered and condensed.

COPYRIGHT Notice:
   This program is in the public domain, no rights reserved.