========================================
GTERM USER'S MANUAL
-------------------

Graphcom Graphics Communication System
Version 1.3 (C)1991 Anthony Li
========================================



Introduction

Graphcom is a language developed for interactive
graphics communication. Features include:

o Up to 10,000 x 10,000 pixel resolution
o Up to 256 colors
o Animation
o Background music
o Mouse and joystick support

Your interface to Graphcom is a special terminal
program called GTerm. You can run GTerm by itself
or through your regular telecommunications
program.

The Graphcom system, including GTerm is released
into the public domain. Distribute it as far as
possible.



System Requirements

GTerm works with any IBM PC equipped with a
graphics display.

The GTerm disk or archive file contains these
files:

GTERM.TXT -- User's manual
GTERM.EXE -- GTerm program
GTCONFIG.EXE -- GTerm configuration program
*.BGI -- Video drivers

The files with extension .BGI are Borland Graphics
Interface drivers. If your video adaptor is not
supported by any of the BGI drivers provided, you
will have to acquire the correct file. Refer to
list below for the adaptors supported by various
drivers:

ATT.BGI -- AT&T
CGA.BGI -- CGA/MCGA
EGAVGA.BGI -- EGA/VGA
HERC.BGI -- HGC
IBM8514.BGI -- IBM 8514/A
PC3270.BGI -- 3270 PC
VGA256.BGI -- VGA/MCGA (256 color mode)



Installation

Copy GTERM.EXE, GTCONFIG.EXE, and the appropriate
BGI drivers into the directory of your telecomm
program. Actually, any directory is okay but you
will probably find it much easier to run GTerm
through your telecomm program if it's in the same
directory.

Before you can use GTerm, you must run GTConfig to
configure it to your computer. Enter the
directory containing the GTerm files and run
GTCONFIG.EXE.

When you run GTConfig, you will be presented with
a simple number menu. The menu choices are:

1) Serial port: 1
2) Baud rate: 1200
3) GTerm file directory:
4) Hercules graphics: FALSE
5) Use 2 graphics pages: FALSE
6) Joystick installed: FALSE
7) Allow sound/music: TRUE
8) BGI driver filename:
9) Graphics mode: 0
10) Save and quit
11) Quit without saving

Serial port is the port number (1-4) which GTerm
will use. The default serial port is 1 (COM1:).
Valid port numbers are 1-4.

Baud rate is the speed at which GTerm will use the
serial port. The default baud rate is 1200.
Valid baud rates are 110 to 115200.

GTerm file directory is the directory where GTerm
will store its macro files. This is originally
blank (current directory), but you may provide any
valid directory.

The Hercules graphics flag specifies whether your
computer is using a Hercules graphics card. The
default is FALSE, but if you are using a Hercules
graphics card and a mouse, set this to TRUE.

The Use 2 graphics pages flag tells GTerm to use
one graphics page or two. It is originally FALSE,
but if your video adaptor and mode support two
graphics pages, setting this to TRUE will improve
animation considerably.

Set the Joystick installed flag to TRUE if you
will use a joystick. It it originally FALSE.

To disable sound, set the Allow sound/music flag
to FALSE. The default is TRUE.

BGI driver filename is the filename of the BGI
driver, WITHOUT .BGI EXTENSION, that you want to
use. The default is blank. If this field is
blank, Graphcom will automatically detect the
best graphics mode for your computer. In this
case, field 9 (Graphics mode) is irrelevant.

Refer to the chart below for graphics mode numbers
for various BGI drivers:

BGI Mode Reference
--------------------------------------------------
Driver Mode Description
------ ---- -----------
CGA 0-3 CGA 320x200, 4 color, 1 page
4 CGA 640x200, 2 color, 1 page
5 MCGA 640x480, 2 color, 1 page

EGAVGA 0 EGA/VGA 640x200, 16 color, 2 pages
1 EGA/VGA 640x350, 16 color, 2 pages
2 VGA 640x480, 16 color, 1 page
3 EGA(Mono), 640x350, 16 shades, 1 page

VGA256 0 MCGA/VGA 320x200, 256 color, 1 page

IBM8514 0 IBM 8514 640x480, 256 color, 1 page
1 IBM 8514 1024x768, 256 color, 1 page

HERC 0 Hercules 720x348, 1 page
--------------------------------------------------




Using GTerm

Once you've configured GTerm to your computer, you
can run GTerm alone or through your regular
telecommunications program. To run GTerm through
a telecomm program, follow these steps:

1. Log into a BBS using your telecomm program.

2. If the BBS is not a standalone Graphcom
system, you'll have to select a Graphcom
door.

3. When prompted (e.g.,"Run GTerm now."), shell
to GTerm. To do this:

a. Perform a DOS Command (e.g., Alt-V in
Telix), or

b. "Jump" to DOS ("DOS Gateway" in
ProComm) and enter "GTERM".

Wait a few seconds for GTerm to establish a
connection with the BBS. If nothing happens,
press Enter. When the door finishes, you will be
automatically returned to the BBS. To manually
exit GTerm, press Alt-F10.



About Graphcom

Graphcom is a hardware-independent graphics
communications language. This program was
implemented in Turbo Pascal 5.5. If you're
interested in running graphics on your BBS,
download the file GRCOMxx.ZIP. This file contains
a collection of Graphcom doors. If you want to
write your own graphics and sound programs, also
download GCPROGxx.ZIP, which contains the
Technical Specifications and an implementation of
the Graphcom Language in Turbo Pascal, plus source
code to all the programs in GRCOMxx.ZIP. If you
have any questions, comments, or ideas, please
mail me at

Pi Square BBS
(301) 794-8316
Seabrook, MD



Disclaimer

Anthony Li claims no responsibility, express or
implied, for any loss or damage incurred by the
Graphcom programs.



Acknowledgements

ProComm is (c) DataStorm Technologies, Inc.
Telix is (c) Exis, Inc.
Turbo Pascal and Borland Graphics Interface are
trademarks of Borland International, Inc.
IBM and IBM PC are trademarks of International
Business Machines Corporation.