home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / utils / scrnsave / scrnblnk / scrnblnk.txt < prev   
Encoding:
Text File  |  1991-04-14  |  11.7 KB  |  251 lines
  1.                               
  2.                               
  3.                     Screen Blanker V1.3
  4.               A Screen Saver Program for OS/2
  5.                               
  6.                                         Alan Ballard
  7.                                         April 14, 1991
  8.  
  9. Notice:        Screen Blanker is (c) copyright 1991 Alan
  10.                Ballard. It may not be sold, traded, or
  11.                otherwise disposed of for profit without
  12.                permission from the author.
  13.  
  14. Disclaimer:         This program is offered on an "as-is"
  15.                basis without any guarantee as to correct
  16.                functioning or fitness for any specific
  17.                purpose. The author believes this program to
  18.                work as described, but you use the program
  19.                entirely at your own risk.  It is your
  20.                responsibility to evaluate the suitability of
  21.                the program for your requirements.  In using
  22.                the program, you agree that you will not
  23.                attempt to hold the author responsible for
  24.                any hardware or software damage, loss of
  25.                data, or incidental or consequential damage
  26.                that may result from use of the program,
  27.                whether or not such use is in accordance with
  28.                the instructions.
  29.  
  30. Purpose:       A screen saver is a program which blanks the
  31.                screen after a specified period of
  32.                inactivity, in order to prevent patterns from
  33.                being "burned-in" to the screen.
  34.  
  35. Hardware and software required:
  36.                Screen Blanker Version 1.3 requires OS/2
  37.                Version 1.2 or 1.3.  It should work with
  38.                either Standard Edition or Extended Edition
  39.                and with any computer and monitor that are
  40.                supported by OS/2. The current version has
  41.                only been tested with OS/2 1.2 SE syslevel
  42.                XR04073 and 1.3 SE syslevel XR00000.
  43.                
  44. Installation:
  45.                Copy the file SCRNBLNK.EXE to a directory
  46.                that is part of your normal OS/2 search path.
  47.                \OS2 or \OS2\PBIN are good candidates.
  48.                
  49.                Copy the file SCRNBLNK.DLL to any directory
  50.                that is specified in your OS/2 LIBPATH.
  51.                \OS2\DLL is normally used for DLL's, but any
  52.                other directory in the LIBPATH is OK.
  53.                
  54.                Note if you are installing this version to
  55.                replace a previous version of Screen Blanker,
  56.                it is important to also replace the DLL file.
  57.                                                       Page 2
  58.  
  59.                To do so, it may be necessary to first remove
  60.                Screen Blanker from your startup and reboot.
  61.                
  62.                Then, modify your STARTUP.CMD file to
  63.                activate Screen Blanker each time you reboot
  64.                your system.  The command to do this is:
  65.                     SCRNBLNK /INSTALL
  66.                You may also wish to add an entry for Screen
  67.                Blanker to a Desktop Manager program group so
  68.                you can easily start it at other times.
  69.                
  70.                If you want Screen Blanker to be effective in
  71.                OS/2 DOS sessions, you must also install a
  72.                device driver.  Copy the file SCRNBLNK.SYS to
  73.                a suitable directory (such as OS2\SYSTEM).
  74.                Then modify your CONFIG.SYS file to install
  75.                this driver at startup.  You must add a line
  76.                of the form:
  77.                     DEVICE=C:\OS2\SYSTEM\SCRNBLNK.SYS
  78.                (or wherever you installed the file).  This
  79.                line should go before the DEVICE=... lines
  80.                which install the mouse drivers; otherwise
  81.                Screen Blanker will be unable to detect mouse
  82.                activity within the DOS box.
  83.                
  84. Usage:         Screen Blanker is normally activated from
  85.                your STARTUP.CMD file whenever the system is
  86.                booted, as described under Installation
  87.                above.
  88.                
  89.                Once Screen Blanker has been activated, it
  90.                will monitor keyboard and mouse activity in
  91.                all OS/2 sessions.  If the specified period
  92.                elapses without either being used, the screen
  93.                will be blanked. Optionally, a display of the
  94.                current date and time will be shown in random
  95.                positions on the screen.
  96.                
  97.                The screen can be restored to its previous
  98.                state by pressing any key or moving the
  99.                mouse.
  100.                
  101.                Screen Blanker may also be started at other
  102.                times in any of the usual OS/2 ways -- by
  103.                selecting it from the File System, by an
  104.                entry in a Start Programs menu, or by
  105.                entering the command SCRNBLNK from a command-
  106.                line window.
  107.                
  108.                When Screen Blanker is started it normally
  109.                displays a dialog box that allows you to set
  110.                some options.  The command line parameter
  111.                /INSTALL used at startup suppresses this
  112.                dialog box and uses default or previously set
  113.                values.
  114.  
  115.                                                       Page 3
  116.  
  117.                
  118.                If Screen Blanker is already active when it
  119.                is started, the new copy communicates with
  120.                the previous copy to change the options in
  121.                effect. The Remove button in the dialog box
  122.                can be used to terminate a previously-
  123.                activated screen blanker.  The /NOCLOSE
  124.                option may be specified when Screen Blanker
  125.                is started to prevent it being removed.
  126.                
  127.                If the Screen Blanker device driver has been
  128.                installed, Screen Blanker will also blank the
  129.                screen while the DOS Compatibility mode
  130.                session is in control of the screen.
  131.                Alternatively, a separate DOS screen blanker
  132.                may be used in the DOS compatibility session.
  133.                
  134. Command Line Options:
  135.                The following options may be specified on the
  136.                command line when Screen Blanker is run:
  137.                
  138.                /INSTALL  This is normally used when Screen
  139.                Blanker is run from a STARTUP.CMD file.  It
  140.                bypasses the dialog box popup, and installs
  141.                the program with whatever options have been
  142.                previous set up.
  143.                
  144.                /NOCLOSE  This option prevents the Screen
  145.                Blanker from being removed from memory, and
  146.                also prevents changing most of its options.
  147.                If Screen Blanker is run from a STARTUP.CMD
  148.                file with this option, the only way to remove
  149.                it is to remove the command from STARTUP.CMD
  150.                and reboot the system.
  151.                
  152.                /DEBUG    This option causes Screen Blanker
  153.                to maintain some internal debugging
  154.                information.  This option is only of interest
  155.                to the developer.
  156.                
  157. Dialog Box Options:
  158.                The Screen Blanker dialog box allows setting
  159.                various options.
  160.  
  161.                The "PM Session", "DOS Session",  and "Non-PM
  162.                Sessions" checkboxes allow you to control
  163.                when Screen Blanker is active.  By default it
  164.                is active in all sessions.  If you remove the
  165.                check from "PM Sessions", blanking will not
  166.                be active in the PM session.  Blanking for
  167.                the DOS session will only be possible if the
  168.                Screen Blanker device driver has been
  169.                installed.
  170.  
  171.  
  172.                                                       Page 4
  173.  
  174.                The time interval at which blanking should
  175.                occur may be entered in the indicated place.
  176.                The default is five minutes.
  177.  
  178.                The "Show clock" check box can be used to
  179.                control whether the time and date are
  180.                displayed during "blanked" periods.  If "Show
  181.                clock" is selected, then the "Colors"
  182.                pushbutton can be used to adjust the colors
  183.                used in the time/date display.  When this
  184.                pushbutton is selected a second dialog box
  185.                pops up containing scroll bars that are used
  186.                to select the colors.
  187.  
  188.                If the "Save settings" check box is selected,
  189.                then your preferences for the other options
  190.                will be saved in the system OS2.INI file, and
  191.                will be applied automatically whenever the
  192.                Screen Blanker is subsequently started.
  193.                
  194. Caveats:   (1) Screen Blanker uses the OS/2 VioPopUp service
  195.                to blank the screen.  OS/2 limits use of this
  196.                function to one program (session) at a time.
  197.                This means that if a running program has
  198.                taken over the screen by "popping up", Screen
  199.                Blanker will be unable to blank the screen.
  200.                It also means that a running program that
  201.                wants to use the "popup" while the screen is
  202.                blanked will be unable to do so.  Most
  203.                programs that use this function appear to
  204.                wait for the screen to be available, so in
  205.                practice this doesn't seem to be a serious
  206.                problem.
  207.  
  208.           (2)  Some levels of OS/2 version 1.2 contain a bug
  209.                in VioPopUp which results in a "Protection
  210.                Violation" (Message SYS1943) if the program
  211.                is removed (by selecting the Remove option).
  212.                This occurs only if it has blanked the screen
  213.                one or more times before being removed.  This
  214.                error arises a few seconds after the program
  215.                has terminated and appears to be beyond my
  216.                control.  It is apparently harmless, and has
  217.                been corrected in recent levels of OS/2 1.2.
  218.  
  219.           (3)  The DOS driver attempts to detect mouse and
  220.                keyboard activity in the DOS box.  However on
  221.                systems, it will be unable to detect mouse
  222.                activity, hence if you use the system without
  223.                any keyboard input, it might blank it even if
  224.                you had been using the mouse.  This will
  225.                happen on systems configured to use "level
  226.                triggered", rather than "edge triggered"
  227.                interrupts (generally AT-class machines). The
  228.                message "Screen Blanker driver can't set
  229.  
  230.                                                       Page 5
  231.  
  232.                mouse intercept" will appear during the boot
  233.                sequence.
  234.  
  235.           (4)  Blanking the DOS session is accomplished by
  236.                switching to PM first; hence it will have a
  237.                side effect of suspending any program that
  238.                was running in the DOS session. If you are
  239.                running a DOS program that will continue
  240.                without keyboard or mouse input for longer
  241.                than your blanking interval, you should
  242.                disable the screen blanker (or touch a key
  243.                occasionally).
  244.  
  245. Author:        Alan Ballard,
  246.                3452 West 11th Avenue,
  247.                Vancouver, Canada, V6R 2J9
  248.  
  249.                Compuserve: 70446,44
  250.                Internet:   ballard@ucs.ubc.ca
  251.