home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / b / blanke.zip / BLANKER.DOC next >
Text File  |  1993-02-04  |  10KB  |  209 lines
  1.  
  2. Documentation for BLANKER.EXE, a Shareware screen blanking utility.
  3.  
  4. Copyright (C) 1993 by David B. Donaldson, All Rights Reserved
  5.  
  6. Version 1.00, released January 14, 1993
  7.  
  8. BLANKER is a no-frills DOS "text" based TSR screen blanker designed for
  9. Monochrome, EGA and VGA workstations.  What makes BLANKER different - is
  10. that it is mouse, network and Windows aware and compatible.
  11.  
  12. ******************************************************************************
  13.  
  14. This program is not FREE, it is Shareware.  You are granted a trial license
  15. of 15 days to try BLANKER.  If it meets your needs and you decided to use it,
  16. please register it at the address below, under the terms at the end of this
  17. documentation.  (There's nothing worse than four pages of bull and licensing
  18. info at the beginning of a Shareware document!)
  19.  
  20. ******************************************************************************
  21.  
  22. BLANKER provides adjustable time-out and ON/OFF features from the command-
  23. line by running the program multiple times.  Only ONE command may be used
  24. on any single command-line.
  25.  
  26. Syntax is:
  27.  
  28. BLANKER [time_out]      - Sets BLANKER's time-out and installs BLANKER
  29.                           The default time-out value is 600 seconds (10 min)
  30.                           May be re-run to adjust the time-out value
  31.                           Does NOT enable BLANKER if currently disabled
  32. BLANKER OFF             - Disables BLANKER
  33. BLANKER ON              - Enables BLANKER with current time-out setting
  34.  
  35. BLANKER does not halt video, mouse or keyboard I/O, and therefore provides
  36. normal background operation, allowing TSR and network POP-UP screens to
  37. perform transparently.  Furthermore, BLANKER detects when Windows is
  38. loaded and running, and disables itself until Windows is terminated.  When
  39. running DOS applications either full-screen or on the desktop in a window,
  40. BLANKER remains disabled, allowing Windows' own screen-saver to do the job.
  41.  
  42. BLANKER detects mouse, keyboard and video I/O activity and restores the
  43. screen (in a very similar fashion to Windows' built-in screen-saver)
  44. whenever any of these I/O devices become active through the ROM BIOS
  45. services.  This allows text based applications to have a solid but simple
  46. screen saver, while still serving TSRs and network based POP-UP messagers.
  47.  
  48.  
  49. Why Another Screen Saver?
  50.  
  51. BLANKER was primarily developed for the Lantastic Network Operating System
  52. in workstation installations using XTgold as a Menu and File Manager.  It
  53. should also work in Novell, PC-NFS, PC/TCP and other NetBIOS compatible
  54. networks, although it has not been tested with any of these.
  55.  
  56. After searching through some 87 different screen savers on CompuServe,
  57. the author was unable to locate a single blanking program which offered
  58. all these simple but necessary features.
  59.  
  60. Criteria were:
  61.  
  62. - Had to allow TSRs and POP-UP messengers to take control of the video
  63.   and keyboard I/O without interaction, otherwise the network would
  64.   freeze (lock-up) the workstation.
  65.  
  66. - Had to be Windows aware, automatically disabling and re-enabling itself
  67.   when Windows was loaded and terminated.  Did not want it to attempt to
  68.   blank when running DOS applications in a full-screen window.
  69.  
  70. - Had to allow normal operation of Windows based screen savers, including
  71.   but not limited to the one included with Windows 3.1.
  72.  
  73. - Had to have a low cost and realistic Shareware licensing policy - after
  74.   all, it's just a blanker!
  75.  
  76. - Should be a TEXT mode blanker, although this wasn't mandatory, as many
  77.   graphics mode blankers interfere with other graphics program settings
  78.   and often corrupt the color palette.
  79.  
  80.  
  81. Limitations:  (You just knew there had to be some!)
  82.  
  83. Applications which update time on the screen may force BLANKER not to
  84. time-out, since the time display may write to the screen through the ROM
  85. BIOS services (INT 10 hex).  Some programs feature a configuration option
  86. to write directly to the screen - or to disable the time display, either
  87. of which would eliminate this.  For some strange reason, XTgold apparently
  88. writes time directly to the screen when displaying both it's menu and file
  89. screens.  Other menu systems may not be as compatible.  No provision has
  90. been made to disable the video I/O trap, since POP-UP messages almost
  91. always write to the screen through the BIOS, and these very programs were
  92. the primary reason why BLANKER was developed in the first place.
  93.  
  94. Currently, BLANKER has only been tested on VGA & EGA display adapters using
  95. DOS 5.0, the Microsoft Mouse driver, Lantastic 4.1, XTgold, Windows 3.1,
  96. Word Perfect, Quick-Basic (which in a way is an acid test all by itself),
  97. Quicken3, QEMM386, Procomm+ and a few other sundries, all without effect.
  98. While it works in 40 column and 43/51 line modes, it does not adjust the
  99. blinking dot's vertical position, causing it to be invisible in 40 column
  100. mode, and only part way down the screen in the other two modes.  The
  101. character type and position are fixed.
  102.  
  103. BLANKER will not blank 132 column or other non-standard modes provided
  104. by extended or VESA VGA specifications.  It is primarily intended to blank
  105. LOGIN prompt and menu screens in turn-key network installations.
  106.  
  107. BLANKER may be loaded into high RAM, but if so you MUST also attempt to
  108. load it high in order to adjust any of its settings when running it again.
  109. If you need to remove BLANKER, you should use the popular TSR utilities
  110. MARK and RELEASE, which are available on CompuServe and many BBSs.
  111.  
  112.  
  113. How BLANKER Works (if you need to know):
  114.  
  115. BLANKER traps INT 08, INT 09 and INT 10.  INT 08 provides the basic timing
  116. services (DOS's real-time clock at 18.2 ticks per second).  INT 09 provides
  117. keyboard activity trapping, and INT 10 supplies the video activity trap.
  118.  
  119. When enabled, BLANKER checks to see if the time-out value is exceeded and
  120. if so, then checks to see if Windows is loaded.  It also checks the current
  121. video mode - which must be TEXT.  If all conditions are met, it changes
  122. the current video page, clears the screen, places a single box character
  123. on line 25, column 1 and then resumes normal PC operation.
  124.  
  125. Every 6 timer ticks, BLANKER toggles the box character OFF and then ON.
  126. Each timer tick, it checks to see if the mouse status has changed using
  127. the INT 33 mouse driver call.  The box character is the extended ASCII
  128. code 254 (decimal), which produces a small, solid-filled box "■".  This
  129. character is large enough to see from across a room, and flashed to
  130. avoid monitor burn-in.
  131.  
  132. If any of the three activities - mouse movement (or button click), keyboard
  133. input or video output occur,  BLANKER restores the original video page.
  134.  
  135. You may invoke BLANKER without any message by re-directing the output to
  136. the DOS "nul" device, however you will tie-up a file handle by doing so.
  137.  
  138.  
  139. The Details:
  140.  
  141. BLANKER consumes about 7 Kbytes of RAM, and was compiled in Microsoft
  142. Quick-Basic 4.5 using Crescent Software's PDQ Integer Library Version 2.17
  143. which provides both TSR and super-small sized executable support.
  144.  
  145. DOS, Lantastic, Windows, Novell, PC-NFS, PC/TCP, Word Perfect, QEMM386,
  146. Quicken3, Procomm+, Quick-Basic and PDQ are all Registered Trademarks
  147. of their respective manufacturers.
  148.  
  149. No Copyright is claimed by the author for the use of the BLANKER name and
  150. such name represents only the function provided by the product, and not the
  151. product itself.  The product is referred to as BLANKER because that is its
  152. purpose.
  153.  
  154. The author makes no claims for fittedness of the product and accepts
  155. no liability for any damages consequential or otherwise by using it.
  156. No warranty is expressed or implied.  You may have other warranties
  157. which vary from state to state.
  158.  
  159.  
  160. ******************************************************************************
  161.  
  162. The License:
  163.  
  164. BLANKER is not FREE, it is Shareware.  You are granted a trial license
  165. of 15 days to try BLANKER.  If it meets your needs and you decided to use it,
  166. please register it at the address below.  You have only your conscience to
  167. guide you, and frankly, there doesn't seem too much of that going around
  168. these days.
  169.  
  170. The Shareware concept provides a means of trying software before you buy
  171. it - and that's a great idea which the author agrees with.  But it's simply
  172. a marketing tool, allowing you to obtain the software through CompuServe
  173. and BBSs instead of a retail outlet.  It's not intended to be a channel
  174. to obtain programs at no cost.  If you use the product, you should pay
  175. for it.  No matter whose work it is.  If it was yours, you'd certainly
  176. feel the this way also.
  177.  
  178. BLANKER may not be modified or reverse-engineered.  You may distribute
  179. BLANKER freely, charging a maximum of $8.00 U.S. for diskette duplication
  180. only, providing you include this documentation in unmodified form.
  181.  
  182. The registration fees are (all U.S.):
  183.  
  184. Single User                     - $  15.00
  185. Up to 5 Users on a Server       - $  25.00 minimum
  186. Each Additional User            - $   5.00
  187. Maximum per Server              - $ 500.00
  188.  
  189. Direct sales only.  Maryland residents please add 5% state sales tax.
  190.  
  191. Send check, money-order or correspondence to:
  192.  
  193. David B. Donaldson
  194. 258 Nathan Way
  195. Millersville, Maryland  21108
  196. CompuServe ID: 76310,173
  197.  
  198. Suggestions and bug reports are welcomed.  If you have a specific need or
  199. problem, the program can be customized.  Since BLANKER is recently designed
  200. it is anticipated that some applications will not cooperate with the screen
  201. blanking mechanism used.  If you experience problems with a specific
  202. application but would appreciate using BLANKER, please contact the author
  203. for assistance in updating BLANKER to remedy the problem.  Users desiring
  204. assistance must be registered.
  205.  
  206. ******************************************************************************
  207.  
  208.  
  209.