Text Summary
				~~~~~~~~~~~~

 ASCII Character Codes
 ---------------------

                        second nibble

            0  1 2 3 4 5 6 7 8 9 A B C D E F
         ------------------------------------
       2 | spc ! " # $ % & ' ( ) * + , - . /
1st    3 |  0  1 2 3 4 5 6 7 8 9 : ; < = > ?
nibble 4 |  @  A B C D E F G H I J K L M N O
       5 |  P  Q R S T U V W X Y Z [ \ ] ^ _
       6 |  `  a b c d e f g h i j k l m n o
       7 |  p  q r s t u v w x y z { | } ~


 Subroutines & Macros Supplied in HW_Text.i
 ------------------------------------------

 WriteText		a0->string to print
 WordCon		d0.w=number to convert, a0->text buffer (5 char min)
 LongCon		d0.l=number to convert, a0->text buffer (10 char min)

 Defining The Screen For WriteText
 ---------------------------------

       FONTSCREEN      bit plane address (,width) (,height) (,depth)

 Width, height and depth have default  values  40,  256 and 4 respectively. If
you are using bit planes with these dimensions, you need not specify them. The
start address of the first bit plane must  be specified however. Some examples
of using the macro are given below.

       FONTSCREEN      #bitplane

       FONTSCREEN      a0,40,200,3

       FONTSCREEN      #bitplane,80,512,4

 Adding Fonts To The System
 --------------------------

       SETFONT         font number, data address

 As with FONTSCREEN, if you are passing a  label as the data address it should
be preceded by a '#' character. The font  number can be any value from 1 to 8.
Below are some examples of using this macro.

       SETFONT         2,#MyFont

       SETFONT         3,a0

 Text Control Sequence Macros
 ----------------------------

 Name   Byte    Syntax          Function
 ~~~~   ~~~~    ~~~~~~          ~~~~~~~~
FEND     $00    FEND            Marks the end of a string.

FEXIT    $01    FEXIT           Causes premature exit from print routine.

FCOLOUR  $02    FCOLOUR,n       Changes the colour used for printing. The
                                control byte should be followed by the number
                                number to use. Eg, to use colour 3:

                                       dc.b    FCOLOUR,3

FPOS     $03    FPOS,X,Y        Start printing from specified X,Y position. X
                                should be specified as bytes from the left
                                side of the bit plane, Y as lines from the top
                                of the bit plane. Eg, To start printing 4 
                                bytes across, 20 lines down:

                                       dc.b    FPOS,4,20

FFONT    $04    FFONT,n         Start using a new font. The routine can
                                recognise up to 8 fonts, numbered 1 to 8.
                                Eg. Switch to font 3:

                                       dc.b    FFONT,3

FCENTER  $05    FCENTER         Centralises the following ASCII string in the
                                bit plane when printing. NOTE, this code must
                                be followed by an ASCII string that terminates
                                with either an FEND, FEXIT, FPOS or $0a byte.
                                Eg. To centralise the text 'Mega Demo':

                                       dc.b    FCENTER,'Mega Demo',$0a

FMODE    $06    FMODE,n         Selects the mode of printing to use. Two modes
                                are supported, SPLAT and BLEND. In SPLAT mode,
                                the character graphics overwrite data already
                                contained in the bit plane. In BLEND mode, the
                                character graphics are merged with any data
                                already contained in the bit plane. Eg. To
                                select SPLAT mode ( this is the default mode )

                                       dc.b    FMODE,SPLAT

FSINGLE  $07    FSINGLE         Switches on single character printing. The
                                routine will always return after printing a
                                single ASCII character.

                                       dc.b    FSINGLE

FSTRING  $08    FSTRING         Switches off single character printing.

                                       dc.b    FSTRING

         $0a    $0a             Moves the cursor to the start of the next
                                line. Note, this sets X=0 and Y=Y+8. Error
                                checks are made on the new position. Eg.
                                To print a line of text and then move down
                                a line on the display and print another line
                                of text underneath the first:

                                       dc.b    'This is line 1.',$0a
                                       dc.b    'This is line 2.'

 Single character  mode  is  for  use  in  interrupt  routines.