Psion 3a Fonteditor v1.37 (09/10/94)
===================

Installation:
-------------

Install the following files on your 3a, in the stated directories.
Any disk(s) can be used.

  \APP\Fontedit.opa       - the application

  \APP\Fonted\Copybit.bin - machine code routines

  \FON\Beton13.fon        - font to test program with

  \APP\Fonted\Fonted.hlp  - the help file. Only copy this if you require
                            online help

  \OPO\Sys$help.opo       - the opl help module. You may already have
                            a copy of this on your 3a
                            Only required if you want online help.

********* IMPORTANT NOTE FOR ARCHIMEDES/POCKET FS USERS: ***********

  \OPO\Sys<help.opo       - A copy of Sys$help for Archimedes users.
                            Due to the fact that Archimedes cannot
                            have a $ in a filename, even with zipfiles,
                            use this file instead. Make sure it is
                            called Sys$help.opo when copied to the
                            Psion 3a. (PocketFS should insert the $
                            for you. PC/MCLINK users ignore this file.

Install the application as normal. Any available fonts should be listed
under the fonted icon.

Note: The example font was obtained from a selection of fonts converted
===== from the Amiga by M.Schuster (ns103@fim.uni-erlangen.de). It is
      however, possible to create such fonts using this program with
      time and effort! You can of course, use this program to modify
      exisiting fonts for your own use.

REGISTRATION:
=============

Software is copyright Steve Godfrey.

This file must accompany all copies of this software.

This version of Fonted is fully functional and may be copied freely.
However, if you would like to recieve free updates, or show your
appreciation for the software, or have any changes/improvements
made to your copy, please register it by:

Sending 5 UK pounds to:

 Steve Godfrey
 12 Linden Place
 Mitcham
 Surrey
 CR4 4EY
 England

email: stevegodfrey@zaparta.demon.co.uk
       stevegodfrey@cix.compulink.co.uk

I will attempt to implement any suggestions made by registered users.

Additional features are available to registered users, and more will
appear from time to time.

Keys: (Certain features are only available to registered users).

From main display:

        Psion-o : open font file
  Shift-Psion-r : load font from ROM
        Psion-x : Exit program
        Psion-s : save font
        Psion-a : save as
        Psion-n : create new font
        Psion-h : Alter height of font
        Psion-i : Invert whole font
        Psion-c : Clear font
        Psion-d : Delete character
        Psion-v : Show version
        Psion-q : Register
        Psion-b : Alter baseline position
        DIAM    : Edit current character

Additional main functions for registered users:

        Psion-f : Alter/view font info
        Psion-r : Alter range of characters defined in font
        Psion-k : Compress font - removes any undefined characters from the
                  low and high end of the font, to save space. Only works on
                  normal fonts, as fast fonts have all 256 characters stored
                  regardless of whether they are defined or not.

Edit display keys:

        Psion-w : Alter width of character
        Psion-c : Clear character
        Psion-i : Invert character
        Psion-x : Exit program
        Psion-+ : Next character
        Psion-- : Previous character
        DIAM    : Return to main display

Additional edit functions for registered users:

        Psion-b : Bring (import) bitmap from another character
                  This is useful for example, to create an R.
                  Bring in the definition of a P and most of the
                  work is done! Same with O/Q, I/T etc.
                  You will be asked for a character to copy from.
                  Either type a single letter/digit to be copied,
                  or type a two/three digit decimal number, or
                  hex preceeded by $. ie. if you type 1 character,
                  it takes the ascii code of the character and copies
                  that character. If you type more than 1 character,
                  it tries to evaluate what you type to get the ascii
                  code to copy from.

        Psion-g : Open/Close gap. This effectively lets you delete
                  or insert rows/columns in the character. This works
                  in a similar way to the same function in the
                  spreadsheet, except that you can open/close to
                  any of the four sides of the cursor. You will be
                  asked for the type of gap, open/close, and the
                  direction, left/right/up/down. Note that the
                  opposite of open-left is close-right and the
                  opposite of close-up is open-down etc.

More features will appear in later versions.

Editing fonts:
===================

The DIAM key toggles between the full font and character edit mode.

When a font is loaded, the program will display all the characters
in the font along with the character bounding boxes in grey. The
cursor will indicate the selected character. You can select
other characters using the cursor keys or by pressing the character
required. Undefined characters within the fonts character range
are shown as grey blocks.

If the font is too large to fit all characters on the screen at once,
the characters will scroll as required.

If you try and edit an undefined character, you will be asked if
you wish to create it, and if so, you can enter the character width.
Note that FAST fonts are limited to widths of 8 or less.

Press DIAM to edit the currently selected character. A charcter edit
box will appear, the scale of which depends on the height and/or width
of the font. Use the cursor keys to move the cursor around the edit box,
and TAB to toggle a bit on or off. Use shift-cursor keys to set pixels
as the cursor moves, and psion-cursor keys to clear pixels as the cursor
moves.

The baseline of the font will be shown as a black/grey line. 

To select another character, either press the appropriate key, or use
Psion+/-

To return to the main display use the DIAM key.

When loading fonts from ROM, do not press TAB on the file selector as this
will reset the current path - this is an operating system 'feature'.

Some of the font files in ROM are multiple font files. If you load one of
these, you will be shown the names of the fonts contained in the file.
Select the one to load and press enter.

Creating a new font
===================
Select Psion-n. You will be asked the following:

Fontname  - upto 16 characters. This is stored inside the fontfile, and
            does not have to be the same as the font filename.

Fonttype  - Normal or Fast. Fast fonts are stored with one byte per character
            per row, taking up more room, but making for faster display.
            Fast fonts are limited to character widths of 0 to 8.

Low char  - Lowest character code used by the font (0 to 255)

High char - Highest character code used by the font (0 to 255)

Press enter to continue or esc to quit create new font

You will then be asked:

Spacing   - Proportional or fixed. If proportional, the program intelligently
            works out suitable spacing for all the characters for you, with the
            widest character determined by max width. You can of course alter
            them yourself. If fixed, all the characters have the width as set
            by max width.

Max Width - Sets the width of all characters on fixed spacing, or the maximum
            width of characters on proportional spacing.

Height    - Height of font in pixels.

Descender - Number of pixels below baseline.

Pressing enter confirms the new font, and you can then start creating it.

===============================================================================