home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d543 / mousexy.lha / MouseXY / Mouse-xy.doc < prev    next >
Text File  |  1991-09-20  |  4KB  |  112 lines
  1.  
  2.                              //
  3.                          \\ // Mouse-xy V1.1
  4.                           \//
  5.  
  6.                                1991
  7.                                 by
  8.                           Preben Nielsen
  9.  
  10.  
  11.  
  12. WHAT'S NEW SINCE V1.0 ?
  13.  
  14.     Version 1.0 worked well with kickstart 1.2 and was usable with
  15.   2.x, but it failed miserably when run under kickstart 1.3. The reason
  16.   was that the program thought it was running under 2.x. This version
  17.   works perfectly with any of the kickstart versions mentioned above.
  18.  
  19.  
  20.  
  21. WHAT IS MOUSE-XY ?
  22.  
  23.     Mouse-xy is a small utility that opens a small window in
  24.   which it shows the mouse coordinates and the color at that position.
  25.  
  26.     If the left mousebutton is being held down, the coordinates is
  27.   relative to the spot where the mouse was, when the button got pressed.
  28.  
  29.     It will disable the color-function if you move the mouse-pointer out
  30.   of the screen on which the window is open.
  31.  
  32.     Double-clicking the right mousebutton while the window is active
  33.   will make it try to jump to another screen. If nothing happens, then
  34.   it is because there is either no other screen at all or no other screen
  35.   big enough to open on.
  36.  
  37.     The coordinates can still be monitored while you are moving/re-sizing
  38.   a window or moving workbench-icons !!. Normally this is impossible because
  39.   intuition freezes all layers on the screen by calling 'LockLayers'. But I
  40.   accomplished it by disabling any call that the graphics functions make to
  41.   'LockLayerRom' and 'UnlockLayerRom' with this windows layer.
  42.  
  43.  
  44.  
  45. HOW TO START MOUSE-XY
  46.  
  47.     From CLI      : Type 'Mouse-xy' and press RETURN.
  48.                     There is NO need to use RUN, RUNBACK, ARUN etc.
  49.                     Mouse-xy is auto-detaching when run from CLI (It
  50.                     will not prevent you from closing the CLI-window).
  51.  
  52.     From Workbench: Double-click on the 'Mouse-xy' icon.
  53.  
  54.  
  55.  
  56. SPECIAL FEATURES !
  57.  
  58.     The size of the window and the use of colors in it depends on
  59.   the version of the Kickstart/Workbench (1.2/1.3 vs. 2.x). and the
  60.   screen mode (LORES vs. HIRES).
  61.  
  62.     The window will automatically try to evacuate any closing screen
  63.   and open up on another screen. If there is no other screen on which
  64.   Mouse-xy can open its window, then it will try to terminate itself.
  65.  
  66.     It will NOT always be possible to end Mouse-xy. Mouse-xy 'patches' a few
  67.   library-functions and it will therefore not be able to terminate properly
  68.   if another program has 'patched' one or more of the same functions WHILE
  69.   Mouse-xy is running. In such cases Mouse-xy will show you a requester telling
  70.   you that it is impossible to exit, and continue to run. It will continue to
  71.   be impossible to remove Mouse-xy until you have removed the program(s) that
  72.   'patches' the same library-functions as Mouse-xy. The functions that Mouse-xy
  73.   'patches' are:
  74.  
  75.     'LockLayerRom'   in 'graphics.library'
  76.     'UnlockLayerRom' in 'graphics.library'
  77.     'CloseScreen'    in 'intuition.library'
  78.  
  79.  
  80. NOTE: If you are running some programs that patches the same library-functions,
  81.       then it is ALWAYS safest to terminate these programs in reverse order
  82.       (terminate the most currently started program first and so on). Not every
  83.       program is as gentle as Mouse-xy V1.1 when it comes to removing 'patch'
  84.       functions (Mouse-xy V1.0 wasn't).
  85.  
  86.  
  87.  
  88. COMPATABILITY !
  89.  
  90.     Mouse-xy has been tested under kickstart 1.2, 1.3 and 2.x on a
  91.   2.5 MB 68000 based Amiga 1000 (0.5 MB chip-ram). Let me know if
  92.   any problems is encountered with other configurations.
  93.  
  94.  
  95.  
  96. COPYRIGHT NOTICE !!
  97.  
  98.   Mouse-xy is Public Domain.
  99.  
  100.  
  101.  
  102. =====================================================================
  103.    Send bug-reports, suggestions, comments etc. to:
  104.  
  105.         ///
  106.        ///  Preben Nielsen
  107.  \\\  ///  Oehlenschlægersgade 72 st. T.V.
  108.   \\\///  1663 Copenhagen V.
  109.    \///  Denmark
  110.     Phone: (009 45) 31 21 55 09
  111.  
  112.