
fontpull / fontpush: Manipulate GEM fonts
=========================================

  My apologies for these brief instructions, but I'm in something of a hurry
today.

Compiling instructions
======================
  fontpull and fontpush were designed on Linux; you should just be able to 
type "make" and let them build. On DOS, you should use DJGPP; edit the 
Makefile, and where it says

#PBMDEF =
PBMDEF = -DUSE_PBM

move the # down one line so that it says

PBMDEF =
#PBMDEF = -DUSE_PBM

  I haven't tried compiling the programs on DOS, so what happens is anyone's
guess.

In use: fontpull
================

  Syntax: fontpull <file>

  fontpull attempts to extract the GEM font from one of:
* A GEM bitmap font file;
* A PC-GEM screen driver;
* The TOS 1.00 ROM image.

  It will write the font out as a portable bitmap (.pbm); in addition, if the
font was 8 pixels wide, it will write it out as a Linux console font (.psf). 
On the Unix version, you can provide a second argument which is a graphic
file format:

	fontpull file xbm

  which will attempt to use the "pbm" tools to output in that format rather
than .pbm.
  fontpull also displays the headers of the font or fonts that it finds.

In use: fontpush
================

  Syntax: fontpush <driver> <font> { <dest> }

  fontpush attempts to write one or more fonts into:
* A GEM bitmap font file;
* A PC-GEM screen driver;
* The TOS 1.00 ROM image.

  The first file on the command line is the file into which the font should
be merged. The second file is the font file itself, which can be in the
following formats:

* A GEM bitmap font file;
* A PC-GEM screen driver;
* The TOS 1.00 ROM image;
* A Linux console font (.psf);
* A raw CGA, EGA or VGA font.

  If there is a third filename on the command line, the merged file will be
written out under that name. If not, it will overwrite the first file.

  Example of use:

  fontpush sdpsc9.vga tos100.rom newpsc9.vga
  
  This will attempt to copy the three TOS fonts into the PC-GEM VGA driver.
The only one which will transfer successfully is the 8x16 font; there
is no 8x8 font in the VGA driver, and the 6x6 font on the Atari has more 
characters than the 6x6 font on the PC.

