 Amiga Distribution System-- Long Description File
 
           ADS Zone: 1
     ADS Hatch Site: Don Plesky
       ADS Position: ADS Zone 1 Coordinator
           BBS Name: EastPointe Amiga BBS
    Phone Number(s): 810-773-6959
    Network Address: 1:120/229  
     Network Region: 11    
          BBS Hours: 24 Hrs/Day
BBS Mailer/Software: DLG Trapdoor/PDQmail
  BBS Storage Space: 2 Gig 
  File Requestable :  <X> Y     < > N
File Request Hours : All The Time

==========================================
            Long Description
==========================================

Short:    Eyes on screen titlebars watch your pointer.
Author:   johughes@heartland.bradley.edu  (John Hughes)
Uploader: johughes@heartland.bradley.edu  (John Hughes)
Type:     util/wb

Statistics:

  Program:        PointerEyes
  Version:        3.6
  Date:           April 23, 1995
  Coded by:       John Hughes
  Email:          johughes@heartland.bradley.edu
  WWW:            http://rhf.bradley.edu/~jhughes/
  Compiled with:  SAS/C 6.55
  Machine:        A4000 68EC030/25  AmigaDOS 3.1
  Required:       AmigaDOS 2.04 or above
                  screennotify.library 1.0 (included)
                  AmigaDOS 3.0+ is recommended
                  MagicWB is also recommended

 Features:

  o All settings are saved and loaded from the icon tooltypes.
  o The background color and eye color are automatic allowing it to look
    as though the eyes are attached to the screen's title bar or you
    can choose it's colors.
  o The eyes can be auto-centered on the title bar or be located
    anywhere on the screen.
  o There are two eye sizes.  You may choose between the two or let the
    program determine which best fits your public screen title bar.  The
    larger eyes were designed to be used with 11 point fonts.
  o You can choose the public screen in which Pointer Eyes appears on.
  o If the mouse isn't moved for a while, the eyes will go to sleep, and
     periodicaly peek out at you.
  o The eyes will blink at random intervals.
  o The eyes are rolled periodically.
  o Monitors the system preferences files, allowing the WB screen to be
    closed/reopened if system preferences are changed.
  o You can lock the window in place so you don't accidentlly grab it.
  o The eyes can stay behind, in front of all windows, or just float.
  o The eyes can follow you around to the front most or active
    public screen.
  o Low task priority of -2, so it doesn't get in the way of other tasks.
  o Small code.



History Since Public Release 3.1:
-----------------------------------------

v3.1 October 28, 1994

     Separated MUI preferences into a seperate executable.
     Prefs progam can run "in-sync" with PointerEyes program.
       When you select a gadget, the Eyes are immediately altered.
     Added menus to PointerEyes program.
     You can now select any pen # for the colors.  This has
       slowed jumping from screen to screen Because of 8 planes. :(
     Eyes can now move independently from the other.  This was
       requested by many people, however I don't like it, so it
       isn't the default.  :)
     Added tooltype INDEPENDENTEYES.
     Online menu help is available.  Press the HELP key when
       highlighting a menu item.
     It is now a Commodity.
     This version was not released. :(

v3.2 February 1, 1995

     Lost source code to seperate MUI preferences file.   :(
     Monitor the PointerEyes icon for tooltype changes.
       Changes will take place when the icon is saved.
     Preferences menu now loads the icon information for Dos 3.0+ users.
     Bug Fix: Sometimes the window was not centered properly.
     Fixed possible lockup when moving window and it wasn't centered properly.
     Now locks IntuitionBase when looking at its structure.
     This version was also not publicly released.

v3.3 March 6, 1995

     I now use Wait() for all signals instead of SetSignals(). This should
       reduce CPU usage at times.
     Because I use Wait(), the timer.device is now used instead of Delay().
     Commented out the source code for the message port which was used for
       the external preferences program which is no longer in existance.
     Bug Fix:  Window was not being centered properly when the eye size changed.
     Bug Fix:  When the eyes jump from screen to screen, AUTOEYESIZE is not
               active, and DONTCENTERINTITLEBAR is active, the window is now
               placed at the same coordinates they were at on the previous
               screen.
     Bug Fix:  It was impossible to drag WB icons when there was more that one
               PointerEyes program running.  This is because each eyes window
               was constantly calling WindowToBack() to be in the back all of
               the time.  This problem still occurs when the user has the eyes
               stay in the foreground though.
     Added tooltype MICROSECUPDATE.
     No longer locks IntuitionBase when looking at its structure, since we just
       look at the frontmost or active screen.
     Bug Fix:  Hotkey now toggles whether or not the eyes are displayed.
               Bug found by Simon Stelling.
     Removed AUTOEYESIZE tooltype, and added AUTO as a value for the
       EYESIZE tooltype.

v3.4 March 26, 1995

     Eyes now blink when you activate the Eyes window.  Suggested by Martin Axelsson
     Removed AUTOBACKPEN and AUTOEYEPEN tooltypes, and added AUTO as a value for
       the BACKPEN and EYEPEN @{" tooltypes " Link "TOOLTYPES"}.
     Bug Fix:  Tried closing window when the window was already closed when the
               user selected Inactive in the Commodities Exchange program.
               Found by Simon Stelling
     Bug Fix:  The Eyes window was being blanked out when a menu item was
               selected.

v3.5 April 9, 1995

     Bug Fix:  The eyes no longer flicker when the user de/activates the window.
     Removed a stray Delay() that should have already been removed. Therefore I
       set the default Microseconds up to 70000.
     Now uses screennotify.library.  I have neglected to patch any of the system
       functions intentionally all this time.  But screennotify.library seems to
       be relatively stable, and it isn't my fault if it crashes :)  I guess that
       is my justification for using it. :/
     Removed env: notification, since it now uses screennotify.library.
     Bug Fix:  Crashed the computer when 'Inactive' was selected from the Commodities
       Exchange program.  I actually accidentally fixed the bug.
     Bug Fix:  Wouldn't work from CLI.
     Can now be run from CLI and the tooltypes can be used as arguments.
       For example:   dh0:> PointerEyes XCOORD=450 EYESIZE=AUTO
     Removed the CENTERINTITLE tooltype, and added CENTERINTITLE as a value
       for the YCOORD @{" tooltype " Link "TOOLTYPES"}.

v3.6 April 23, 1995

     A requester will now appear if screennotify.library isn't found.
     Bug Fix:  Removed enforcer hits when checking to see if the window is in the back.
     Bug Fix:  YCOORD=6 wouldn't place the eyes on line 6, they would always be centered.
               This is now fixed so the eyes will appear at whereever the line # is.
               Bug found by Simon Stelling.
     Fixed documentation mistake.  The default microseconds is 70000. Found by Simon Stelling.
     Bug Fix:  If the eyes are set to stay on one screen only, they now will open on the
               WB screen when their screen closes, or they will wait for the WB screen to open.
               Bug found by Simon Stelling.
