home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / os2 / scrutl19.zip / README.OS2 < prev    next >
Text File  |  1992-07-08  |  5KB  |  134 lines
  1. This is the documentation for SCRUTIL.EXE and SCRBLANK.DLL, an
  2. OS/2 Presentation Manager screen saver for OS/2 1.3 and 2.0.
  3.  
  4. Kai Uwe Rommel,
  5.  
  6. Zennerstrasse 1
  7. D-8000 Muenchen 70
  8. Germany
  9.  
  10. Phone: +49 89 723 4101
  11. Fax:   +49 89 723 7889
  12.  
  13. email: rommel@jonas.bofe.sub.org (preferred)
  14.    or: rommel@informatik.tu-muenchen.de
  15.  
  16. May 26 1992
  17.  
  18. ---------------------
  19.  
  20. 0. Overview
  21.  
  22. This small program is a screen saver for OS/2 Presentation Manager
  23. and in addition shows a small window with the current date and
  24. time and amount of free memory.
  25.  
  26.  
  27. 1. Installation
  28.  
  29. Put SCRUTIL.EXE somewhere in your PATH or where you keep your
  30. utility programs and SCRBLANK.DLL somewhere in your LIBPATH.
  31. SCRBLANK.DLL needs IOPL because it uses hardware features of the
  32. video cards to blank the screen(s). Set either IOPL=YES in CONFIG.SYS
  33. or add SCRBLANK to your IOPL list.
  34.  
  35.  
  36. 2. Start
  37.  
  38. You can start the program by entering the command "START SCRUTIL"
  39. but you better put it in a program group (1.3) or folder (2.0).
  40. You can mark it as "Open when system is started" (1.3) or put a
  41. shadow of it in the startup folder (2.0).
  42.  
  43.  
  44. 3. Usage
  45.  
  46. Initially, the program puts it's window in the upper right screen
  47. corner, but you can move it wherever you want it. Under 1.3, you
  48. can then choose "Save" from the desktop manager's "Desktop" menu
  49. to let it save it's screen position. Under 2.0, the position is
  50. saved, when the screen saver is terminated or the system is shut
  51. down.
  52.  
  53. The window shows the current time and date in the format defined
  54. in the PM control panel (1.3) or country settings box in the
  55. system setup folder (2.0) in the first line.
  56.  
  57. In the second line, the current amount of free memory is shown in
  58. kilobytes. Under 2.0, this value always shows the combined size of 
  59. all currently unused memory pages.
  60.  
  61. Under 1.3 it usually shows the largest contiguous segment of
  62. memory currently available. This does not always represent the
  63. total amount of free memory, especially not after some time of
  64. system usage when memory became fragmented (which is not a bad
  65. thing at all, because the system compacts memory as needed, but
  66. only when it is needed, not for the free memory display by this
  67. program). However, there exists an option to let it more precisely
  68. display available memory, called "bean count" (see below). But use
  69. this option with care because it can seriously degrade system
  70. performance and should only be used when really needed (for
  71. example, when you want to debug a program and you don't trust it's
  72. memory usage).
  73.  
  74. After some period of user inactivity (no keyboard or mouse input)
  75. the screen is blanked. You can blank the screen immediately by
  76. moving the mouse pointer into the upper right screen corner and
  77. you can prevent the screen from being blanked by moving the mouse
  78. pointer into the lower right screen corner.
  79.  
  80. You can bring up the screen saver's configuration box by double
  81. clicking on the window.
  82.  
  83.  
  84. 4. Configuration
  85.  
  86. The configuration box is different under 1.3 and 2.0. Under both
  87. systems, it shows a title and copyright and version number and
  88. three buttons, "Ok", "Cancel", and "Terminate". You of course know
  89. what the purpose of these buttons is.
  90.  
  91. Under 2.0, a group of controls are showed to adjust the screen
  92. saver. You can specify the saver delay time, if it should blank
  93. your screen at all and which display cards are in your computer.
  94. If you disable the screen saver, it will not blank the screen(s) 
  95. after the specified period of inactivity, but you can still blank 
  96. it manually by moving the mouse pointer into the upper right 
  97. screen corner.
  98.  
  99. The possible cards are 8514/A, VGA, EGA and Monochrome. This screen
  100. saver does not use any Presentation Manager functions to perform
  101. the screen blanking but rather uses hardware capabilities of the
  102. display cards to blank the screen. This has the advantage that no
  103. screen redraw has to be done when the screen is switched back on.
  104. In addition, it cannot interfere with running programs (as long as
  105. they do not change the current screen palette).
  106.  
  107. But for the screen saver to function properly, you must correctly
  108. set what kind of display adaptor(s) you have. You can check more
  109. than one adaptor, if you have a secondary screen attached to your
  110. computer, for debugging programs, for example. In such cases, the
  111. screen saver can blank the debug screen too. Possible combinations
  112. are VGA and Monochrome, 8514/A and VGA or even 8514/A, VGA and
  113. Monochrome all together.
  114.  
  115. If you should have problems that your VGA does not get blanked
  116. properly although you have chosen VGA in the configuration box,
  117. you can try to choose EGA instead, which should work with all VGA
  118. cards too.
  119.  
  120. Under 1.3 the configuration box shows another group of controls
  121. to let you adjust the free memory display. You can choose bean
  122. count if you need to (see warning above) and if you enable the
  123. bean count, you can adjust the minimum size of the segments which
  124. should be counted for the total free memory and the interval at
  125. which the total free memory amount should be recalculated.
  126.  
  127.  
  128. 5. Future enhancements
  129.  
  130. Perhaps newer display cards can be supported as they become
  131. available and if I get access to one. For example, I would like
  132. to hear from XGA users, if the screen saver works with it and
  133. with which setting (8514/A or VGA).
  134.