This file should be printed at 63 characters per line.

GRAFCHAR.TXT

This text file describes the GRAFCHAR.BLK file, a CF83 Forth
block file.  To convert this file to CF83 Forth blocks 1
through 12 on a blank disk, use the FILTOBLK.BAS program (on
Delphi and on CF83 Public Domain Disk No. 1). 

The blocks contain generating words for the ASCII character set
to allow printing of characters to the graphics screens in CF83
Forth's PMODEA, PMODEB, PMODEC, PMODED, PMODEE, PMODEF, PMODEG,
and PMODEH. 

To use these blocks you will need at least the CF83 Forth
Master Disk and the PMODE Graphics Word Set.  You will probably
also need the Block Editor.  These items are available from:

          BDS Software
          P.O. Box 485
          Glenview, IL 60025-0485      

In each PMODE, each character is 4 pixels wide by 8 pixels 
high, with the rightmost column and the bottom row blank to
provide space between characters and lines (i.e. the characters
themselves are actually 3 pixels wide by 7 pixels high).

For each character, use the word sxy to set the x and y
coordinates where you want the character to be printed.  The
origin of coordinates is in the upper left corner of the screen
with positive x-coordinates to the right and positive
y-coordinates downward.  The coordinates are referenced to the
characters' upper left corners.    

To print the characters, use the pc... words, where ...
represents the ASCII code of the character to be printed.  For
example, to print the ASCII character A at location x = 18 and 
y = 23, the word stream would be:

          18 23 sxy pc065

The character positions are not cleared before printing; the
characters will print right over whatever happens to already be
on the screen at that location. 

To load the blocks, first load the PMODE Graphics set (A, B, C,
D, E, F, G, or H) that you wish to use.  Then edit block no. 1
of this graphics characters set to remove the backslash in
front of the ps1 word that corresponds to the PMODE you are
using.  For example, if you are using PMODEC, after your
editing, the list should appear as:

     \ : ps1 ( x y -- ) pseta ;
     \ : ps1 ( x y -- ) psetb ;
       : ps1 ( x y -- ) psetc ;
     \ : ps1 ( x y -- ) psetd ;
     \ : ps1 ( x y -- ) psete ;
     \ : ps1 ( x y -- ) psetf ;
     \ : ps1 ( x y -- ) psetg ;
     \ : ps1 ( x y -- ) pseth ;

You must remove ONLY one backslash.  The others make CF83 treat
their lines as comments (i.e. they are ignored when compiling).

After editing block 1, load blocks 1 through 11.

You can also create your own 4 pixel by 8 pixel characters by
using the pc word.  The format is:

     : wordname ( -- ) 8 coordinates-list pc ;

where: 

     wordname is a CF83 word name chosen by you
     8 is the code indicating the end of the coordinates list
     coordinates-list is a list of the x and y offsets from the
       character's upper left corner of the character's pixels
       to be set.

Block 12 contains a sample character for your reference.  

GRAFCHAR.BLK is hereby placed into the public domain - you may
freely distribute copies in any manner you wish.

CF83 products available from BDS Software as of 6/30/92:

                                            PRICE     PRICE
                                            WITH      WITH
                                            MANUAL    PRINTED
ITEM                                        ON DISK   MANUAL

CF83 Forth Master Disk                      $ 15.00   $ 19.00

Technical Reference Manual                  $ 10.00   $ 25.00

Tutorial                                    $ 10.00   $ 22.00

Block Editor                                $ 15.00   $ 23.00

Double Number Set                           $  5.00   $  7.00

Assembler Set                               $ 15.00   $ 22.00

System Extension Set                        $  5.00   $  7.00

Controlled Reference Set                    $ 10.00   $ 12.00

Uncontrolled Reference Set *                $ 10.00   $ 20.00  

PMODE Graphics Set                          $ 15.00   $ 28.00

RS-DOS File Handling Set **                 $ 10.00   $ 13.00

  * Includes case structure, string operations, printer
    control, and more.

 ** Includes words to allow making ML files that will EXEC
    directly from BASIC, system saving, and more.

          Send SSAE for current detailed list. 

The versions with the Manual on Disk also include a READER
program which allows viewing the manual on the screen and/or
printing the manual to your own printer.

A CF83DEMO disk is available for $3.00 - the same demo can be
downloaded free from Delphi - but note that the demo will NOT
allow loading of CF83 Forth Blocks - you need the master disk
for that.