home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Crawly Crypt Collection 1
/
crawlyvol1.bin
/
telecomm
/
ansi190
/
ansi190.doc
< prev
next >
Wrap
Text File
|
1992-03-27
|
21KB
|
434 lines
ANSITerm By Timothy Miller
Version 1.9 Two Worlds Software
Documentation by Timothy Miller & Sean Dougherty
(c) Copyright July, 1992 Timothy Miller, Two Worlds Software
NO PORTION OF THIS PROGRAM MAY BE MODIFIED, DISASSEMBLED, DECODED,
OR REMOVED BY ANY MEANS WITHOUT PRIOR PERMISSION OF THE AUTHOR.
NO PORTION OF THIS PROGRAM MAY BE USED IN ANY OTHER PROGRAM. THE
ABOVE ALSO APPLIES TO THE FONT FILE INCLUDED WITH ANSITERM.
ALL OTHER RIGHTS RESERVED.
THE USER IS AUTHORIZED TO USE THE PROGRAM ANSITERM. HE HAS
PERMISSION TO DISTRIBUTE THIS PROGRAM, AT NO COST. NO PROFIT MAY BE
DERIVED OUT OF THE SALE OF THIS PROGRAM WITHOUT THE SPECIFIC
PERMISSION OF THE AUTHOR.
THE USER IS PERMITTED TO USE THE ANSITERM PROGRAM FOR A TRIAL PERIOD
OF THIRTY DAYS, AFTER WHICH TIME, THE USER MUST SEND THE $15
REGISTRATION FEE TO THE ADDRESS LISTED BELOW. IF, AFTER THIRTY DAYS,
THE USER HAS NOT REGISTERED ANSITERM, ANSITERM MUST BE REMOVED FROM
HIS COMPUTER SYSTEM. PIRACY IS NOW A FELONY!
The author, Timothy Miller, can be contacted as:
Timothy Miller - Excalibur II BBS (813)988-2603
Timothy Miller - Flea Infested BBS (813)989-8564
T.MILLER23 - GEnie
tmiller@suntan.ec.usf.edu - Internet
millert@eggo.csee.usf.edu - Internet
The following files are part of the ANSITerm package:
ANSI190.PRG
ANSI190.DOC
FONT48.DAT
These files MUST be included. All other files are optional, except
XYZ which is necessary for file transfers.
ANSITerm's Features (* = New to version 1.5B, % = Updates for v. 1.8)
(& = Updates for v. 1.9)
- ANSITerm is a 100% ANSI VT-102 compatible terminal program that
supports full 16 colors, blinking text, with 80 columns.
- Supports X-modem, Y-modem, and Z-modem transfers (using XYZ.TTP)
- Full mouse support and menu bars
- AutoDialer with separate options (line-feeds, local echo, etc.)
for every entry.
* Capture buffer with the ability to send and print selected blocks
* Selectable color palettes
* New intelligent memory saving techniques
* View Buffer and block functions
* Auto Z-modem Download and Upload
* Ten 79-character global macros
* Upload/Download paths can be set along with the path of XYZ.TTP
% Better compatibility with Warp 9
% "Can't find XYZ.TTP" bug fixed.
% Properly supports VT-100 tabs
% Supports Y-modem G with Alan Hamilton's XYZ 2.02
% Buffer viewer now has PRIMITIVE editing capabilities
and displays text 4 times faster
% 57600 bps MIGHT work on an Atari TT
% Terminal displays text at least 2 times faster
& ANSITerm now supports underlined text
& Type-ahead buffer now takes up the entire width of the top line
& Buffer editor Delete Block bug fixed.
& An escape character can now be typed into the editor (HELP key)
& Character for <CR> (#13) in font has been changed to something
meaningful. Character for <LF> (#10) has been shifted right
by one pixel so it doesn't jam up against the new <CR>.
& The dialer will now properly dial all 14 telephone number
digits.
NOTE: The filename of the dialer and options file that is loaded
when you run the ANSI190.PRG program is STILL "ANSIDIAL.15B".
NOTE ALSO: When going to a file selector, ANSITerm will sometimes
appear to lock up. Just try hitting a few mouse buttons and the
file selector should appear. A similar situation occurs sometimes
when exiting ANSITerm.
ShareWare Info
This program is shareware and I have put much time into making this
into the best terminal program possible. If you use and like this program,
please support the author and allow him to make future upgrades by sending
a $15 donation or more to:
Timothy Miller
7519 Winging Way Drive
Tampa, FL 33615-1519
U.S.A.
Please make checks payable to Timothy Miller. All users in the
U.S.A. who register CAN REQUEST free updates by mail.
File Transfers
File transfers can be accomplished through the use of Alan Hamilton's
XYZ file transfer program. I have found no way to keep the program
in memory and call it when needed, so ANSITerm must load it each time
you transfer a file. For hard-drive users, this is not a problem
since ANSITerm remembers where XYZ is, but for floppy disk users, it
requires extra effort. ANSITerm will not allow you to swap floppys
(load XYZ from one and transfer to/from another) so the use of a RAM
disk is recommended for this purpose. You can set ANSITerm to load
XYZ from the ramdisk. (With a one floppy system, telling ANSITerm to
load XYZ from drive B: may have unpredictable results if ANSITerm is
loaded from Medium Res. The alert box may not display right. Try it
at your own risk.)
Menu Bars
To select a menu, click on the title. To make it go away, click
on the title again, outside of the window or on another title.
Auto DIALer Menu
To select a slot that has not been selected, click anywhere on the
line except for the field which says DIAL.
To insert a one-second pause in any editing fields sent to the modem,
press [F10]. This works for all macros. To insert a pause into
the phone number, most modems require a comma.
|DIAL|
If you click on DIAL on any line which has not been tagged for
group dial, that slot will immediately be selected, the dialer
will go away, and the telephone number listed in that
slot will be dialed. If that slot has been tagged for group
dial, the dial cycle will begin.
|J| (group dial)
If you click in the small field between DIAL and the name field
of a selected slot, that field will be tagged for group dial. If
you click in that field again, the slot will be untagged.
|BBS Name |
The next field to the right is the name field. Click here to
edit. Left and right arrow keys move the edit cursor left and
right. Delete removes the character that the cursor is on and
moves all characters to the right left to fill in the space.
Backspace deletes the character to the left of the cursor and
moves all characters at the right of the cursor to fill in the
space.
|I|
Initialize string. This allows a string containing optional
modem commands to be sent to the modem before the command to
dial is sent.
|Phone number|
To the right is the phone number field. Click here to edit the
phone number as you would for the name field.
| Baud|
Click here repeatedly until the baud rate you want is displayed.
The baud rate numbers have been shortened to provide greater space,
and the numbers are the baud rate divided by one hundred.
|Options |
Each column of this field corresponds directly to an option in the
options menu, essentially the same order. They are also listed
in the help menu. The meanings of the symbols are listed with
the OPTN menu information in this manual and below:
W: End of line wrap B: Destructive back space
E: Local Echo A: Application mode
R: Cursor Application mode N: New line and line feed mode
G: IBM Extended Character Graphics Set
L: Enable blink
ZYKXCG: Transfer protocol
Z: Z-modem
Y: Y-modem (batch)
K: X-modem 1k
X: X-modem (standard)
C: X-modem checksum
G: Y-modem G (for use with error correcting modems)
C: Capture enable F: Filter ANSI codes
Y: Type-ahead buffer
| F1: | F2: | F3: | Macros
There are 3 44-character macros for each slot in the dial menu.
To edit one, select a slot, and click on the macro you want to
edit. Edit as you would for the BBS name. A return character is
NOT automatically transmitted at the end of the macro, so you must
put one in manually, by pressing the Enter key on the numeric
keypad. In fact, any non-printing character (<ESC>, LF, FF, etc.)
can be entered into the macro editing field and transmitted as part
of the macro. To transmit the macro while on-line, press the
function key corresponding to the macro you wish to send. To insert
a one-second pause, press F10 in the editing field where the pause
is needed.
Options (OPTN) Menu
End of line wrap
With this option off, any character printed at the right most
column will overwrite any character at that position without
wrapping to the next line.
Destructive backspace
When this mode is on, if a backspace character is received,
the cursor will back up one column and erase any character at
that position. If this is not selected, the cursor will back
up on column, but not erase any character there.
Local Echo
When this option is selected, any keys that you press will be
automatically displayed on the screen as well as transmitted.
(half duplex mode)
Application mode
If this mode is on, the keys on the numeric keypad will send
ANSI escape sequences instead of the characters which appear
on the keytops.
Cursor key application mode
The cursor keys normally send ANSI escape sequences to the
modem when pressed. If this option has been selected, a
different set of escape sequences will be transmitted by
the same keys.
New-line and line feed mode
If this option is selected, linefeed implies both return and
linefeed, and the return key sends both return and linefeed.
IBM Extended Character Graphics Set
If this mode is on, any characters with a value greater than
127 will cause graphics characters to be displayed. If this
mode is off, any such characters will have their most significant
bit stripped. This is for boards and on-line services that
insist on using set or even parity.
Enable blink
When this is selected, all characters that have been printed
with the blink attribute set will flash on and off at regular
intervals.
Dial Command
When you click on this, you can edit the command that ANSITerm
sends to the modem to make it dial. For example, "ATDT" for
tone dial, "ATDP" for pulse dial, or "ATDT70#," for tone
dial, call waiting off, and the comma for a pause.
RTS/CTS
Enables RTS/CTS hardware flow control. Most ST users require
a fix program for this to operate properly.
Dial timeout
This allows you to set the number of seconds the cycle dialer
waits before skipping to the next board selected for group
dial. Click on this line to edit. If a 0 (zero) is entered,
NONE is displayed and the cycle dialer will wait until either
the modem or the user tells it to skip to the next selected
slot.
Edit Macros
Allows you to edit the 10 global macros. Shift and a function
key selects the macro to be edited (RETURN lets you finish
editing), and <ESC> lets you exit back to the terminal. To
insert a one-second pause into a macro, press the F10 key. To
transmit a macro, hold the shift key and press a function key.
The Alternate-M key combination also starts the macro editor.
Set Loadup Macro
When ANSITerm is first booted this macro is sent to the modem,
unless the DCD (Carrier Detect) line is high.
Quit
Selecting this causes ANSITerm to exit to the program which
called it (or the GEM Desktop). This can also be selected by
pressing the UNDO key.
o The OPTN menu will not go away if you select one of the options
so you have the chance to select or deselect more than one option
before clicking outside of it to remove it from the screen.
Select BAUD Menu
You can click in this menu to select your baud rate. 38400 bps
and 57600 bps are supported, but reliable operation cannot be assumed.
FILE Menu
Download
Loads XYZ from disk (or RAMDISK) to transfer a file. If
Z-modem or Y-modem is selected, transfer will start immediately
to the folder you select with the Set D/L Path option. If
any other protocol is selected, you will immediately get a
file selector. This can also be selected with the Alternate-D
key combination.
Upload
Loads XYZ just as Download, but it always gives you a file
selector so that you can select the file to be uploaded (or
wildcard for Z-modem or Y-modem). This can also be selected
with the Alternate-U key combination.
Z-modem, etc.
Click on one of these to select which protocol you want to use
at the moment. As with the OPTN menu, this menu will not go
away if you select one of the protocols, so you can immediately
select upload or download without having to reselect the menu.
Save Dialer/OPTN
Saves the contents of the DIAL menu, the default download path,
and the Dial timeout to disk. If you are using floppy disks
and running XYZ from a RAMDISK, be sure to save to the floppy disk.
This also saves the options download/upload path, dial
timeout, buffer size, delay timing, dial command, buffer
installed/uninstalled status, color palette number, Loadup Macro,
baud rate setting, RTS/CTS status, CR/LF filter status, Auto
Z-modem selected/deselected, and the ten global macros.
Load Dialer/OPTN
Loads a dialer from disk and the options with it. ANSITerm can
indirectly support more than one dialer menu and set of options
this way.
Set D/L Path
This allows you to pre-set the path to which Z-modem and Y-modem
downloads will be saved. Clicking here will give you a
file selector.
Set U/L Path
This allows you to pre-set the path to which uploads will be
directed. Clicking here will give you a file selector.
Set XYZ Path
This is the path of the program, XYZ.TTP, to enable ANSITerm's
download and upload options.
Auto Z-modem
This selection gives ANSITerm the ability to detect Zmodem uploads
and downloads independant of XYZ. If either an upload string or
download string is detected, ANSITerm immediately runs XYZ if this
function is on.
Capture Buffer (BUFR) menu
If the buffer becomes 75% full, the 'Bufr' menu will change to
'75%+'. If, while transmitting the buffer, you suspend sending
by pressing Alternate-S, the menu will change to 'Suspnd'.
If the buffer fills completely, the menu will change to 'Filled'.
Install Buffer
Allocates the amount of memory specified by the Bufsize editing
field and makes it available for capturing modem input, screen
snap-shots, and loading files from disk for transmit or editing.
Capture
When selected, all characters that come from the modem will be
added to the buffer.
Filter ANSI
In this mode, all ANSI escape sequences are filtered out and
only ASCII text may be added to the buffer.
Load buffer
Clears the buffer and loads the specified file into it.
Save buffer
Saves the current contents of the buffer to disk.
Clear buffer
Empties the buffer.
Print buffer
Sends the current contents of the buffer to the printer.
Send buf
Sends the current contents of the buffer to the modem and filters
linefeeds and/or carriage returns according to the setting in
Edit Buffer.
Bufsize
You can edit this field if the buffer is NOT installed to
change the size of the buffer. To change the buffer size,
you must not have a buffer installed.
Delay
This specifies the time (in 1/200 second units) that Send Buf
(and send block from the buffer editor) waits between characters
while sending data.
FreeMem
This is not an option but rather a window that tells you how much
free memory you have.
Used
This also not selectable, but tells you how many bytes have been
added to the buffer.
Type Ahead
This activates the type ahead buffer. The buffer can contain up to
512 ASCII characters and control characters. The Keypad Enter will
insert <CR> (and <LF> if NewLine/Line Feed is on), the [HELP] key
transmits the buffer contents without a <CR> and the optional <LF>,
[F10] will insert a one second pause (this also works for the
various other editing fields that output to the modem), Up arrow
moves to the beginning, and the down arrow moves to the end.
Edit Buffer
This option switches to the edit buffer screen. ALT-V also
activates this.
Keys: [ESC] - Quits Edit Buffer mode,
[HELP] - types an escape character.
[UP/DOWN/LEFT/RIGHT ARROW] - Moves cursor,
Shift-Up - Pages Up, and Shift-Down - Pages Down
^A=Redraw screen ^T=Top of buffer ^F=Bottom of buffer
Blocks: ^B=Begin ^E=End ^U=Hide ^S=Transmit ^P=Print
^D=Delete
Filters: ^R=Return ^L=Line Feed
IMPORTANT: These functions filter Returns and Linefeeds out
the selection to transmit in the editor and ALSO from the
complete buffer contents send from the terminal screen.
At the request of one of my betatesters who wanted to manually enter
ANSI escape sequences into the buffer editor, I have made the HELP
key type an escape character into the buffer.
HELP menu
This menu has no selections. It gives an abridged list of
the dialer options and short-cut key combinations.
Special key combinations available:
F1 to F3 Send macros corresponding to the current dialer slot
selections.
F5 Resets printing colors to white text, black
background, no blink, not bold, etc. for all
characters received after this is selected, until
an ANSI escape sequence is received that changes
the colors.
F6 Prints the contents of the screen to the printer. If
the printer is off-line, you will hear a bell ring.
This does not print a bit-map of the screen, but
rather the actual letters. Bold is emphasized (bold),
and blinking is italicized. Drop-down menus will not
be printed even if they are down when F6 is pressed.
F7 Capture screen contents to the buffer
F8 or Alt-H Causes the modem to drop carrier.
F10 Inserts a one second pause into an editing field.
Alt-D Download Alt-U Upload
Alt-C Capture Alt-T Send Buffer
Alt-S Suspend Send Alt-Y Type-ahead
Alt-V Edit Buffer UNDO Quit ANSITERM
Alt-M Edit Global Macros HELP (see Type Ahead buffer)
Clr/Home Clears the Type-Ahead Buffer
COLR menu
There are 4 selectable color palettes. Palette #1 is the default,
unless you save the dialer file while another palette is enabled.
Other
A yellow "C" on a red background will appear in the upper right corner
if CAPS LOCK is on.
Acknowledgments
I would like to thank the following people for testing ANSITerm
for me:
Sean Dougherty (another member of Two Worlds Software)
B.J. McKinney (SysOp of The Flea Infested BBS -- (813)989-8564)
Clifton Mothershed
Conan Ford (In Canada!)
And we can't forget plaudits to Alan Hamilton for his XYZ file
transfer utility. Be sure to register this too!
The official TWS support BBS
Excalibur II BBS -- (813)988-2603
SysOp: Aaron Oneal