UFO Scanner
Version 1.3b
Date 19.02.1999
(c) 1998,1999 by Holger Schlegel. All Rights Reserved.


Content
=======

   1.1    Files
   1.2    Calling
   1.3    Aim
   1.4    Author

   2.1    New Friendly Codes
   2.2    Scan Message and VPA

   3.1    Known Bugs
   3.2    Version History


1.1 Files
=========

   This archive should contain the following files:

     UFOSCAN.EXE    Main program
     UFOSCANE.TXT   this file

   The main program (UFOSCAN.EXE) must be copied into the directory
   where HOST.EXE is located.


1.2 Calling
===========

   UFOSCAN <dir>

     <dir>     Path to host data


   This program should be called during auxhost2 execution after all
   other addons.

   The programm will store some informations in a data file named
   UFOSCAN.HST which is located in the host data directory.


1.3 Aim
=======

   Why did I write this program?
   In the games I play sometimes addons like Jumpgates or Asteroids
   are runing and these addons create UFO objects to show some data
   on the WinPlan starchart. Because I don't like the WinPlan interface
   and therefore play using DOS planets and VPA I'm unable to see these
   object because there are not included in the .RST files I receive
   from host. So I decided to write this programm to allow non-WinPlan
   players to 'see' the location of scanned UFO objects.
   I've added a feature to send default mine scan messages of all own
   minefields not scanned by ships to a player because for DOS planets
   players there are normaly not visible, too.

   If you have ideas or suggestions for new features, please inform
   me about it.


1.4 Author
==========

   Holger Schlegel
   Am Gardenkamp 51
   44227 Dortmund
   Germany
   eMail: holgerschlegel@gmx.de
   Internet: http://come.to/spocks


2.1 New Friendly Codes
======================

   There are only three new planetary friendly codes added by this programm:

     UF0 (last character is a null)
     UF1
     UF?

   Players can use that friendly codes to enable (UF1) or disable (UF0)
   the UFO scan messages. The friendly code UF? could be used to determine
   the current state of your UFO Scanner.
   The minefield scanner is enabled or disables using the same friendly
   codes. The default is off because all players that uses WinPlan don't
   need the messages.


2.2 Scan Message and VPA
========================

   Because of the format the UFO scan messages will have, you can use the
   following message template to create a marker on the VPA starchart for
   each scanned object.
       ; UFOScan Scanned UFO Object
       Message Marker
       Check   1,[UFO Scanner]
       Check   [Location:]
       X       [Location:],[Location:]
       Y       [Location:],[/]
       Keep    Flag 13
       End

   The messages for own minefields should be the same as the messages
   from host.


3.1 Known Bugs
==============

     none


3.2 Version History
===================

1.3b bugfix: ufo and minefieldscanning enabled again.

1.3a internal changes to prevent errors an to increase speed.

1.3  UFOScan now supports the PHost3 internal wraparound mode.
     bugfix: scanner state message corrected.

1.2a bugfix: minefield scanner used invalid message template.

1.2  UFOScan now supports up to 999 ships (Host999 support).

1.1e bugfix: error in memory management could cause runtime error 203.

1.1d new friendly code to check the scanner state.

1.1c bugfix: scanmessage now shows correct data.

1.1b host file access rewritten to prevent possible errors.

1.1a changed: now scannes only minefields not scanned by own ships.

1.1  new feature: now scannes all own minefields, too

1.0b bugfix: now checks correct friendly code to enable or disable scanner.

1.0a small changes in message handling to prevent possible errors

1.0  first version; UFO's are scanned, scanner can be switch on and off