UPDATE.TXT                                     23 Feb 1997

The information in this file is for users who are upgrading from 
WinOrbit 2.x to WinOrbit 3.1.  New users may ignore it.  

File & Directory Structure Changed
----------------------------------
Version 3.0 expects to find a more complex directory structure
than before.  The new directories will be created automatically
when you unzip the program, but you'll have to move your old
data files into the new directories yourself.  [This is optional, 
unless you want to keep your disk clean, or have made changes to 
the QTH database.]

Here's the new directory structure:
\WINORBIT         (or other directory of your choice)
   |              (.exe and .dll files)
   +---\DATABASE
   |   +---\SAT    (database.2li, *.att, *.skd)
   |   +---\QTH    (*.qth)
   +---\USERALGO   (can be deleted if not used)
   +---\KEPS       (new kep file downloads for auto-update)
   |   +---\MISC   (sample data files)

See the Files discussion in Help for more details.


Settings (INI) Files changed
----------------------------
The way information is stored in the settings files has changed.
Some of your 2.x settings will not be properly picked up.  Change
things manually, and then save the file again.  See the Settings 
Files topic in Help for new features


Multiple Satellites
-------------------
Formerly, each map had a principal satellite.  One of these could
be chosen for tracking (via the DDE server and the Info Window).
The chosen satellite was also available for plotting as a "second-
ary satellite" in each of the maps.
In 3.0, each map still has a principal satellite.  However, the
satellite chosen for the DDE server is now completely independent,
as are the satellites in the Table Window (new name for the Info
Window).  Multiple satellites may be chosen in the Table window,
and ALL of them now appear as "Secondary Satellites" in each of
the maps (if the secondary satellite option is selected for the 
map.)

Menus Changed
-------------
Lots of the menus have changed.  Check the Help file for
details.  In some cases, I changed the menu item text for
improved clarity, without changing the function.


Video Display Changed
---------------------
In an ongoing effort to fix the 16-bit (highcolor) video 
problem on some computers, I have changed the handling of
the graphics.  Please let me know if this fixes the problem
(if you had this problem previously).


C Header changed
----------------
If you have your own USERALGO.DLL file, you will need to 
recompile it with the new SATSTRUC.H header file.  The 
satellite identification strings have been changed to fixed-
length strings, which facilitates access from the DLL, but
also changes the alignment of elements in the struct.


Other Changes (from PROGRESS.TXT) in random order
---------------------------------
* Autorun now works correctly with screensavers and minimized
applications (be sure to put in key codes to restore your app if
necessary, such as "% {ENTER}")
* Autorun now logs all status messages to AUTORUN.LOG file, 
instead of message boxes on screen.  This makes troubleshooting
easier.  The file is automatically deleted at startup.
* adjust column width for lat, long formats in print ephemeris

* fixed mean motion update in SGP/SGP4 
* Orbital models for maps, printouts, and tables now independent.
* Fixed (-) altitudes in kep printouts.
* Warning displayed if map zoom will need > 1 Meg RAM.
* Added Alon/Alat and fractional solar illumination to table
and printout.

* "Context sensitive help" now in many windows.
* Hour angle, right ascension, and declination in table now
corrected for parallax.  Output to server, of hourangle and 
declination, is now enabled for polar mount systems in 
preparation for the Mars Relay Test.
* New "Exclusive Visibility" option in Print Ephemeris, to 
predict times when particular QRM should be absent.
* Changed the way the Main:Windows menu works for the Table,
Globe, and Report Windows.  No longer a toggle - just a 
command to show the window.
* Added reverse Az/El and Polar Mount outputs for Tracking
server (Options window).
* Fixed the "smearing" problem with the sun icon in 640x480
mode.
* Improved AutoRun by allowing [Task]Mode option.  Mode 0,
default, is as before - the task is identified by the window
title (possibly including a filename).  Mode 1 allows 
identification of task by Windows task number, regardless of
unpredictable changes in the window title.  This is useful if
you need the automatic filename generation (including the 
orbit number in the filename) but your program displays the
filename in the title bar.  [Formerly, this prevented WinOrbit
from interacting with the program after it started.]
* Added "copy map" to clipboard (Edit menu)
* Added "paste" function for user maps (edit menu).
* Added .wav file options in Autorun for "announcements".
see MIR.SKD for example.  Thanks to Bimal Ramdenee for the
idea.
* Fixed continuous update of globe.  Variable resolution
allows for significant speed increase (options menu).
* Improved generation of automatic (per orbit) filenames
for autorun
* added separate color choice for secondary satellites.


* Added a zoom feature in the options menu of the Map 
windows.  (Use the mouse to drag the map around inside
the window).
* Revised the Options window by grouping various items.
* Added satellite names on maps
* Data strip in map window turns red when sat is visible.
* Added a "dark sky" option in the globe window.
* Added a continuous update option for globe window. (still
needs a lot of work).
* Replaced the BitBlt with PaintDIB for drawing maps
   (hopefully to fix the 16-bit highcolor video bug).

* multiple cols in table window allowed
* "secondary sats" now come from table window - this
  permits multiple secondary sats on one map.
* added GRID.VBX to zip file
* Improved DDE server handling

* Simplified satellite choice menus
* DDE server, Info window, and maps are now independent
   (all maps can be deleted to conserve memory)

* Fixed a major bug in RA<-->Long conversion which was
   causing random errors of up to 1.5 degrees in 
   longitude and/or elevation.
* Fixed a bug in the Eclipse calculation routine.
* Epoch calculator added (convert JD and date format)
   (Calc menu and Database:Options menus)
* New, higher-resolution map (lots more islands!)
* Speeded up the "view from space" by almost 3x.
   (but it cannot be interrupted while drawing, yet)
* Fixed degrees-radians conversion bug for Alon/Alat
* Re-read .ATT and .SKD files after editing
* More Sat database changes:
  Autoupdate on startup now functional, requires:
    subdirectory DATABASE, containing DATABASE.2LI
    subdirectory KEPS, containing arbitrary two-line
       or amsat kep files.
    set [General] AutoUpdate=true in .INI file
  This will get easier in next release...
* More Database menu options in Sat window.
* Added "Beep" notification option on AutoRun (.SKD file,
   [General], "Beep=true"
* Changed Sat database handling preparatory to adding 
   automatic update option.  Satellite Window menu 
   "Database:Purge Duplicates" new option.  Default 
   database file is now DATABASE.2LI.  Docs to follow.
* Fix bug on QTH Database screen: clicking Grid square was
   resetting the lat & long to middle of the square.

