WBLoc
                                   -----
           Documentation for version 1.0, on January 17th, 1992

                              by Bruno Costa



WARNING

  Although  this  program  is freely distributable (see COPYRIGHT below), I
would  appreciate  if  you  take the time to write me a line or two (E-Mail
please)  if  you  are  using  any of my programs or if you have any kind of
ideas  or  suggestions  (This is not too much to ask, is it?).  If you feel
particularly  generous,  I  would  like  to  receive a disk with any useful
programs you have written, preferrably with source.  Thanks!


DESCRIPTION

  WBLoc  is  a small screen hack that displays a "locator" on the Workbench
screen,  made  up  by  a crosshair and a sprite with the coordinates of the
active  pixel.  It is meant to be used to measure pixel distances and sizes
of  images  in the WB screen.  Although it isn't the most useful utility in
the  world,  there  are  some  interesting  parts  of the source code worth
looking at.  It works both under WB 1.3 and WB 2.0.


OPTIONS

  usage: WBLoc     (no options)

  The  program may also be run from the Workbench by double clicking on the
provided  icon.   It  will open a small window on the Workbench screen, and
wait  until  its window becomes active.  Whenever the window is active, the
crosshair  will  be  drawn  on  the  Workbench  screen,  tracking the mouse
position, and the mouse pointer will be changed to something like:

            ------
            -> 999   = horizontal distance from left
            |
            V  999   = vertical distance from top
            ------

  If  you  activate another window, the locator will disappear, but WBLoc's
window  will remain there, until it is reactivated.  To remove the program,
activate the window and click the right mouse button.


BUGS

  WBLoc  locks  the  WB screen while the crosshair is being drawn, and this
may  be  a  source  of deadlocks, although in normal conditions no problems
have been detected.


AUTHOR

  The  accompanying  program  and  this documentation were written by Bruno
Costa.  He can be reached in the following ways:

  E-Mail: bruno@brlncc.bitnet (InterNet)
          bruno@BRLNCC        (BitNet)

  Mail:   Bruno Costa
          Rua Almirante Guilhem 454/102 bloco 1
          Leblon - Rio de Janeiro
          RJ 22440
          BRAZIL


COPYRIGHT

  This program is copyrighted by Bruno Costa.  It may be freely distributed
if  and  only if the source code, the documentation and the executables are
provided  in  original form.  It may be included in Public Domain/Shareware
compilations,  like  the  one  organized  by  Fred  Fish, as long as just a
nominal fee is charged for each disk (no more than US$10 per disk), and may
also be uploaded to BBS's or network services like BIX and CompuServe.


DISCLAIMER

  The author makes no warranty of any kind with respect to this product and
explicitly  disclaims  any implied warranties of merchantability or fitness
for  any  particular  purpose.