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