home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / files / 2518.dms / 2518.adf / WorkBenchHacks / QuickLens.Doc < prev    next >
Text File  |  1987-08-27  |  4KB  |  89 lines
  1.                                                                             
  2. QUICKLENS v2.02  
  3. by Mike Berro/BCS Software  27 Jun 88
  4.  
  5. QuickLens is based on "Lens" by Ned Konz.  Thanks to Larry Phillips,
  6. Keith Young, and the rest of the gang on CompuServe's AmigaForum for
  7. their invaluable insistence, er, assistance.  This version is still
  8. experimental: see "Danger! Danger!" below.
  9.  
  10. I wrote QuickLens primarily because Keith Young (of Access! fame) wanted
  11. a quick zoom routine.  QuickLens is 100% assembly language.  You will not
  12. notice any appreciable speed difference (with the default-sized window) 
  13. between normal and x4 magnification, and x2 is only slightly slower
  14. (for various arcane reasons).
  15.  
  16. QuickLens does not use much CPU time (especially when the window is small).
  17. The window is updated constantly when the mouse is in motion, and 3 times
  18. a second when the mouse is still.  The window does not need to be active.
  19.  
  20. To change magnification, the window must be active.  To activate the window,
  21. click the left mouse button when the pointer is within the window.  Click
  22. the right button to go from normal, to x2, to x4, and back to normal.
  23.  
  24. QuickLens starts up in normal magnification.  From CLI, you can type
  25. "QLens 2" or "QLens 4" to start in x2 or x4 magnification (not
  26. implemented on v1.01).
  27.  
  28. The window can still be sized even though the sizing gadget is invisible
  29. (I hate wasted visual space).  Just grab where the size gadget should be
  30. (lower right corner of the window).
  31.  
  32. Click the left button on the close gadget in the upper left corner to
  33. exit, or press ESC on the keyboard when the QLens window is active.
  34.  
  35. Moving QLens to Another Screen
  36. ------------------------------
  37. To send QLens to another screen, press the BACKSPACE key (the QLens window
  38. must be active).  This sends the QLens window to the screen just behind
  39. the screen it's currently on, and then sends the current screen to the
  40. back of all screens, thereby exposing the screen which now contains the
  41. Qlens window.  By pressing BACKSPACE you can therefore display every
  42. available screen.  There is no effect if there is no screen behind the
  43. current one.
  44.  
  45. Press W (again the QLens window must be active) to send the QLens window
  46. directly to the Workbench screen.  Nothing will happen if the Workbench
  47. screen doesn't exist.  This does not bring the Workbench screen to the front.
  48. Use this (or exit Qlens) before you make the current screen go away; see
  49. the next paragraph.  
  50.  
  51. Qlens v2.02 will attempt to vacate the screen it is on if that screen is
  52. being closed.  It will move to the screen immediately behind the current
  53. one.  However, beware of Danger.
  54.  
  55. Danger! Danger!
  56. ---------------
  57. Note that sending the QLens window to other screens is dangerous! (i.e.
  58. not fully supported by the Amiga operating system).  The QLens window
  59. must be able to vacate the screen before the screen is closed.  QLens
  60. intercepts the system call to CloseScreen() to do this.  If another
  61. program is also intercepting this system call, this could cause problems
  62. after QLens or the other program exits.  If this is a problem, use v2.01
  63. and then manually get rid of the QLens window before closing the screen.
  64.  
  65. In addition, you may notice strange effects on some screens.  If the screen
  66. is overscan, the mouse pointer may be offset from it's 'real' position.
  67. The screen colors may also make the QLens window invisible. That's
  68. why I allowed you to quit by pressing "Q".  In any case, it does work nicely
  69. on the Access! screen.
  70.  
  71. Technical Note:
  72. ---------------
  73. QuickLens does use a fair amount of CHIP memory, especially if the window
  74. is large.  It is a SIMPLE_REFRESH window, but an additional bitmap of
  75. approximately window size is used to speed up the magnification.  QuickLens
  76. would also be faster if it did not have to worry about overlapping
  77. windows.  As it is, it is (theoretically) well-behaved.
  78.  
  79. If you find this program useful, or if you can suggest improvements,
  80. please drop me a line and let me know.  Don't send me money.
  81. Perhaps it might be useful for the vision impaired on programs that
  82. don't let you specify a large font.  I'd like to hear about that.
  83.  
  84. Mike Berro/BCS Software
  85. 13432 Lochrin Lane
  86. Sylmar, CA  91342
  87. CompuServe: 73267,3361
  88. 1939 BBS: (818) 368-4248 (A great BBS for video & graphics)
  89.