home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: WPS_PM / WPS_PM.zip / SCRNBLNK.ZIP / SCRNBLNK.TXT < prev   
Text File  |  1991-01-29  |  8KB  |  166 lines
  1.                               
  2.                               
  3.                     Screen Blanker V1.2
  4.               A Screen Saver Program for OS/2
  5.                               
  6. Purpose:       A screen saver is a program which blanks the
  7.                screen after a specified period of
  8.                inactivity, in order to prevent patterns from
  9.                being "burned-in" to the screen.
  10.  
  11. Installation:
  12.                SCRNBLNK.EXE is a utility in C:\OS2 directory.
  13.                
  14.                Create STARTUP.CMD file to activate Screen 
  15.            Blanker each time you reboot your system.
  16.            The command to do this is:
  17.                     SCRNBLNK /INSTALL
  18.                You may also wish to add an entry for Screen
  19.                Blanker to a Desktop Manager program group so
  20.                you can easily start it at other times.
  21.                
  22.                If you want Screen Blanker to be effective in
  23.                OS/2 DOS sessions, you must also install a
  24.                device driver.  SCRNBLNK.SYS is in C:\ directory.
  25.                a suitable directory (such as OS2\SYSTEM).
  26.                Then modify your CONFIG.SYS file to install
  27.                this driver at startup.  You must add a line
  28.                of the form:
  29.                     DEVICE=C:\SCRNBLNK.SYS
  30.                (or wherever you installed the file).  This
  31.                line should go before the DEVICE=... lines
  32.                which install the mouse drivers; otherwise
  33.                Screen Blanker will be unable to detect mouse
  34.                activity within the DOS box.
  35.                
  36. Usage:         Screen Blanker is normally activated from
  37.                your STARTUP.CMD file whenever the system is
  38.                booted, as described under Installation
  39.                above.
  40.                
  41.                Once Screen Blanker has been activated, it
  42.                will monitor keyboard and mouse activity in
  43.                all OS/2 sessions.  If the specified period
  44.                elapses without either being used, the screen
  45.                will be blanked. Optionally, a display of the
  46.                current date and time will be shown in random
  47.                positions on the screen.
  48.                
  49.                The screen can be restored to its previous
  50.                state by pressing any key or moving the
  51.                mouse.
  52.                
  53.                Screen Blanker may also be started at other
  54.                times in any of the usual OS/2 ways -- by
  55.                selecting it from the File System, by an
  56.                entry in a Start Programs menu, or by
  57.                entering the command SCRNBLNK from a command-
  58.                line window.
  59.                
  60.                When Screen Blanker is started it normally
  61.                displays a dialog box that allows you to set
  62.                some options.  The command line parameter
  63.                /INSTALL used at startup suppresses this
  64.                dialog box and uses default or previously set
  65.                values.
  66.  
  67.                                                       Page 3
  68.  
  69.                
  70.                If Screen Blanker is already active when it
  71.                is started, the new copy communicates with
  72.                the previous copy to change the options in
  73.                effect. The Remove button in the dialog box
  74.                can be used to terminate a previously-
  75.                activated screen blanker.  The /NOCLOSE
  76.                option may be specified when Screen Blanker
  77.                is started to prevent it being removed.
  78.                
  79.                If the Screen Blanker device driver has been
  80.                installed, Screen Blanker will also blank the
  81.                screen while the DOS Compatibility mode
  82.                session is in control of the screen.
  83.                Alternatively, a separate DOS screen blanker
  84.                may be used in the DOS compatibility session.
  85.                
  86. Command Line Options:
  87.                The following options may be specified on the
  88.                command line when Screen Blanker is run:
  89.                
  90.                /INSTALL  This is normally used when Screen
  91.                Blanker is run from a STARTUP.CMD file.  It
  92.                bypasses the dialog box popup, and installs
  93.                the program with whatever options have been
  94.                previous set up.
  95.                
  96.                /NOCLOSE  This option prevents the Screen
  97.                Blanker from being removed from memory, and
  98.                also prevents changing most of its options.
  99.                If Screen Blanker is run from a STARTUP.CMD
  100.                file with this option, the only way to remove
  101.                it is to remove the command from STARTUP.CMD
  102.                and reboot the system.
  103.                
  104. Dialog Box Options:
  105.                The Screen Blanker dialog box allows setting
  106.                various options.
  107.  
  108.                The "PM Session", "DOS Session",  and "Non-PM
  109.                Sessions" checkboxes allow you to control
  110.                when Screen Blanker is active.  By default it
  111.                is active in all sessions.  If you remove the
  112.                check from "PM Sessions", blanking will not
  113.                be active in the PM session.  Blanking for
  114.                the DOS session will only be possible if the
  115.                Screen Blanker device driver has been
  116.                installed.
  117.  
  118.  
  119.                                                       Page 4
  120.  
  121.                The time interval at which blanking should
  122.                occur may be entered in the indicated place.
  123.                The default is five minutes.
  124.  
  125.                The "Show clock" check box can be used to
  126.                control whether the time and date are
  127.                displayed during "blanked" periods.  If "Show
  128.                clock" is selected, then the "Colors"
  129.                pushbutton can be used to adjust the colors
  130.                used in the time/date display.  When this
  131.                pushbutton is selected a second dialog box
  132.                pops up containing scroll bars that are used
  133.                to select the colors.
  134.  
  135.                If the "Save settings" check box is selected,
  136.                then your preferences for the other options
  137.                will be saved in the system OS2.INI file, and
  138.                will be applied automatically whenever the
  139.                Screen Blanker is subsequently started.
  140.                
  141. Caveats:   (1) Screen Blanker uses the OS/2 VioPopUp service
  142.                to blank the screen.  OS/2 limits use of this
  143.                function to one program (session) at a time.
  144.                This means that if a running program has
  145.                taken over the screen by "popping up", Screen
  146.                Blanker will be unable to blank the screen.
  147.                It also means that a running program that
  148.                wants to use the "popup" while the screen is
  149.                blanked will be unable to do so.  Most
  150.                programs that use this function appear to
  151.                wait for the screen to be available, so in
  152.                practice this doesn't seem to be a serious
  153.                problem.
  154.  
  155.           (2)  Some levels of OS/2 version 1.2 contain a bug
  156.                in VioPopUp which results in a "Protection
  157.                Violation" (Message SYS1943) if the program
  158.                is removed (by selecting the Remove option).
  159.                This occurs only if it has blanked the screen
  160.                one or more times before being removed.  This
  161.                error arises a few seconds after the program
  162.                has terminated and appears to be beyond my
  163.                control.  It is apparently harmless, and has
  164.                been corrected in recent levels of OS/2 1.2.
  165.  
  166.