Tools Disk 2 (Sep 1991) : MouseXY / Mouse-xy.doc

                             //
                         \\ // Mouse-xy V1.1
                          \//

                               1991
                                by
                          Preben Nielsen



WHAT'S NEW SINCE V1.0 ?

    Version 1.0 worked well with kickstart 1.2 and was usable with
  2.x, but it failed miserably when run under kickstart 1.3. The reason
  was that the program thought it was running under 2.x. This version
  works perfectly with any of the kickstart versions mentioned above.



WHAT IS MOUSE-XY ?

    Mouse-xy is a small utility that opens a small window in
  which it shows the mouse coordinates and the color at that position.

    If the left mousebutton is being held down, the coordinates is
  relative to the spot where the mouse was, when the button got pressed.

    It will disable the color-function if you move the mouse-pointer out
  of the screen on which the window is open.

    Double-clicking the right mousebutton while the window is active
  will make it try to jump to another screen. If nothing happens, then
  it is because there is either no other screen at all or no other screen
  big enough to open on.

    The coordinates can still be monitored while you are moving/re-sizing
  a window or moving workbench-icons !!. Normally this is impossible because
  intuition freezes all layers on the screen by calling 'LockLayers'. But I
  accomplished it by disabling any call that the graphics functions make to
  'LockLayerRom' and 'UnlockLayerRom' with this windows layer.



HOW TO START MOUSE-XY

    From CLI      : Type 'Mouse-xy' and press RETURN.
                    There is NO need to use RUN, RUNBACK, ARUN etc.
                    Mouse-xy is auto-detaching when run from CLI (It
                    will not prevent you from closing the CLI-window).

    From Workbench: Double-click on the 'Mouse-xy' icon.



SPECIAL FEATURES !

    The size of the window and the use of colors in it depends on
  the version of the Kickstart/Workbench (1.2/1.3 vs. 2.x). and the
  screen mode (LORES vs. HIRES).

    The window will automatically try to evacuate any closing screen
  and open up on another screen. If there is no other screen on which
  Mouse-xy can open its window, then it will try to terminate itself.

    It will NOT always be possible to end Mouse-xy. Mouse-xy 'patches' a few
  library-functions and it will therefore not be able to terminate properly
  if another program has 'patched' one or more of the same functions WHILE
  Mouse-xy is running. In such cases Mouse-xy will show you a requester telling
  you that it is impossible to exit, and continue to run. It will continue to
  be impossible to remove Mouse-xy until you have removed the program(s) that
  'patches' the same library-functions as Mouse-xy. The functions that Mouse-xy
  'patches' are:

	'LockLayerRom'   in 'graphics.library'
	'UnlockLayerRom' in 'graphics.library'
	'CloseScreen'    in 'intuition.library'


NOTE: If you are running some programs that patches the same library-functions,
      then it is ALWAYS safest to terminate these programs in reverse order
      (terminate the most currently started program first and so on). Not every
      program is as gentle as Mouse-xy V1.1 when it comes to removing 'patch'
      functions (Mouse-xy V1.0 wasn't).



COMPATABILITY !

    Mouse-xy has been tested under kickstart 1.2, 1.3 and 2.x on a
  2.5 MB 68000 based Amiga 1000 (0.5 MB chip-ram). Let me know if
  any problems is encountered with other configurations.



COPYRIGHT NOTICE !!

  Mouse-xy is Public Domain.



=====================================================================
   Send bug-reports, suggestions, comments etc. to:

        ///
       ///  Preben Nielsen
 \\\  ///  Oehlenschlægersgade 72 st. T.V.
  \\\///  1663 Copenhagen V.
   \///  Denmark
	Phone: (009 45) 31 21 55 09