Psion 3a Fonteditor v1.72
=========================

The very latest version of this and my other
software is available from:

http://www.compulink.co.uk/~warp10/

You will also find details of forthcoming
releases.

Upgrading from versions before 1.7x onwards:
--------------------------------------------

You will need to re-enter your registration code.

If you do not have this, please contact me.

The following files are no longer required, and can
be deleted:

\APP\Fonted.opa

\APP\FONTED directory and its contents can be deleted

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

Software is copyright Steve Godfrey.

This file must accompany all copies of this software.

This program is SHAREWARE. You may use it for a period of upto
30 days, but if you continue to use it you must register it.

To register the software, please send £5 ($10) to:

 Steve Godfrey
 12 Linden Place
 Mitcham
 Surrey
 CR4 4EY
 England

or you may register using the GO SWREG facility on Compuserve.

Eurocheques accepted, but foriegn cheques are not accepted.

Foriegn notes accepted, email for details.

email: stevegodfrey@cix.compulink.co.uk

Installation:
=============
Copy the Fonted.app file to any APP directory and install as normal
using Psion-I from the system screen.

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 control-cursor keys to clear pixels as the cursor
moves.

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

To select another character, either press the appropriate key.

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 and type in the filename of your new font.

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.

Height    - The font height

Width     - The font widhth

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 may then alter any of the font characteristics using the menus.

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

See built-in help for further details.

Using fonts in your own programs:
=================================

From OPL, your fonts can be used as follows:

PROC test:
  global fo%
  fo%=gloadfont("\fon\Myfont.fon")
  gfont fo%
  gat 0,120
  gprint "Hello there"
  get
ENDP

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