home *** CD-ROM | disk | FTP | other *** search
/ swCHIP 1991 January / swCHIP_95-1.bin / desktop / lens / lens.txt < prev   
Text File  |  1995-12-09  |  12KB  |  356 lines
  1. Lens 2.02: A Windows Magnifier, by Ned Konz, December 1994
  2.  
  3. This file is mostly the same as the Windows help file (LENS.HLP)
  4. that comes with LENS, except for the part about installing Lens.
  5. You might like to install Lens and look at the help file instead.
  6.  
  7.  
  8. Installing Lens
  9.  
  10. Lens 2.02 comes as a PKUNZIP 2.04g ZIP file. Prior versions were
  11. distributed as self-extracting archives, but the norm seems to be
  12. the .ZIP format.
  13.  
  14. To install Lens, you
  15. should go to the MS-DOS prompt, change to the directory in which you
  16. want to install Lens (or make a directory for Lens first), and run the
  17. PKUNZIP.EXE program from that directory.
  18.  
  19. For instance, if you want to install Lens to your existing directory
  20. called C:\UTILS, and you had LENS202.ZIP in a directory called
  21. C:\DOWNLOAD, you could do the following:
  22.  
  23.     c:
  24.     cd \utils
  25.     pkunzip \download\lens202
  26.  
  27. Alternatively, you could do this:
  28.  
  29.     pkunzip c:\download\lens202 c:\utils
  30.  
  31. About Lens
  32.  
  33. Lens normally magnifies an area of the screen around the mouse pointer.
  34. It can alternately try to track the caret (the "text cursor") in text
  35. applications, if you enable Track Caret mode, or it can display a
  36. magnified fixed area of the screen, if you choose Freeze Location mode
  37.  
  38. This is a Windows version of an Amiga program I wrote in 1985.  First
  39. written in 1991, it has been updated through the years, thanks to your
  40. support.  It was written in C++, and compiled using Borland's compiler.
  41. I have also produced a version of Lens for the OS/2 2.x Workplace Shell.
  42.  
  43. Lens for Windows, version 2.00 (this version) adds many features,
  44. bringing the Windows version up to the level of the OS/2 version.
  45.  
  46. If you feel this program has value to you, I'd really appreciate a
  47. payment of $5.00 US sent to me at:
  48.  
  49.     Ned Konz
  50.     810 21st Avenue North
  51.     St. Petersburg FL 33704
  52.     USA
  53.  
  54. I can be reached on the Internet as nedkonz@gate.net or on Compuserve
  55. as 76046,223  .
  56.  
  57. About the Author
  58.  
  59. I've been working with microcomputers since around 1975 (that is, as
  60. long as there have been microcomputers).  I helped build an Altair,
  61. helped start the first computer store in Tampa FL, and started the first
  62. computer store in Daytona Beach FL.
  63.  
  64. I got into software by bootstrapping myself from being an electronics
  65. technician, through doing electronics design, and then into programming.
  66.  
  67. I found that I didn't get solder burns as much while programming.
  68.  
  69. My experience includes a fair amount of embedded systems work, robotics,
  70. and data communications, also publishing, text processing, and
  71. typesetting.  I've programmed in several assemblers, C, C++, and a
  72. variety of little languages and tool-specific languages.
  73.  
  74. So far, I've avoided writing database or business software (and hope to
  75. keep it that way), except for a particularly dreadful 3-month stint
  76. doing magazine subscription fulfullment using Informix.
  77.  
  78. Currently I'm working in C++, because it seems to be the best
  79. general-purpose language around for the kind of work I'm doing (embedded
  80. systems for robotics and process control).
  81.  
  82. In real life, I enjoy diving, making beer, cooking, motorcycling, and
  83. bicycling (I rode my bicycle across the US from Florida to Oregon in
  84. 1985).
  85.  
  86. Why do I write shareware/freeware?  I enjoy the feedback I get from
  87. people who use my programs.  In the case of Lens, many regular users are
  88. vision-impaired, and Lens makes it easier for them to use their
  89. computers.  It's nice to know that something I found useful or
  90. interesting is also useful or interesting to someone else.
  91.  
  92. Other shareware/freeware programs I've written (on a fine BBS near you):
  93.  
  94. * INTERCEPT (1985)(DOS) -- intercept and report on interrupt/DOS calls
  95.   made by an application 
  96.  
  97. * LENS (1985)(Amiga)
  98.  
  99. * SCREENDUMP (1985)(Amiga) -- dump graphics screen to printer
  100.  
  101. * SWAPDCP (1993)(OS/2) -- allows editing of KEYBOARD.DCP file
  102.  
  103. * LENS (1993)(OS/2) -- OS/2 PM version of LENS
  104.  
  105. Let me hear what you think about Lens, even if you don't send any
  106. money...  I rely on user feedback to improve my programs, and would like
  107. to get yours.
  108.  
  109.  
  110. Always on Top mode
  111.  
  112. Lens can be made to always stay on top of all other windows, even if it
  113. doesn't have the focus.
  114.  
  115. To do this, select "Always on top" from the Settings menu, or use the
  116. 't' key.
  117.  
  118.  
  119. Changing Magnification
  120.  
  121. The magnification may be changed with the Zoom In (+) and Zoom Out (-)
  122. menu choices.  The available range is from 1X to 40X.
  123.  
  124. The magnification can also be changed using the '+' or '=' key to
  125. increase magnification, or the '-' key to decrease it.
  126.  
  127. The .INI file entry "magnification" sets the initial magnification.  See
  128. Saving Settings.
  129.  
  130.  
  131. Display Cursor mode
  132.  
  133. Lens can display the location of the mouse cursor, using a cross to
  134. indicate the location.  You can select whether or not you want to
  135. display the cursor location, using the "Display cursor" Settings menu
  136. choice, or the 'c' key.
  137.  
  138.  
  139. Expert mode
  140.  
  141. By default, Lens prompts you with a message box every time you try to
  142. change a setting.  To turn off this behavior, select "Expert mode" from
  143. the Settings menu, or use the 'x' key.
  144.  
  145. If you select Expert mode, Lens will quietly change its settings when
  146. commanded.
  147.  
  148.  
  149. Freeze Location mode
  150.  
  151. If you choose "Freeze Location" from the Settings menu, (or type the 'f'
  152. key), Lens will change its cursor into a magnifying glass, and wait for
  153. you to position the cursor over an area on the screen and click the left
  154. mouse button.
  155.  
  156. Until you disable this mode, Lens will then continue to magnify the area
  157. you clicked on.  If you have Repeat mode enabled, any changes to that
  158. area of the screen will be represented in the Lens window as they
  159. happen.
  160.  
  161.  
  162. Hiding the Menu Bar
  163.  
  164. You may choose to display or hide the Lens menu bar.
  165.  
  166. By default, the menu bar is displayed, but you can change this setting
  167. using the Settings menu choice "Display menu bar", or by using the 'b'
  168. key.
  169.  
  170. If you have the menu bar turned off, you can still use the System menu
  171. to change the settings: if you have the title bar displayed, just click
  172. on the upper-left hand corner of the Lens title bar, and the System menu
  173. will pop down.  If you don't have the title bar displayed, you can use
  174. the Alt-Space key combination to pop the System menu down.
  175.  
  176. If you have the title bar turned off, the menu bar is no longer
  177. displayed.
  178.  
  179.  
  180. Hiding the Title Bar
  181.  
  182. Lens can be made to hide its title bar (the bar at the top of the window
  183. that includes the system menu/close button, the title of the program,
  184. and the minimize and maximize buttons).
  185.  
  186. This can be done either by selecting "Hide Title Bar" from the Settings
  187. menu (or the system menu), or by double-clicking on the Lens window.
  188.  
  189. You can re-display the title bar (and menu bar, if it was enabled) by
  190. double-clicking again on the Lens window.
  191.  
  192. If you do this, you can still drag the Lens window around using the
  193. mouse.
  194.  
  195. You can also use the System menu to make settings changes, by using the
  196. Alt-Space keystroke combination to pop the System menu down.
  197.  
  198.  
  199. Keyboard shortcuts
  200.  
  201. KEY     ACTION
  202. t    Always on top mode (toggle)
  203. +, =    Increase magnification
  204. -    Decrease magnification
  205. r    Repeat mode (toggle)
  206. k    Track caret mode (toggle)
  207. a    About Lens
  208. v    Save Lens settings (see Saving settings)
  209. b    Hide the menu bar (see Hiding the menu bar) (toggle)
  210. F1    Lens Help (this file)
  211. x    Expert mode (toggle)
  212. c    Display Cursor mode (toggle)
  213. f    Freeze Location mode (toggle)
  214. Alt-Space    Display the System menu
  215.  
  216.  
  217. Release Notes
  218.  
  219. * Version 2.02, 17 December 1994
  220.  
  221. Changed mail and Internet addresses.
  222.  
  223. * Version 2.01, 15 October 1994
  224.  
  225. Bug fix version:
  226.  
  227. * Re-compiled to work on 80286 processors as well as '386 and higher.
  228. * Fixed bug where save when iconized resulted in bad restart.
  229.  
  230. * Version 2.00, 7 May 1994
  231.  
  232. Added enough new features to warrant a new major version number!
  233.  
  234. * Finally fixed 256-color StretchBlt palette bug
  235. * Real Windows help file
  236. * Freeze Location mode
  237. * Always-on-top mode
  238. * Hide title bar feature
  239. * Display cursor position feature
  240. * Changed postal address
  241.  
  242. * Version 1.04, 4 July 1993
  243.  
  244. * Changed layout of "Usage" message box for better display on NEC
  245.   640x400 displays for Japanese users.
  246. * Added explanatory text about StretchBlt bug.
  247. * Removed BIX email address.
  248.  
  249. * Version 1.03, 8 August 1992
  250.  
  251. My first bug report!  Fixed bug where repeat mode was never saved.  Also
  252. made it so that changing magnification from the keyboard using the + and
  253. - keys would cause a window repaint.  So now you can leave your mouse
  254. alone and use the + and - keys to get the magnification you want.
  255.  
  256. * Version 1.02, June 1992
  257.  
  258. Changed text of About box.
  259.  
  260.  
  261. Repeat Mode
  262.  
  263. Repeat mode continues to magnify even if the cursor has not moved.  This
  264. mode should be set if you wish to magnify contents of a window which is
  265. changing on its own without the mouse or the caret being moved, for
  266. example when magnifying animation.  This mode may be a resource hog and
  267. slow down your system if the timerInterval setting is too short (see
  268. Saving Settings).
  269.  
  270. Repeat mode may be turned on or off using the menus, or by using the 'r'
  271. key (see Keyboard shortcuts).
  272.  
  273.  
  274.  
  275. Saving Settings
  276.  
  277. Lens saves its settings in its initialization file when you choose "Save
  278. Settings!", or use the 'v' key.  This initialization file may be named
  279. as a command line parameter to Lens (see Starting Lens), otherwise it
  280. will default to "", in your Windows directory.
  281.  
  282. The "timerInterval" setting in this initialization file sets the minimum
  283. time between magnifications (in mSec).  Setting it too low, especially
  284. with repeat mode ON, will cause your system to slow down.  The default
  285. setting for the timer interval is 200 msec (1/5 second).
  286.  
  287. A default  (for VGA) file follows (with comments)
  288.  
  289. [Lens]
  290. ; top, left, right, and bottom are
  291. ; the initial position of the lens window.
  292. ; These default to 0, 0, screenwidth/2, and screenheight/2.
  293. top=0
  294. left=0
  295. right=320
  296. bottom=240
  297. ; this is the initial magnification (1-20)
  298. magnification=2
  299. ; repeatMode and trackCaret are either 1 or 0.
  300. repeatMode=0
  301. trackCaret=0
  302. ; timerInterval sets the minimum time
  303. ; between magnifications.
  304. ; It defaults to 200 mSec (1/5 second)
  305. timerInterval=200
  306. ; Setting displayMenuBar to 0 inhibits
  307. ; the display of the menu bar in the Lens window.
  308. displayMenuBar=1
  309. ; setting displayTitleBar to 0 makes the window
  310. ; appear without any title bar or menu bar.
  311. displayTitleBar=1
  312. ; setting alwaysOnTop to 1 makes the Lens window
  313. ; always appear on top of other windows,
  314. ; even if it is not the active window.
  315. alwaysOnTop=0
  316.  
  317.  
  318.  
  319. Starting Lens
  320.  
  321. Lens may be started from its own icon like any other Windows program.
  322.  
  323. If you want to use a specific initialization file (see Saving settings),
  324. name this file in the Command Line entry for the program Properties in
  325. Program Manager.
  326.  
  327. For instance, if you wanted to run Lens from the C:\ectory, and use an
  328. initialization file in that directory, you would use a command line of:
  329.  
  330. C:\LENS.EXE C:\LENS.INI
  331.  
  332. in the Program Properties settings.
  333.  
  334. By naming specific initialization files, you can have multiple Lens
  335. windows, each with their own different settings.
  336.  
  337.  
  338. Track Caret Mode
  339.  
  340. Lens can be told to try to track the caret (the "text cursor") in some
  341. text applications.  To do this, enable Track Caret mode using the menus
  342. or the 'k' key on the keyboard (see Keyboard shortcuts).  You can try
  343. Track Caret mode with Notepad.  It also works with the Borland C++
  344. integrated development environment.
  345.  
  346. This mode does not work with all applications.  It will not work, for
  347. instance, with Word for Windows, which doesn't use the built-in Windows
  348. calls for displaying and moving the caret.  Also, since it is impossible
  349. for Lens to tell whether the caret is actually being displayed, this
  350. setting may cause a lack of Lens motion when a non-text program is
  351. active.
  352.  
  353. Lens will track the mouse cursor if the caret position in the active
  354. window is at the upper left hand corner (0,0), otherwise it will track
  355. the caret.
  356.