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