Readme.txt file for ZZHOT Standard Edition DEMO

ZZHOT.VBX is a VB (2.0/3.0) custom control.  It is designed to do
one thing, to do it very well, and to be very easy to use.  This demo
version is fully functional but contains the demo splash screen.

MAJOR COMPONENTS:
1. zzhot.vbx
2. zzhoted.exe
3a. zzhdemo.exe   (Just run this to get an idea of what the vbx does.)
3b. Demo source code  (Look at this to see proper usage examples.)
4. zzhot.hlp  (Note: it is context sensitive for both props and events
              while working in VB.  Just hit the F1 key.)

OVERVIEW:

The purpose of ZZHOT is to provide a very easy, fast, and reliable
means for the VB developer to implement arbitrary, polygonal hot spot
regions in their VB program.  There are a wide range of applications.

Important note: zzhot.vbx uses just about zero resources, no matter how
many regions you define!

USAGE MODEL:

0. Read the Help file.
1. Use zzhoted.exe to define hot spot regions for a given picture.
2. In VB, drop a zzhot.vbx onto a picture (or other) control.
3. At runtime, set the HSFileName property to the .zhs file created
   by the hot spot editor.
4. Write your VB code in the ZZHOT.VBX mouse events.

INSTALLATION:

Simply run setup.exe.  The setup uses version information obtained
from ver.dll.  Older versions of DLLs and VBXs will be overwritten
without warning.  You should back up these older versions first
if this is a concern.  A list of files is in the bbsnote.txt file.

PROFESSIONAL VERSION:

This is a demo of the standard version.  The professional version 
will be available at a later date.  There will be many additional
features in the Pro version.  The most notable will be the ability
to define and/or change hot spot regions at runtime.  Hot spot
regions in the standard version are runtime static.

KNOWN PROBLEMS:

I. Demo Source Code:

* You may have to edit the zzhdemo.mak file to match your system.
* When you read in (into the editor) the euromap2.zhs file it will tell you it can't
  find the associated .bmp file.  Just read it in separately and then
  do a save.

II. Hot Spot Editor:

* Some XGA drivers it will not work with, particularly on IBM PS/2 machines.
* When in a drawmode, the cursor doesn't revert to an arrow when over
  the scroll bars.   (Bug in a commercial VBX used by editor.)
* It is not possible to get the picture box to exactly fit the bitmap 
  and have no scrollbars.  (Bug in a commercial VBX used by editor.)
* Always redraws all regions.  To be fixed in future release.
* Dragging complex regions is slow and jerky. 
* Some very complex regions are not always drawn.  This is a known problem
  with Windows 3.1. 

III.  ZZHOT.VBX:

* As of this writing, there is only one known bug in the vbx.  It is a bit
  obscure, but can be reproduced as follows:
	1. Set HiLiteMode to 2 (on mouse over)
	2. Mouse over a hot region, push left mouse button down, hold it down.
	3. Drag cursor completely off the form.
	4. Release mouse button.
	5. In code (eg. mouse up), change the OutlineMode to 0 or 1.
	6. The previous region stays hilited.
  STATUS- This is a confirmed bug and will be fixed in the next release.

* Consult the Help file for tips, warnings, etc.

* Note: if you ever get an "Out of Memory" message from VB when trying
  to use the VBX, you are (99.9% of the time) NOT out of memory.  You're
  just trying to use it wrong.  See the Help file for more info.

IV. Misc:

* SSI Logo (3 rings) doesn't look good on 16 color systems.  I just gave up trying.

* In the Demo, the textbox is editable and shouldn't be.

OBSCURE PROBLEM REPORTS:

In the course of extensive testing, problem reports come in that
we are not able to duplicate.  Below are a list of such.  Almost
all of these were only ever seen by a single tester and nobody 
else has been able to duplicate them.


I. Hot Spot Editor:

* One non-reproducable report of the editor becoming confused about
the selected region hatching after doing a "Size to Bitmap."

* One non-reproducable report of the editor asking if you want to 
unload the bitmap when there isn't one to unload.


OTHER TEXT FILES:

order.txt  contains information on ordering.

bbsnote.txt  contains info for bbs operators.

country.txt  is used by the demo program.  DO NOT MODIFY!

CONTACT INFORMATION:

Please feel free to send all comments, questions, etc. to me via email.
Also, if you have requests for features you would like to see in the
forthcoming Professional version of ZZHOT.

gat@csn.org.
