DISPANG - Display Angles sent to RotorDRV
=========================================

Revised 2/16/93 PTW
Revised 3/01/02 PTW (contact info only)

Copyright 1990 Paul Williamson.  All rights reserved.

You may use this program for non-commercial purposes.  Licensed users
of InstantTrack may use this program under the same conditions as the
InstantTrack programs.  Unlicensed users of InstantTrack should
repent and send money to AMSAT-NA, AMSAT-UK, or AMSAT-Australia for a
licensed copy.



DISPANG is a TSR utility that continuously displays the angles being
sent to the Rotor Driver.  This is useful if you're using OrbitDRV to
multitask antenna pointing and some other application, say terminal
emulation.  It allows you to monitor the antenna angles without being
in InstantTrack or constantly popping up the KCT popup utility.

The antenna angles are displayed in the upper right corner of the
screen.  They will be displayed there whenever antenna angles are
sent to the Rotor Driver.  With OrbitDRV, they will be displayed
every two seconds.  If some other program is also displaying
information in that area, the display may flash back and forth
between the antenna angles and the other program's display.  Most
programs don't use the upper right corner of the display for "live"
info, so this should be satisfactory in most cases.

For reasons of compatibility, DISPANG has one major limitation:

	The values are NOT VISIBLE in GRAPHICS mode.


There are two versions of DISPANG.  DISPANG.COM is used on color
display adapters (CGA, EGA, VGA) regardless of the type of monitor
attached.  DISPANGM.COM is used on monochrome display adapters (MDA,
Hercules).  If you use the wrong version, the angles will not be
visible.  If you have both kinds of display adapter, you can use
either version.  The angles will be displayed on the monitor
corresponding to the version you used.

DISPANG must be installed BETWEEN the Rotor Driver and OrbitDRV.
To install DISPANG, just run it after running the Rotor Driver and
before running OrbitDRV.  For example, suppose you have the Kansas City
Tracker.  Your AUTOEXEC.BAT file might already contain the following
sequence of commands:

	drv /tt=0 /ma=0		       <--this loads RotorDRV
	osc /hot=$18		       <--this loads the KCT popup
	orbitdrv		       <--this loads OrbitDRV

To use DISPANG, change this as follows:

	drv /tt=0 /ma=0		       <--this loads RotorDRV
	osc /hot=$18		       <--this loads the KCT popup
	dispang                        <==this loads DISPANG
	orbitdrv		       <--this loads OrbitDRV



If you aren't using the default interrupt vector (63 hex, 99 decimal)
for the Rotor Driver and OrbitDRV, you will have to add a command
line argument to DISPANG.  This argument specifies the vector you
wish to use in DECIMAL.  For example, if you now use

	orbitdrv 64

you should use

	dispang 100
	orbitdrv 64

because 100 decimal is the same as 64 hex.  Yes, I know I should make
them consistent, but this is just a quick hack.



Credit and Blame
================
I am always interested in comments and bug reports.  However, this is
just a hobby for me.  I can't promise to provide any support, and
this software is provided with absolutely NO WARRANTY.

I can be reached via email:
	                kb5mu@amsat.org

---------------------------------------------------------------------

For more information on InstantTrack, see
http://www.amsat.org/amsat/instanttrack/