home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / CPROG / SS14.ZIP / README.TXT < prev    next >
Text File  |  1991-01-24  |  6KB  |  103 lines
  1.                                     SS
  2.                           A Screen Saver Utility
  3.                              For Windows 3.0
  4.  
  5.                        Version 1.4  January 24,1991
  6.                         Copyright 1991 Tom Wheeler
  7.                                 [72037,1742]
  8.  
  9.  
  10. The programs and documentation contained herein are hereby placed in the
  11. public domain.  You may use any portion of this material as you see fit
  12. for your own personal use provided no part of anything contained herein
  13. is used or distributed commercially.
  14.  
  15. This material may not be distributed unless all modules listed below
  16. are included in the final distributed version:
  17.  
  18.                   LIBENTRY ASM      2481 11-02-90   9:21p
  19.                   README   TXT      5615 01-24-91   8:33p
  20.                   SAVE     BMP      8310 11-01-90   9:59p
  21.                   SS       C       23307 01-24-91   2:23p
  22.                   SS       DEF       433 01-24-91  10:30a
  23.                   SS       DLG      1556 01-24-91   8:01p
  24.                   SS       EXE     21248 01-24-91   8:01p
  25.                   SS       H        1231 11-02-90   7:34p
  26.                   SS       ICO       766 10-13-90  11:33a
  27.                   SS       MAK      2250 01-24-91   7:51p
  28.                   SS       RC        926 11-02-90   6:17p
  29.                   SSHOOK   C        4828 11-02-90   9:16p
  30.                   SSHOOK   DEF       331 11-02-90   9:21p
  31.                   SSHOOK   DLL      2112 01-24-91   7:50p
  32.                   SSHOOK   MAK      2173 01-24-91   7:49p
  33.                   SSHOOK   RC        973 10-11-90   8:42p
  34.  
  35. No claim of suitability of use is made for these programs.  The user is
  36. solely responsible to determine whether or not these programs perform
  37. properly on any given computer system.
  38.  
  39. The use of this program is quite simple.  Execute the program "SS.EXE" by
  40. any means desired from within Windows 3.0.  Make sure that the dynamic link
  41. library "SSHOOK.DLL" is available in the directory the program is being
  42. executed from or that it is placed in a directory that can be located with
  43. the "PATH" environment variable.
  44.  
  45. The program initializes as an Icon and cannot be maximized.  Click on the
  46. Icon to select its system menu and choose the "Time" menu option to set the
  47. Activation Time of the Screen Saver.  The Activation Time is initialized to
  48. 10 minutes the first time the program is run.  Enter the desired Activation
  49. Time and click "Save" to permanently save this value or "Cancel" to abort.
  50. This value will be recorded in your "Win.Ini" Windows initialization file
  51. and will be used every time that "SS" is run until changed again.
  52.  
  53. "SS" detects keystrokes and mouse movements.  If "SS" detects that no keys
  54. have been pressed or that the mouse has not moved within the period of time
  55. defined by the Activation Time, the screen will blank and a graphic icon
  56. will be randomly moved around the screen until either a key is pressed, the
  57. mouse is moved, or a mouse button is clicked.  "SS" cannot detect keystrokes
  58. entered in a DOS application running under Windows so it is possible that
  59. the screen will be blanked if you are running a DOS application in a Window.
  60. Full screen DOS applications do not experience this problem.
  61.  
  62. This program was written as an experiment to try out various Windows
  63. functions, primarily the use of the SetWindowsHook function, bitmap
  64. manipulation, and the creation of a DLL (dynamic link library).  The make
  65. scripts were generated using the PWB (Programmers Work Bench) included with
  66. Microsoft C 6.0.  The program was compiled and linked with Microsoft C 6.0
  67. and Link 5.1.
  68.  
  69.      ========================= VERSION 1.4 =========================
  70.  
  71. As stated above, SS was primarially written as a programming exercise.  Due
  72. to the suprising number of downloads, however, I have decided to create this
  73. release to fix some problems noted by many of you.
  74.  
  75. Previous versions had problems capturing mouse input cleanly.  It seems that
  76. this is quite a trickey problem under Windows.  This version attempts to 
  77. correct subtle problems encountered previously.
  78.  
  79. Formerly, SS set an internal timer to determine when to sample mouse input.
  80. Upon expiration of the timer, it would start capturing mouse input for all
  81. of Windows to determine if the system was idle or not.  Mouse capture would
  82. not be released until either some mouse or keyboard activity was detected, or
  83. when the screen was actually blanked.  Although this was reliable for most 
  84. purposes, it could cause windows, menus, scroll bars, buttons, etc. to
  85. momentarially loose some messages.  This would result in strange behavior
  86. such as a menu or scrollbar "freezing", a double click to be missed, etc.
  87.  
  88. This version takes a totally different (and I hope safe) approach to looking
  89. at mouse activity.  The mouse timer now expires once a second.  When this
  90. happens SS looks to see which window is currently active.  The active window
  91. is then "sub-classed" (for non-programmers, this is a technique of capturing
  92. a windows messages).  At this point, all messages can be filtered and mouse
  93. movement and mouse buttons can be sampled while the mouse is active within
  94. that window (which is usually most of the time).
  95.  
  96. The only problem I am aware of with this release is its inability to detect
  97. keystrokes in a DOS application when running in 386 Enhanced Mode (if you
  98. are running in Real or Standard Modes it is meaningless to try to detect DOS
  99. keystrokes anyhow).  If anyone out there knows of a technique to do this, I
  100. would greatly appreciate hearing from you.
  101.  
  102.  
  103.